How to Configure Your Necesse Dedicated Server
Complete server.cfg reference for Necesse — server name, password, max players, world settings, difficulty, death penalty, raids, admin setup, and console commands.
Necesse uses a server.cfg file with a simple key=value format. This guide covers every setting, world creation options, admin setup, and all console commands.
Server File Structure
How to Edit server.cfg
Stop your server
Go to Console in the XGamingServer Panel and stop your server. Necesse overwrites server.cfg on shutdown, so always edit while stopped.
Open the file
Click Files in the sidebar and open server.cfg in the root directory.
Edit and save
Change the values you need, click Save Content, then start your server from Console.
server.cfg Reference
| Setting | Default | Description |
|---|---|---|
serverName | "Necesse Server" | Name displayed in the server browser |
serverPassword | "" | Password required to join. Leave empty for a public server |
maxClients | 10 | Maximum simultaneous players |
pauseWhenEmpty | true | Pause the world simulation when no players are online. Set to false if you want crops/settlers to progress while empty |
giveClientsPower | true | When true, all players get admin-like permissions (can use settings GUI). Set to false for public servers and use admins.txt instead |
giveClientsPower=trueis fine for friend groups but dangerous on public servers — it lets any player change world settings. Disable it and useadmins.txtfor proper access control.
These settings are configured when the world is first created. Changing them in server.cfg after world creation has no effect — you'd need to delete the world and regenerate.
Difficulty
| Level | Description |
|---|---|
| Casual | Low enemy damage, generous loot |
| Adventure | Balanced for new players |
| Classic | Standard difficulty (recommended) |
| Hard | Tougher enemies, more damage |
| Brutal | Maximum challenge — not for the faint-hearted |
Death Penalty
| Option | What Happens |
|---|---|
| Keep Inventory | No penalty. Items stay in your inventory |
| Drop Inventory | All items drop at your death location. Must retrieve them |
| Hardcore | Permanent death — character is deleted |
Raid Frequency
Controls how often hostile raids attack your settlements:
None — Low — Normal — High — Very High
Higher raid frequency means more combat but also more loot from defeated raiders.
| Setting | Default | Description |
|---|---|---|
worldSeed | "" | World generation seed. Empty = random. Only applies at world creation |
port | 14159 | UDP port for game traffic. Can also be set via Startup in the panel |
Admin Setup
Necesse uses admins.txt to grant admin permissions. This is separate from giveClientsPower and gives specific players elevated commands.
Find the player's Steam ID
You need their SteamID64 (a 17-digit number like 76561198012345678). Look it up at steamid.io using their profile URL.
Edit admins.txt
In Files, open admins.txt in the root directory. Add one SteamID64 per line:
76561198012345678
76561198087654321Set giveClientsPower to false
In server.cfg, set:
giveClientsPower=falseThis ensures only players listed in admins.txt have admin access, not everyone.
Restart
Restart from Console to apply.
Console Commands
Run these in Console in the panel:
| Command | Description |
|---|---|
/kick <player> | Kick a player from the server |
/ban <player> | Ban a player permanently |
/unban <player> | Remove a ban |
/permissions <player> <level> | Set a player's permission level |
/list | Show all connected players |
| Command | Description |
|---|---|
/give <player> <itemID> [amount] | Give items to a player |
/tp <player> <x> <y> | Teleport a player to coordinates |
/time set <value> | Set the world time |
/world save | Force an immediate world save |
| Command | Description |
|---|---|
/stop | Graceful server shutdown (saves world first) |
/say <message> | Broadcast a message to all players |
/help | List all available commands |
Ports
| Port | Protocol | Purpose |
|---|---|---|
| 14159 | UDP | Game traffic |
This port is configured via Startup in the panel or with the -port startup flag.
Related Guides
How is this guide?
