Introduction to Unturned Server Configuration Properly configuring your Unturned server is essential for creating the best gameplay experience for your players. This guide walks you through the various configuration files and options available on the Wasabi Hosting Gamepanel.
Core Configuration Files Unturned servers use several key configuration files that control different aspects of the game:
Configuration File Overview
File Location Purpose Commands.dat /Servers/YourServerName/Server startup commands Config.json /Servers/YourServerName/Server/Main game settings Admins.dat /Servers/YourServerName/Server/Administrator list Mods.dat /Servers/YourServerName/Server/Moderator list WorkshopItems.dat /Servers/YourServerName/Server/Workshop mod list Welcome.txt /Servers/YourServerName/Server/Welcome message Rocket/Permissions.config.xml /Servers/YourServerName/Rocket permissions (if using Rocket)
Basic Server Setup Commands.dat Configuration The Commands.dat file contains startup commands for your server. Here’s a template with recommended settings:
// Basic Settings Name MyUnturnedServer Map PEI Port 27015 Password "" MaxPlayers 24 Perspective Both GameMode Normal // Difficulty Settings Difficulty Normal Cheats Disabled PVE Disabled Decay Enabled BattlEye Enabled // Performance Settings Log 3 FrameRate 30 Timeout 120 Tick_Delay 0.015 Max_Ping 1250 Max_Packets_Per_Second 800 // Gameplay Settings Durability_Vehicles Enabled Durability_Weapons Enabled Durability_Clothing Enabled Gold Disabled Allow_Workshop Enabled // Security Settings Hide_Admins Enabled HideAdminsLocal Enabled Invite_Only Disabled Don’t set the FrameRate higher than 30 unless you have a very powerful server, as higher values significantly increase CPU usage.
Config.json Customization The Config.json file in /Servers/YourServerName/Server/ allows more detailed configuration. Here’s a recommended setup:
{ "Browser" : { "Broadcast" : true , "Password" : false , "ListInMasterServerList" : true , "Lan" : false , "PvP" : true , "Port" : 27015 , "Public" : true }, "Gameplay" : { "Acid" : { "Can_Damage_Buildables" : true , "Can_Damage_Environment" : true , "Can_Damage_Players" : true , "Can_Damage_Resources" : true , "Can_Damage_Vehicles" : true , "Can_Start_Fire" : true , "Gun_Bullets_Cause_Acid" : false , "Melee_Causes_Acid" : false }, "Allow_Shoulder_Camera" : true , "Allow_Statistic_Tracking" : true , "Allow_Vote_For_Shutdown" : false , "Allow_Workshop_Items" : true , "Anti_Cheat" : { "Allow_Battleye_Client" : true , "Kicks_Per_Minute_Threshold" : 10 , "Max_Flagged_Packets_Before_Kick" : 30 , "Max_Invalid_Character_Packets_Before_Kick" : 20 , "Max_Invalid_Vehicle_Packets_Before_Kick" : 10 , "Max_Ping" : 1250 , "Max_Successful_Teleports_Before_Kick" : 5 , "Max_Unsuccessful_Teleports_Before_Kick" : 5 , "Max_Vehicle_Distance_Before_Kick" : 60 , "Max_Walk_Speed" : 15 }, "Assault_Rifle_Burst_Shots_Per_Second" : 7.5 , "Auto_Save_Interval_Seconds" : 900 , "Bleeding_Damage" : 5 , "Broken_Legs_Damage" : 10 , "Bullets_Hurt_Barricades" : true , "Bullets_Hurt_Plants" : true , "Bypass_Buildable_Restrictions" : false , "Decay_Time" : 604800 , "Decay_Vehicles" : true , "Fall_Damage" : true , "Food_Decrease_Multiplier" : 1.0 , "Gravity_Multiplier" : 1.0 , "Group_Limit" : 0 , "Hair_Grow_Time" : 259200 , "Item_Despawn_Seconds" : 600 , "Weapon_Jam_Quality_Threshold" : 10 , "Max_Items_Per_Container" : 40 , "Max_Items_Spawn" : 96 , "Max_Barrel_Drops" : 5 , "Max_Zombies_Spawned" : 64 , "Max_Animals_Spawned" : 16 , "Zombie_Spawn_Interval" : 15 , "Player_Height_Threshold" : 12 , "Player_Stance_Samples" : 32 , "Player_Sprinting_Grace" : 0.75 }, "Login" : { "Timeout_Queue" : 60 , "Timeout_Linking" : 30 , "Queue_Size" : 10 } } The settings in Config.json override those in Commands.dat if both specify the same option.
Welcome Message Setup Create a Welcome.txt file in your /Servers/YourServerName/Server/ directory to display a message when players join:
Welcome to our Unturned server! 📜 Server Rules: 1. No cheating or exploiting 2. Be respectful to other players 3. No spamming or advertising 🔗 Join our Discord: discord.gg/yourserver You can use basic formatting in your welcome message with color codes:
<color=red>Text</color> - Colored text<size=20>Text</size> - Change text size<b>Text</b> - Bold text<i>Text</i> - Italic text Workshop Mod Configuration To add Workshop mods to your server:
Create or edit WorkshopItems.dat in your /Servers/YourServerName/Server/ directory:
// Format: One Workshop ID per line 2563837253 2183779444 1539621795
You can also specify Workshop mods in your startup parameters in Gamepanel:
+WorkshopDownloadConfig +InternetServer/YourServerName Too many Workshop mods can significantly increase server startup time and memory usage. Keep your mod list optimized.
Admin and Moderator Setup Set up administrators and moderators by editing the respective files:
Admins.dat // Place one Steam64 ID per line 76561198012345678 76561198087654321 Mods.dat // Place one Steam64 ID per line 76561198076543210 76561198076543211 You can find a player’s Steam64 ID by searching their username on SteamID.io .
Game Mode Configuration Unturned offers several game modes that can be set in Commands.dat:
The standard Unturned experience:
GameMode Normal Difficulty Normal PVE Disabled Gold Disabled The standard Unturned experience:
GameMode Normal Difficulty Normal PVE Disabled Gold Disabled For peaceful cooperative gameplay:
GameMode Normal Difficulty Normal PVE Enabled Friendly_Fire Disabled Gold Disabled For competitive PvP gameplay:
GameMode Arena Difficulty Normal Arena_Teams 4 Arena_Players_Per_Team 1 Arena_Rounds 5 Respawn_Time 10 Zombie wave defense mode:
GameMode Horde Difficulty Hard Horde_Max_Zombies 100 Horde_Num_Waves 10 Difficulty Settings Customize the server difficulty in Commands.dat:
// Easy difficulty (more loot, less damage) Difficulty Easy Item_Respawn_Time 20 Player_Health_Regen 60 Zombie_Damage_Multiplier 0.75 Loot_Quantity_Multiplier 1.5 // Hard difficulty (less loot, more damage) Difficulty Hard Item_Respawn_Time 45 Player_Health_Regen 30 Zombie_Damage_Multiplier 1.5 Loot_Quantity_Multiplier 0.75 Economy Configuration (with Rocket) If you’re using the Uconomy plugin with Rocket, configure your economy in /Rocket/Uconomy/Uconomy.configuration.xml:
<? xml version = "1.0" encoding = "utf-8" ?> < UconomyConfiguration xmlns:xsd = "http://www.w3.org/2001/XMLSchema" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" > < DatabaseAddress > localhost </ DatabaseAddress > < DatabaseUsername > username </ DatabaseUsername > < DatabasePassword > password </ DatabasePassword > < DatabaseName > uconomy </ DatabaseName > < DatabaseTableName > uconomy </ DatabaseTableName > < DatabasePort > 3306 </ DatabasePort > < PayDay > < Enabled > true </ Enabled > < Interval > 600 </ Interval > < Amount > 20 </ Amount > </ PayDay > < InitialBalance > 100 </ InitialBalance > < CurrencyName > Credits </ CurrencyName > < MessageColor > green </ MessageColor > </ UconomyConfiguration > Custom Map Setup To use a custom map on your server:
Upload the map files to /Servers/YourServerName/Maps/YourMapName/
Edit your Commands.dat to use the custom map:
Custom maps can cause server performance issues if they’re large or poorly optimized. Test thoroughly before deployment.
Rocket Configuration If you’re using Rocket to extend your server functionality:
Basic Rocket Configuration Configure your /Rocket/Rocket.config.xml file:
<? xml version = "1.0" encoding = "utf-8" ?> < RocketConfiguration xmlns:xsd = "http://www.w3.org/2001/XMLSchema" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" > < WebPermissions > false </ WebPermissions > < AutomaticShutdown > false </ AutomaticShutdown > < Economy > < Enabled > true </ Enabled > < ItemValueMultiplier > 1.0 </ ItemValueMultiplier > < VehicleValueMultiplier > 1.0 </ VehicleValueMultiplier > </ Economy > < Flat > false </ Flat > < RCON > < Enabled > true </ Enabled > < Port > 27020 </ Port > < Password > YourSecurePassword </ Password > </ RCON > </ RocketConfiguration > Rocket Permissions Setup Configure /Rocket/Permissions.config.xml for user permissions:
<? xml version = "1.0" encoding = "utf-8" ?> < RocketPermissions xmlns:xsd = "http://www.w3.org/2001/XMLSchema" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" > < DefaultGroup > default </ DefaultGroup > < Groups > < Group > < Id > default </ Id > < DisplayName > Player </ DisplayName > < Color > white </ Color > < Permissions > < Permission > rocket.kits </ Permission > < Permission > rocket.tpa </ Permission > < Permission > rocket.home </ Permission > </ Permissions > </ Group > < Group > < Id > vip </ Id > < DisplayName > VIP </ DisplayName > < Color > yellow </ Color > < ParentGroup > default </ ParentGroup > < Permissions > < Permission > rocket.kits.vip </ Permission > < Permission > rocket.warp </ Permission > < Permission > rocket.sethome.multiple.3 </ Permission > </ Permissions > </ Group > < Group > < Id > moderator </ Id > < DisplayName > Moderator </ DisplayName > < Color > green </ Color > < ParentGroup > vip </ ParentGroup > < Permissions > < Permission > rocket.teleport </ Permission > < Permission > rocket.teleport.other </ Permission > < Permission > rocket.kick </ Permission > < Permission > rocket.ban.short </ Permission > < Permission > rocket.vanish </ Permission > </ Permissions > </ Group > < Group > < Id > admin </ Id > < DisplayName > Administrator </ DisplayName > < Color > red </ Color > < ParentGroup > moderator </ ParentGroup > < Permissions > < Permission > rocket.* </ Permission > </ Permissions > </ Group > </ Groups > </ RocketPermissions > Plugin Configuration Examples
Configure /Rocket/Plugins/Home/Home.configuration.xml:
<? xml version = "1.0" encoding = "utf-8" ?> < HomeConfiguration xmlns:xsd = "http://www.w3.org/2001/XMLSchema" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" > < HomeLimit > 1 </ HomeLimit > < HomeEnabled > true </ HomeEnabled > < CooldownMin > 30 </ CooldownMin > < WarmupSec > 5 </ WarmupSec > < HomeCost > 15 </ HomeCost > < MaxHomesPerPlayer > 3 </ MaxHomesPerPlayer > </ HomeConfiguration >
Configure /Rocket/Plugins/Kits/Kits.configuration.xml:
<? xml version = "1.0" encoding = "utf-8" ?> < KitsConfiguration xmlns:xsd = "http://www.w3.org/2001/XMLSchema" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" > < Kits > < Kit > < Name > starter </ Name > < Cooldown > 86400 </ Cooldown > < Cost > 0 </ Cost > < Items > < KitItem > < ItemId > 13 </ ItemId > < Amount > 1 </ Amount > </ KitItem > < KitItem > < ItemId > 14 </ ItemId > < Amount > 1 </ Amount > </ KitItem > < KitItem > < ItemId > 15 </ ItemId > < Amount > 1 </ Amount > </ KitItem > </ Items > < XP > 0 </ XP > < Vehicle > 0 </ Vehicle > </ Kit > < Kit > < Name > vip </ Name > < Cooldown > 43200 </ Cooldown > < Cost > 0 </ Cost > < Items > < KitItem > < ItemId > 363 </ ItemId > < Amount > 1 </ Amount > </ KitItem > < KitItem > < ItemId > 17 </ ItemId > < Amount > 5 </ Amount > </ KitItem > </ Items > < XP > 50 </ XP > < Vehicle > 0 </ Vehicle > </ Kit > </ Kits > </ KitsConfiguration >
Configure /Rocket/Plugins/TPAlwaysAllowed/TPAlwaysAllowed.configuration.xml:
<? xml version = "1.0" encoding = "utf-8" ?> < TPAlwaysAllowedConfiguration xmlns:xsd = "http://www.w3.org/2001/XMLSchema" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" > < TPATimer > 120 </ TPATimer > < TPACooldown > 30 </ TPACooldown > < TPAEnabled > true </ TPAEnabled > < TPAWarmup > 5 </ TPAWarmup > < TPACost > 15 </ TPACost > </ TPAlwaysAllowedConfiguration > Advanced Settings BattlEye Configuration To configure BattlEye anti-cheat, edit /BattlEye/Config/BEServer.cfg:
RConPort 2310 RestrictRCon 0 MaxPing 1000 MaxPacketsize 1024 MinPacketLoss 0.0 MaxPacketLoss 0.2 MinPktRate 80 MinPktRateOnJoin 20 PacketFlood 2000 Hosting Multiple Servers If you want to host multiple Unturned servers on the same machine, each needs its own port:
// First server Port 27015 Query_Port 27016 Rcon_Port 27017 // Second server Port 27018 Query_Port 27019 Rcon_Port 27020 Startup Parameters Configure these in your Wasabi Hosting Gamepanel startup command:
+InternetServer/YourServerName -Port=27015 -Secure -Framerate=30 -Rolling=Minute -LogLevel=1 -PVP -NoWorkshopExplicitLoading
Parameter Description Recommended Value +InternetServer/YourServerNameSpecifies server name Your server name -Port=27015Server port 27015 (default) -SecureEnables VAC Always use this -Framerate=30Server tick rate 30 (optimal balance) -Rolling=MinuteSave interval Minute (prevents data loss) -LogLevel=1Detail level of logging 1 or 2 -PVPEnables player vs player Optional -NoWorkshopExplicitLoadingMore efficient mod loading Recommended
Map-Specific Configuration Different maps may require specific settings:
Large map with many zombies:
Map Russia Max_Zombies_Spawned 64 Max_Items_Spawn 128 Max_Vehicles 32 Large map with many zombies:
Map Russia Max_Zombies_Spawned 64 Max_Items_Spawn 128 Max_Vehicles 32 Smaller map for better performance:
Map PEI Max_Zombies_Spawned 48 Max_Items_Spawn 96 Max_Vehicles 24 Balanced medium-sized map:
Map Washington Max_Zombies_Spawned 56 Max_Items_Spawn 112 Max_Vehicles 28 Snow map with survival focus:
Map Yukon Max_Zombies_Spawned 48 Max_Items_Spawn 80 Max_Vehicles 20 Temperature_Min -15 Temperature_Max 5 Database Configuration If your server or plugins use MySQL, configure your database in the relevant plugin configuration files:
< DatabaseAddress > localhost </ DatabaseAddress > < DatabaseUsername > username </ DatabaseUsername > < DatabasePassword > password </ DatabasePassword > < DatabaseName > database </ DatabaseName > < DatabasePort > 3306 </ DatabasePort > Store database passwords securely and never share your database credentials.
Security Best Practices Follow these security recommendations on your Wasabi Hosting Unturned server:
Use strong passwords for RCON and server accessEnable BattlEye for anti-cheat protectionRegularly update your server and pluginsBack up configurations before making changesMonitor logs for suspicious activityImplement permission restrictions carefully
Troubleshooting Common Issues
Check for errors in the Gamepanel console
Verify proper syntax in configuration files
Ensure no duplicate entries exist in Commands.dat
Check for corrupted configuration files
Try starting with a minimal configuration and add features gradually
Verify the server is running
Check firewall settings
Ensure the correct port is open (default: 27015)
Verify the server is publicly listed
Check for BattlEye compatibility issues
Ensure plugin versions are compatible with your server version
Check for plugin conflicts
Verify proper XML syntax in configuration files
Check /Rocket/Logs/ for specific error messages
Try disabling and re-enabling plugins one by one
By following this guide, you should be able to configure your Unturned server on Wasabi Hosting to provide an excellent gameplay experience. If you need additional assistance, contact our support team.
