background image

Unturned Server Troubleshooting - Knowledgebase

  1. Rent A Game Server
  2. Knowledgebase
  3. Unturned
  4. Unturned Server Troubleshooting
Knowledge Base Submit Ticket Open Tickets
Game Servers 380 7 Days to Die 4 Abiotic Factor 2 Aloft 2 alt:V 2 Americas Army Proving Grounds 2 Among Us 2 Archean 2 ARK Survival Ascended 6 ARK Survival Evolved 3 Arma 3 3 Arma Reforger 2 Aska 2 AssaultCube 2 Assetto Corsa 3 Astro Colony 2 Astroneer 2 Automobilista 2 2 Avorion 2 Banana Shooter 2 Barotrauma 3 BATTALION Legacy 2 BeamNG.drive (BeamMP) 2 Black Mesa 2 Brickadia 2 Call of Duty 2 Citadel: Forged with Fire 2 ClassiCube 2 Clone Hero 2 Colony Survival 2 Conan Exiles 4 Contagion 2 Core Keeper 2 Counter-Strike 2 3 Craftopia 2 CryoFall 2 CS2D 2 Cube 2: Sauerbraten 2 Cubic Odyssey 2 DayZ 4 DDNet 2 DDRaceNetwork 2 Dead Matter 2 Dont Starve Together 4 Eco 2 Empyrion Galactic Survival 2 Enshrouded 3 Escape from Tarkov 2 Euro Truck Simulator 2 2 Factorio 2 Farming Simulator 25 2 Fistful of Frags 2 FiveM 3 FortressCraft Evolved 2 Foundry 2 Foundry VTT 2 Frozen Flame 2 FTL Tachyon 2 Garrys Mod 3 Ground Branch 2 Half-Life 2 Deathmatch 2 Hogwarp 2 Holdfast: Nations at War 2 HumanitZ 2 Hurtworld 2 Hytale 1 Icarus 2 Insurgency Sandstorm 2 IOSoccer 2 Just Cause 3 Multiplayer 2 Kerbal Space Program 2 Killing Floor 2 3 LeagueSandbox 2 Left 4 Dead 2 Left 4 Dead 2 3 Longvinter 2 Los Angeles Crimes 2 Medal of Honor 2 Midnight Ghost Hunt 2 Mindustry 2 Minecraft 4 Minetest 2 Modiverse 2 Mordhau 3 Mount & Blade II: Bannerlord 2 Myth of Empires 2 Nazi Zombies Portable 2 Necesse 2 NeosVR 2 Neverwinter Nights EE 2 Night of the Dead 2 Nightingale 2 No Love Lost 2 No More Room in Hell 2 No One Survived 2 Nova-Life Amboise 2 Nuclear Option 2 Onset 2 Open Fortress 2 OpenArena 2 OpenRA 2 OpenRCT2 2 OpenTTD 2 Operation Harsh Doorstop 2 Palworld 3 Path of Titans 2 Pavlov VR 3 PixARK 2 Plains of Pain 2 Portal Knights 2 Post Scriptum 2 Project Zomboid 8 Puck 2 Quake Live 2 R5Reloaded 2 RedM 2 Renown 2 Resonite 2 Return to Moria 2 Rimworld Together 2 Rising World 2 Risk of Rain 2 1 Rust 4 Satisfactory 1 SCP Secret Laboratory 3 SCUM 2 Smalland 2 Solace Crafting 2 Soldat 2 Soldat 2 2 Sonic Robo Blast 2 2 Sons of the Forest 2 Soulmask 2 SourceCoop 2 Space Engineers 3 Space Station 14 2 Squad 3 Starbound 3 StarMade 2 Stationeers 2 Stormworks 2 Subnautica Nitrox 2 Sunkenland 2 SuperTuxKart 2 Sven Co-op 2 Swords 'n Magic and Stuff 2 Team Fortress 2 3 Teeworlds 2 Terraria 3 TerraTech Worlds 2 TF2 Classified 2 The Forest 3 The Front 2 The Isle 2 Tower Unite 2 Trackmania 2 Unturned 4 Urban Terror 2 V Rising 3 Valheim 3 VEIN 2 Veloren 2 Vintage Story 3 Voyagers of Nera 2 Wolfenstein: Enemy Territory 2 Wreckfest 2 Wurm Unlimited 2 Xonotic 2 Zandronum 2 Getting Started 2 Network & Connectivity 1 Server Management 2
Support
Categories

Unturned Server Troubleshooting

unturned troubleshooting crashes connection workshop plugins 0 found this helpful
Available in: ESPAÑOL PORTUGUÊS (BRASIL)

Unturned Server Troubleshooting

This guide covers common issues with Unturned dedicated servers on Legion Hosting and how to resolve them. For initial server setup, see the Unturned Server Setup Guide.

Server Not Showing in the Server Browser

