Unturned server problems
Common Unturned server problems. See Unturned settings.
Server does not show in the Internet server list
Section titled “Server does not show in the Internet server list”Why it happens: Unturned’s docs say servers without a Game Server Login Token (GSLT) are hidden from the Internet server list. New servers can also take a few minutes.
How to fix it:
- Get a token at Steam game server accounts with Unturned’s app ID (304930).
- Put it in GSLT (
GSLT) on Startup. - Restart and wait a few minutes.
- Search by name, or use direct connect with the address and port from Network. See Network and ports.
Invalid or rejected GSLT
Section titled “Invalid or rejected GSLT”Why it happens: A token is created for one game (Unturned’s app ID is 304930). It may also have been revoked, or be in use on another server.
How to fix it:
- Generate a new token for the correct game.
- Paste it without spaces.
- Do not use the same token on two servers at once.
Players cannot connect
Section titled “Players cannot connect”Why it happens: Wrong address and port, password, or a version mismatch.
How to fix it:
- Check the status is Online.
- Copy the address and port from Network.
- Check Server Password (
SRV_PW). - See Can’t connect to any game server.
Version mismatch
Section titled “Version mismatch”Why it happens: The game updated and the server did not.
How to fix it: Keep Auto update (AUTO_UPDATE) at 1 and restart. Ask players to update the game. If they play a beta branch, the server must match.
Workshop items and maps do not load
Section titled “Workshop items and maps do not load”Why it happens: Unturned servers download Workshop items listed in WorkshopDownloadConfig.json. There is no Startup variable for it.
How to fix it:
- Find the Workshop item’s numeric ID in its Steam URL.
- In Files, look for the server’s
WorkshopDownloadConfig.jsonand add the ID to theFile_IDslist, separating several IDs with commas, as the Unturned docs describe. - Restart. The server downloads items on start.
- For a map, also set the map name in the server’s
Commands.dat(Mapline). - If it still fails, open a ticket with the Console error.
Server crashes or lags on a modded map
Section titled “Server crashes or lags on a modded map”Why it happens: Large maps and mods use more memory and CPU.
How to fix it: Lower players, remove heavy mods, and check Out of memory. A bigger plan may help: Upgrade.
How do I make myself admin or owner?
Section titled “How do I make myself admin or owner?”Why it happens: The Owner command in Commands.dat gives admin rights by SteamID64.
How to fix it:
- Find your 17 digit SteamID64.
- In Files, open the server’s
Commands.dat. - Add a line
Ownerfollowed by your ID, as the Unturned docs show (one command per line). - Restart.
Rocket or OpenMod plugins do not load
Section titled “Rocket or OpenMod plugins do not load”Why it happens: Rocket and OpenMod are separate frameworks. Plugins need the framework installed and must match the game version.
How to fix it:
- Read the Console for the plugin error.
- Check the plugin author’s page for compatibility.
- Remove new plugins one at a time.
- We cannot promise any plugin works. Open a ticket if you need help with installation.
Server crash on start after an update
Section titled “Server crash on start after an update”Why it happens: An outdated plugin or a corrupt update.
How to fix it: Remove plugins or mods, restart, then add them back. See Server keeps restarting.
Server name or password not applied
Section titled “Server name or password not applied”Why it happens: They are set from Server Name (SRV_NAME) and Server Password (SRV_PW).
How to fix it: Edit them on Startup, save, restart. If a change made in a file does not stick, use these Startup values instead.
Still stuck?
Section titled “Still stuck?”Open a ticket or ask on Discord. See Contact support.