Deze handleiding behandelt veelvoorkomende problemen die je kunt tegenkomen bij het draaien van een Team Fortress 2 dedicated server, waaronder GSLT-tokenproblemen, SourceMod dat niet laadt, VAC-fouten en zichtbaarheid in de serverbrowser. Voor de eerste serverinstallatie, zie de TF2 Server Setup Guide.
GSLT-tokenproblemen
Symptoom: Serverconsole toont "Invalid or expired GSLT" of de server wordt niet publiekelijk weergegeven.
Oorzaken en oplossingen:
- Het token is verlopen door langdurige inactiviteit — genereer een nieuw token op steamcommunity.com/dev/managegameservers.
- Het Steam-account dat eigenaar is van het token heeft een VAC-ban — een nieuw, niet-geband account moet het token genereren.
- Het token wordt al gebruikt door een andere draaiende server — elke serverinstantie heeft een eigen uniek token nodig.
- De
sv_setsteamaccount-regel inserver.cfgbevat een typefout of extra witruimte — controleer of deze exact overeenkomt met de tokenreeks. - Je hebt de verkeerde App ID gebruikt bij het genereren van het token — TF2 vereist App ID 440.
SourceMod Laadt Niet
Symptoom: sm version geeft "Unknown command" na installatie.
Oorzaken en oplossingen:
- MetaMod:Source is niet geïnstalleerd of laadt niet — controleer eerst of
meta versionwerkt. Als dat niet het geval is, controleer de MetaMod-installatie opnieuw. SourceMod kan niet functioneren zonder MetaMod. - Bestanden zijn naar de verkeerde map geüpload — SourceMod moet zich bevinden op
tf/addons/sourcemod/, niet in de serverroot of een andere gamemap. - Verkeerde build gedownload — de server draait op Linux. Zorg ervoor dat je de Linux-build hebt gedownload, niet de Windows-build.
- Bestandsrechten problemen — zorg ervoor dat alle geüploade bestanden leesbaar zijn. Upload opnieuw via SFTP als je twijfelt.
- Controleer de logs — bekijk
tf/addons/sourcemod/logs/voor foutmeldingen die aangeven wat niet kon worden geladen.
VAC-problemen / VAC Beveiligde Modus Uitgeschakeld
Symptoom: Serverconsole toont "VAC secure mode is disabled" of spelers krijgen een waarschuwing dat VAC is uitgeschakeld.
Oorzaken en oplossingen:
- Geen geldig GSLT — VAC vereist een geldig
sv_setsteamaccount-token. Zie de Server Setup Guide voor GSLT-instructies. - Een geladen plugin of extensie is gemarkeerd — sommige onofficiële binaire extensies kunnen ervoor zorgen dat VAC wordt uitgeschakeld. Verwijder recent geïnstalleerde plugins één voor één om de oorzaak te identificeren.
sv_cheats 1is ingesteld — VAC wordt automatisch uitgeschakeld wanneer cheats zijn ingeschakeld. Zorg ervoor datsv_cheats 0in jeserver.cfgstaat.- Als VAC uitgeschakeld blijft na het bovenstaande te hebben aangepakt, voer dan een volledige serverherstart uit (niet alleen een mapwissel).
Server Verschijnt Niet in Browser
Symptoom: Je server draait maar verschijnt niet in de Steam-serverbrowser.
Oorzaken en oplossingen:
- Geen geldig GSLT — een geldig Game Server Login Token is vereist voor publieke vermelding. Zie de Server Setup Guide.
- Server is net gestart — nieuwe servers kunnen enkele minuten nodig hebben om in de browser te verschijnen nadat ze voor het eerst verbinding hebben gemaakt met Steam.
- Firewall- of portprobleem — bevestig dat de gameport van de server open is. Controleer het GPanel voor je toegewezen port.
- Test eerst een directe verbinding — probeer te verbinden via
connect IP:PORTin de ontwikkelaarsconsole om te bevestigen dat de server bereikbaar is voordat je de browservermelding troubleshoot.
Plugins Laten de Server Crashen
Symptoom: Server crasht of herstart onverwacht na het installeren of bijwerken van een plugin.
Oorzaken en oplossingen:
- Controleer
tf/addons/sourcemod/logs/voor crashlogs en foutmeldingen direct na de crash. - Schakel recent toegevoegde plugins uit door hun
.smx-bestanden te verplaatsen naartf/addons/sourcemod/plugins/disabled/. - Zorg ervoor dat alle pluginafhankelijkheden (bijv. TF2Attributes, DHooks) zijn geïnstalleerd en de juiste versie hebben.
- Sommige plugins vereisen een specifieke SourceMod API-versie — controleer de compatibiliteit op de AlliedModders-thread van de plugin.
- Als de server crasht bij het opstarten, gebruik dan het GPanel-bestandsbeheer of SFTP om het problematische pluginbestand te verplaatsen terwijl de server is gestopt.
.smx-bestanden kunnen willekeurige commando's op je server uitvoeren. Gebruik alleen plugins van AlliedModders of geverifieerde GitHub-repositories.
Spelers Kunnen Niet Verbinden
Symptoom: Spelers krijgen een time-out, verbinding geweigerd, of "server not responding"-fout.
Oorzaken en oplossingen:
- Server draait niet — controleer het GPanel om te bevestigen dat de server online is en niet in een crashlus zit.
- Verkeerd IP of verkeerde port — controleer de verbindingsgegevens in GPanel. Zie de handleiding Hoe Vind Je Je Server IP en Port.
- Wachtwoord komt niet overeen — als
sv_passwordis ingesteld inserver.cfg, moet de speler het juiste wachtwoord invoeren bij het verbinden. - Server is vol — controleer of de server de
maxplayers-limiet heeft bereikt. - Time-out bij downloaden van aangepaste map — als de server een aangepaste map draait zonder geconfigureerd FastDL, kunnen spelers met een trage verbinding een time-out krijgen tijdens het downloaden van de map. Zie de Server Setup Guide voor FastDL-configuratie.
Algemene Diagnostische Stappen
Bij het troubleshooten van een TF2-serverprobleem, volg deze stappen om nuttige informatie te verzamelen voordat je een supportticket opent:
- Controleer de serverconsole-uitvoer in GPanel op foutmeldingen.
- Bekijk logs op
tf/addons/sourcemod/logs/(als SourceMod is geïnstalleerd). - Controleer
tf/console.logof de GPanel-console op engine-level fouten. - Als het probleem begon na een wijziging, draai de wijziging terug en test opnieuw.
- Probeer direct te verbinden via
connect IP:PORTin de ontwikkelaarsconsole om browsergerelateerde problemen uit te sluiten.
Gerelateerde Artikelen
- TF2 Server Setup Guide — Server.cfg-configuratie, GSLT-tokens, maprotatie, FastDL, verbinden
- TF2 Admin & Plugin Setup — SourceMod/MetaMod-installatie, beheerdersaccounts, pluginbeheer
- Hoe Vind Je Je Server IP en Port
- Hoe Upload Je Bestanden via SFTP
tf/addons/sourcemod/logs/ of je serverconsole.