background image
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
Categorias

TF2 Server Troubleshooting Guide


This guide covers common issues you may encounter when running a Team Fortress 2 dedicated server, including GSLT token problems, SourceMod not loading, VAC errors, and server browser visibility. For initial server setup, see the TF2 Server Setup Guide.

GSLT Token Issues

Symptom: Server console shows "Invalid or expired GSLT" or the server is not listed publicly.

Causes and fixes:

  • The token has expired due to extended inactivity — regenerate it at steamcommunity.com/dev/managegameservers.
  • The Steam account that owns the token has a VAC ban — a new, unbanned account must generate the token.
  • The token is already in use by another running server — each server instance needs its own unique token.
  • The sv_setsteamaccount line in server.cfg has a typo or extra whitespace — verify it exactly matches the token string.
  • You used the wrong App ID when generating the token — TF2 requires App ID 440.

SourceMod Not Loading

Symptom: sm version returns "Unknown command" after installation.

Causes and fixes:

  • MetaMod:Source is not installed or not loading — confirm meta version works first. If it does not, re-check the MetaMod installation. SourceMod cannot function without MetaMod.
  • Files uploaded to the wrong directory — SourceMod must be at tf/addons/sourcemod/, not in the server root or a different game folder.
  • Wrong build downloaded — the server runs on Linux. Make sure you downloaded the Linux build, not the Windows build.
  • File permission issues — ensure all uploaded files are readable. Re-upload via SFTP if unsure.
  • Check the logs — review tf/addons/sourcemod/logs/ for error messages indicating what failed to load.
Tip: After fixing any SourceMod installation issue, always perform a full server restart (not just a map change) to ensure everything loads cleanly.

VAC Issues / VAC Secure Mode Disabled

Symptom: Server console shows "VAC secure mode is disabled" or players are warned that VAC is off.

Causes and fixes:

  • No valid GSLT — VAC requires a valid sv_setsteamaccount token. See the Server Setup Guide for GSLT instructions.
  • A loaded plugin or extension is flagged — some unofficial binary extensions can trigger VAC to disable. Remove recently installed plugins one at a time to identify the cause.
  • sv_cheats 1 is set — VAC is automatically disabled when cheats are enabled. Ensure sv_cheats 0 is in your server.cfg.
  • If VAC remains disabled after addressing the above, perform a full server restart (not just a map change).

Server Not Appearing in Browser

Symptom: Your server is running but does not show up in the Steam server browser.

Causes and fixes:

  • No valid GSLT — a valid Game Server Login Token is required for public listing. See the Server Setup Guide.
  • Server just started — new servers can take several minutes to appear in the browser after first connecting to Steam.
  • Firewall or port issue — confirm the server's game port is open. Check the GPanel for your assigned port.
  • Test direct connection first — try connecting via connect IP:PORT in the developer console to confirm the server is reachable before troubleshooting browser listing.

Plugins Crashing the Server

Symptom: Server crashes or restarts unexpectedly after installing or updating a plugin.

Causes and fixes:

  • Check tf/addons/sourcemod/logs/ for crash logs and error messages immediately after the crash.
  • Disable recently added plugins by moving their .smx files to tf/addons/sourcemod/plugins/disabled/.
  • Ensure all plugin dependencies (e.g. TF2Attributes, DHooks) are installed and at the correct version.
  • Some plugins require a specific SourceMod API version — verify compatibility on the plugin's AlliedModders thread.
  • If the server crashes on startup, use the GPanel file manager or SFTP to move the problematic plugin file while the server is stopped.
Warning: Never install plugins from untrusted sources. Malicious .smx files can execute arbitrary commands on your server. Only use plugins from AlliedModders or verified GitHub repositories.

Players Cannot Connect

Symptom: Players receive a timeout, connection refused, or "server not responding" error.

Causes and fixes:

  • Server is not running — check the GPanel to confirm the server is online and not in a crash loop.
  • Wrong IP or port — verify the connection details in GPanel. See the How to Find Your Server IP and Port guide.
  • Password mismatch — if sv_password is set in server.cfg, the player must enter the correct password when connecting.
  • Server is full — check if the server has reached its maxplayers limit.
  • Custom map download timeout — if the server is running a custom map without FastDL configured, players with slow connections may time out during the map download. See the Server Setup Guide for FastDL configuration.

General Diagnostic Steps

When troubleshooting any TF2 server issue, follow these steps to gather useful information before opening a support ticket:

  1. Check the server console output in GPanel for error messages.
  2. Review logs at tf/addons/sourcemod/logs/ (if SourceMod is installed).
  3. Check tf/console.log or the GPanel console for engine-level errors.
  4. If the issue started after a change, revert the change and test again.
  5. Try connecting directly via connect IP:PORT in the developer console to rule out browser-related issues.

Related Articles


Still need help? If you are unable to resolve the issue using this guide, please open a support ticket and include any relevant log output from tf/addons/sourcemod/logs/ or your server console.

Este artigo foi útil?

Ready to Get Started?

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