Necesse Updated May 11, 2026

Necesse server.cfg Reference

Complete reference for Necesse's server.cfg, including every setting, its default value, and notes on how launch arguments interact with the config file.

NecesseConfigurationserver.cfgSettings

Config File Location

Platform	Path
Windows	`C:\Users\[Username]\AppData\Roaming\Necesse\cfg\server.cfg`
Linux	`~/.config/Necesse/cfg/server.cfg`

The file is created automatically on first server startup.

Important: Config Is Overwritten on Each Start

server.cfg is overwritten every time the server starts, based on the launch arguments passed at startup. Editing the file manually will have no effect if the server is then restarted with conflicting arguments.

For persistent configuration, use launch arguments rather than editing the file directly. The config file is most useful as a reference to verify what values were applied on the last start.

Full Default Configuration

SERVER = {
  port = 14159,
  slots = 10,
  password = "",
  maxClientLatencySeconds = 30,
  pauseWhenEmpty = true,
  giveClientsPower = true,
  logging = true,
  language = en,
  zipSaves = true,
  MOTD = ""
}

Setting Reference

Key	Default	Description
`port`	`14159`	UDP port the server listens on.
`slots`	`10`	Maximum concurrent players. Accepts 1–250.
`password`	`""`	Server password. Leave empty for no password.
`maxClientLatencySeconds`	`30`	Kicks clients whose latency exceeds this value in seconds. Raise for players on poor connections.
`pauseWhenEmpty`	`true`	Pauses the world simulation when no players are online.
`giveClientsPower`	`true`	Grants connecting clients authority over their own entities. Disable on competitive or PvP servers.
`logging`	`true`	Writes server activity to the logs directory.
`language`	`en`	Server language code. Affects in-game text for server-side messages.
`zipSaves`	`true`	Compresses world saves as `.zip` files. Disabling this uses more disk space.
`MOTD`	`""`	Message of the day shown to players on connect.

Equivalent Launch Arguments

Every setting above has a corresponding launch argument:

./StartServer-nogui.sh \
  -world MySave \
  -port 14159 \
  -slots 10 \
  -password "secret" \
  -pausewhenempty 1 \
  -logging 1 \
  -zipsaves 1 \
  -language en \
  -motd "Welcome to the server!"

Back to Knowledgebase

Need help? Submit a Ticket →