Unturned

Unturned Server Config: Commands.dat and Config.txt

An Unturned server reads three files: Commands.dat for the basics, Config.txt for deeper options and WorkshopDownloadConfig.json for mods. Here is what goes where.

TheGameHosting Team 5 min read
Unturned Server Config Explained
Background: Unturned © Smartly Dressed Games

Unturned server config is split across files in Servers/<server name>/. Server/Commands.dat holds the basics, one command per line: Name, Map, MaxPlayers, Password, PvE, Perspective, Mode, Owner and GSLT. Config.txt holds the deeper options (servers created before version 3.25.8.0 have Config.json instead). WorkshopDownloadConfig.json lists the Workshop mods to download. Stop the server, edit, save and start it again.

Below is each file, every common Commands.dat line with its default, and a full example for a PvP server.

The Unturned server folder

Smartly Dressed Games' server hosting guide explains that each server gets its own folder inside Servers. The files that matter:

FileWhat it holds
Servers/<name>/Server/Commands.datStartup commands: name, map, slots, password, mode
Servers/<name>/Config.txtAdvanced server options, including the Browser section
Servers/<name>/Config_NormalDifficulty.txtGameplay options for the Normal difficulty (newer servers)
Servers/<name>/WorkshopDownloadConfig.jsonSteam Workshop mods to install and update
Servers/<name>/Server/Adminlist.datAdmins, managed with the admin command

Commands.dat: every common line

Commands.dat is a plain text file with one command per line. Values come after a space. These are the main ones, with the defaults from the Unturned Wiki:

LineDefaultWhat it does
Name <text>UnturnedServer name in the list, 5 to 50 characters
Map <map>PEIMap to load, by name, such as Washington
MaxPlayers <number>8Slots, from 1 to 200
Password <text>nonePassword to join
PvEoffTurns off player-versus-player combat
Perspective <First/Third/Both/Vehicle>FirstCamera players can use
Mode <Easy/Normal/Hard>NormalDifficulty
Cycle <seconds>3600Length of a full day and night
Welcome <text>noneMessage on join
Owner <SteamID64>noneOwner with admin rights
CheatsoffAllows cheat commands for admins
Hide_AdminsoffHides who is admin
GSLT <token>noneGame Server Login Token
Port <number>27015Port the server uses
Queue_Size <number>0Players allowed to wait in a queue, up to 64

On TheGameHosting the port is assigned by the panel. Do not change Port in the file: give players the address and port shown in your panel.

Why you need a GSLT {#gslt}

The official GSLT page says servers without a Game Server Login Token are "anonymous" and hidden from the Internet server list. Create a token with your Steam account (app ID 304930) and put it on the GSLT line of Commands.dat, or in Login_Token under the Browser section of the server configuration.

A full Commands.dat example

Commands.dat
Name Washington Survival PvP
Map Washington
MaxPlayers 24
Perspective Both
Mode Normal
Welcome Welcome, survivor! Read the rules on our Discord.
Owner 76561198000000000
GSLT YOUR-TOKEN-HERE

For a PvE server, add a line with only PvE. For a private server, add Password and the password. The ID and token above are placeholders.

Config.txt: the advanced options

The server configuration page says most server options are in Config.txt. Key points:

  1. Servers created before 3.25.8.0 have Config.json. At startup the server converts it to the new format, keeping only the values you changed from the default.
  2. Gameplay values are stored per difficulty, in files such as Config_NormalDifficulty.txt. The Mode line in Commands.dat picks which one applies.
  3. An empty value means "use the default". Maps can override some values, but a value you set yourself takes priority.
  4. If you need the old format, the -UseLegacyJsonGameplayConfig launch option keeps Config.json.

Open the file in Files to see the options it lists. Change a few at a time and restart, so you can tell which one made the difference.

WorkshopDownloadConfig.json: maps and mods

To add Workshop content, put the item's file ID in the File_IDs list, separated by commas. The official guide says that at startup the server installs and updates those mods and their dependencies. A Workshop map is then loaded with its name on the Map line.

WorkshopDownloadConfig.json
"File_IDs": [
  1234567890,
  2345678901
]

The IDs are examples. Copy the real ones from each item's Workshop page.

How to edit your Unturned server config

  1. Make a backup in Backups so you can return to the old setup.
  2. Stop the server from Console.
  3. Open Files and go to Servers/<your server>/.
  4. Edit Server/Commands.dat, Config.txt or WorkshopDownloadConfig.json in the browser.
  5. Save and start the server.
  6. Watch Console while it starts: a bad Workshop ID or a typo shows up there.
  7. Join and check the name, map and rules.

Admin rights, the Owner line and cheat commands are covered in detail in how to add an admin on an Unturned server. Plugins with RocketMod and OpenMod are in our Unturned server setup guide.

Common problems

ProblemFix
Server not in the Internet listAdd a valid GSLT
Changes ignoredEdited while running, or a Startup value overrides it
Workshop map does not loadThe ID is missing from File_IDs or the Map name is wrong
Old guide mentions Config.jsonYour server may use Config.txt; check which file you have

Host Unturned on TheGameHosting

An Unturned server from TheGameHosting runs 24/7 on AMD 9950X and 7950X3D CPUs with DDR5 and NVMe, in Dallas or Amsterdam, with DDoS protection on every plan. Edit every config file in Files or over SFTP, use RocketMod and OpenMod plugins, and get two databases for economy and kits. Plans start at 2 GB for $1.90 USD a month, with no per-slot fees. See the plans and prices and use FULL2026 for 15% off for life.

FAQ

Where is the Unturned server config file?

In Servers/<server name>/. Server/Commands.dat has the basics, Config.txt has advanced options and WorkshopDownloadConfig.json lists Workshop mods.

Is it Config.json or Config.txt in Unturned?

Servers created before version 3.25.8.0 use Config.json; newer ones use Config.txt. The server converts the old file at startup.

How do I change max players on an Unturned server?

Set MaxPlayers in Commands.dat to a number from 1 to 200 and restart. Check the Startup tab too.

Why is my Unturned server not showing in the list?

Servers without a Game Server Login Token are hidden from the Internet list. Add your token on the GSLT line and restart.

Hosting for this game

Written by TheGameHosting Team, the people who run our servers in Dallas and Amsterdam and answer your tickets.

All posts