If your server is running but does not appear in the Unturned or Steam server browser:

  • GSLT required: Without a valid Game Server Login Token, your server may not appear publicly in the server list. Generate one from the Steam Game Server Account Management page using App ID 304930, then paste it into the GSLT field in GPanel's Startup tab. See the Server Setup Guide for full instructions.
  • Wait 5-10 minutes after startup — Steam takes time to index new servers.
  • Confirm the server is running in GPanel (green status indicator).
  • Try connecting directly using IP and port to verify the server is reachable. See How to Find Your Server IP and Port.
  • Ensure the game port and query port (game port + 1) match what is assigned in GPanel's Network tab.

Cannot Connect / Connection Timed Out

If you receive a connection timeout or cannot join your server:

  • Confirm the server is running and shows a green status in GPanel.
  • Verify you are using the correct IP address and port — check How to Find Your Server IP and Port.
  • Check that the Port value in Commands.dat matches the port assigned to your server in GPanel's Network tab. A mismatch will prevent connections.
  • If you set a Password in Commands.dat, make sure you are entering it correctly when connecting.
  • Try restarting the server from GPanel.
  • If the issue persists, check the server console log in GPanel for error messages.

Workshop Mods Not Downloading

If workshop mods are not loading after a restart:

  • Open Servers/default/WorkshopDownloadConfig.json and verify it is valid JSON. Common mistakes include missing commas between IDs, trailing commas after the last ID, or mismatched brackets.
  • Confirm Workshop item IDs are correct integers (not quoted strings).
  • Check the server console log in GPanel for Steam API or download errors during startup.
  • Some workshop items may have been restricted or removed by their authors — verify they are still publicly available on the Steam Workshop.
  • Workshop items with dependencies may require additional IDs in the config. Check the mod's workshop page for required items.

For more details, see the Mod and Plugin Installation guide.

Rocket Plugins Not Loading

If RocketMod or LDM plugins are not working after installation:

  • Confirm the .dll file is placed directly in Rocket/Plugins/ — not inside a subfolder or ZIP archive.
  • Check the GPanel console log for plugin load errors after restarting the server. Error messages typically indicate version incompatibility or missing dependencies.
  • Ensure the plugin version is compatible with your version of Unturned and RocketMod/LDM.
  • Some plugins require other DLL dependencies that must also be placed in the Rocket/Plugins/ folder.
  • If the plugin was working previously and stopped after an Unturned update, check for a newer version of the plugin from the author.

For plugin installation details, see the Mod and Plugin Installation guide.

Server Crashes on Startup

If the server immediately stops or crashes after starting:

  • Check the console log in GPanel — the error message near the end of the log will indicate what went wrong.
  • Invalid Commands.dat: A malformed or corrupt Commands.dat can prevent startup. To reset, delete Servers/default/Commands.dat via the GPanel file manager and restart the server. It will be regenerated with defaults.
  • Bad workshop mod: An incompatible or corrupted workshop mod can cause crashes. Remove all Workshop IDs from WorkshopDownloadConfig.json, confirm the server starts cleanly, then re-add IDs one at a time to identify the problem mod.
  • Corrupt plugin: A bad Rocket plugin can also crash the server. Remove all .dll files from Rocket/Plugins/, verify the server starts, then re-add plugins one at a time.
  • If the server crashes with no obvious error, try reinstalling the server files from GPanel's Settings tab (Reinstall Server option).

Players Being Kicked Unexpectedly

If players are being disconnected or kicked without explanation:

  • Check the server console log for kick reasons — common causes include BattlEye anti-cheat violations or timeout errors.
  • If using workshop mods, ensure all players have subscribed to the same workshop items. Missing content can cause desync kicks.
  • High server resource usage (RAM or CPU) can cause player timeouts. Monitor resource usage in GPanel and consider reducing MaxPlayers or removing resource-heavy mods.
  • If a specific player is being kicked repeatedly, their game files may be corrupted — advise them to verify game files through Steam (right-click Unturned > Properties > Local Files > Verify).

Map Not Loading / Wrong Map

If the server starts but loads the wrong map or fails to load a workshop map:

  • Verify the Map value in Commands.dat matches the exact internal name (e.g., PEI, Washington, Russia). Names are case-sensitive.
  • For workshop maps, the Workshop ID must be in WorkshopDownloadConfig.json and the Map value must match the downloaded folder name, not the workshop display name.
  • Check the server console log during startup for map loading errors or download failures.

Related Articles

Need Help?

If you are still experiencing issues after trying the solutions above, our support team is available to assist you.

Open a Support Ticket
Was this article helpful?
Help Improve

Related Articles

Unturned Admin Setup
Unturned Admin Setup This guide explains how to grant admin permissions on your Unturned server, ... Unturned Mod and Plugin Installation
Unturned Mod and Plugin Installation This guide covers how to install Steam Workshop mods and Roc... Unturned Server Setup Guide
Unturned Server Setup Guide This guide covers how to get your Unturned dedicated server running o...
Back

Ready to Get Started?

The servers are booted, select your plan and become our latest satisfied client.