Neverwinter Nights: EE Server Configuration
Complete reference for settings.tml (TOML format), all command-line arguments, and how CLI flags override config file values.
Configuration File: settings.tml
NWN:EE uses settings.tml, a TOML-format file that replaces the legacy nwnplayer.ini. Edit this file while the server is stopped — it is read at startup and not reloaded while the server is running.
File location:
| Platform | Path |
|---|---|
| Windows | %USERPROFILE%\Documents\Neverwinter Nights\settings.tml |
| Linux | ~/.local/share/Neverwinter Nights/settings.tml |
Command-Line Arguments
All server options can be set via command-line arguments passed to nwserver. CLI arguments take precedence over settings.tml values.
| Argument | Default | Description |
|---|---|---|
-module "Name" |
Required | Module filename without .mod extension |
-servername "Name" |
— | Server browser display name |
-maxclients N |
244 | Maximum simultaneous player count |
-port N |
5121 | Connection port |
-pvp 0/1/2 |
— | 0=None, 1=Party only, 2=Full PvP |
-difficulty 1-4 |
— | 1=Easy, 2=Normal, 3=Hard, 4=Impossible |
-playerpassword "pw" |
blank | Password required to join |
-dmpassword "pw" |
— | Password for DM client login |
-adminpassword "pw" |
— | Server console admin password |
-publicserver 0/1 |
— | 1=listed on master server, 0=LAN/direct only |
-servervault 0/1 |
0 | 1=characters stored server-side |
-elc 0/1 |
0 | Enforce legal characters |
-ilr 0/1 |
0 | Item level restrictions |
-gametype N |
— | Server category for browser (see game settings article) |
-oneparty 0/1 |
— | Force all players into one party |
-pauseandplay 0/1 |
0 | Allow pause in multiplayer |
-minlevel N |
1 | Minimum character level to join |
-maxlevel N |
40 | Maximum character level to join |
-autosaveinterval N |
0 | Autosave every N minutes (0=disabled) |
-reloadwhenempty 0/1 |
— | Reload the module when the server is empty |
-nwsyncurl URL |
blank | NWSync content distribution URL |
-userdirectory "path" |
game dir | Override the user data directory |
Example Startup Command
nwserver.exe \
-module "The Bastard of Kosigan" \
-servername "My PW Server" \
-maxclients 40 \
-port 5121 \
-publicserver 1 \
-pvp 0 \
-difficulty 2 \
-adminpassword "s3cr3t" \
-servervault 1 \
-autosaveinterval 15
CLI vs. settings.tml Priority
Command-line arguments always override the corresponding settings.tml value. Use settings.tml for stable baseline settings and CLI arguments for values that change between instances (port, module name, passwords).
Environment Variable Overrides
Settings can also be set via environment variables using the pattern:
NWN_CONFIG_SET_key=value
For example, to set the server name:
export NWN_CONFIG_SET_servername="My Server"
Environment variables are evaluated after settings.tml but before CLI arguments in the precedence chain.