This guide covers server administration, console commands, permission management, save management, and troubleshooting for your Subnautica Nitrox server on Legion Hosting. For initial setup and player connection instructions, see Subnautica Nitrox Server Setup Guide.
1. Server Console
The Nitrox server provides a console accessible via the Console tab in GPanel. Type commands directly into the console input field while the server is running.
2. Admin Access
Admin access is controlled by the SUBNAUTICA_ADMIN_PASSWORD startup variable (or AdminPassword in server.cfg). Players can authenticate as admin in-game to execute privileged commands.
PleaseChangeMe. Change this immediately in the GPanel Startup tab to prevent unauthorized admin access.
3. Console Commands
| Command | Description |
|---|---|
help |
Lists all available server commands. |
say [message] |
Broadcasts a message to all connected players. |
list |
Shows all connected players. |
kick [name] |
Kicks a player from the server. |
ban [name] |
Bans a player from the server. |
unban [name] |
Removes a player's ban. |
save |
Forces an immediate world save. |
op [name] |
Grants a player admin/operator permissions. |
deop [name] |
Removes admin/operator permissions from a player. |
stop |
Gracefully shuts down the server. |
stop for clean shutdowns. Always prefer the stop command or the GPanel Stop button to ensure the world is saved before the server shuts down.
4. Permission Levels
Nitrox uses a permission hierarchy for player access control. The DefaultPlayerPerm setting in server.cfg determines what permissions new players receive.
| Level | Description |
|---|---|
NONE |
No permissions. Players cannot interact with the game world. |
PLAYER |
Standard player permissions. Can play the game normally. |
MODERATOR |
Can kick players and perform basic moderation. |
ADMIN |
Full admin permissions including ban, op, and server configuration. |
CONSOLE |
Highest level. Only available through the server console. |
5. Save Management
Auto-Save
Auto-save is controlled by two settings:
SAVE_INTERVAL-- Time between auto-saves in milliseconds. Default is120000(2 minutes).SAVE_DISABLE-- Set toTrueto disable auto-save entirely.
Manual Save
Use the save command in the GPanel console to trigger an immediate world save.
Save File Location
World saves are stored in the server directory with the name specified by SAVE_NAME (default: world).
Backups
- Stop the server (or use
savefirst). - Download the save directory and
server.cfgvia SFTP. - Store the backup in a safe location.
6. Default Player Stats
The following default player values can be adjusted in server.cfg:
| Setting | Default | Description |
|---|---|---|
DefaultOxygenValue |
45 |
Starting oxygen level for new players. |
DefaultMaxOxygenValue |
45 |
Maximum oxygen capacity for new players. |
DefaultHealthValue |
80 |
Starting health value for new players. |
DefaultHungerValue |
50.5 |
Starting hunger level for new players. |
DefaultThirstValue |
90.5 |
Starting thirst level for new players. |
DefaultInfectionValue |
0.1 |
Starting infection level (Kharaa). Set to 0 to start cured. |
7. Updating Nitrox
To update to a new Nitrox version:
- Set
NITROX_VERSIONtolatest(or a specific version) in the GPanel Startup tab. - Click Reinstall in GPanel to download and install the new version.
- Ensure all players update their client-side Nitrox to the matching version.
8. Troubleshooting
| Issue | Solution |
|---|---|
| Installation fails (Steam Guard) | Enter the Steam Guard code in STEAM_GUARDCODE and reinstall. Codes expire quickly -- act promptly. |
| Players cannot connect | Verify IP/port in GPanel, check Nitrox version match between client and server, and ensure the correct password is used. |
| Desync between players | This is a known Nitrox limitation. Try having all players disconnect and reconnect. Ensure all players are on the same Nitrox version. |
| Save corruption | Restore from a backup. If no backup exists, try starting with a fresh save by changing the SAVE_NAME value. |
| Server crashes after Subnautica update | A Subnautica game update may break Nitrox compatibility. Check the Nitrox GitHub for a compatible release. |
Related Articles
- Subnautica Nitrox Server Setup Guide
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
Need Help?
If you run into issues with your Subnautica Nitrox server, open a support ticket and include your server IP, a description of the problem, and any relevant error messages from the GPanel console.
