Garry's Mod – Häufige Fehler und wie man sie behebt

Diese Anleitung zeigt dir die häufigsten Probleme auf Garry's Mod Servern und wie du sie Schritt für Schritt behebst. Von Lua-Fehlern über Verbindungsprobleme bis zu abstürzenden Addons – hier findest du die Lösung.

Hinweis: Ausführliche Unterseiten zu Server-Konfiguration und Addon-Management findest du in der linken Navigation.

1. Lua-Fehler – Der häufigste Fehler überhaupt

Lua-Fehler entstehen, wenn ein Addon fehlerhaften Code enthält oder mit anderen Addons kollidiert. Sie erscheinen als rote Fehlermeldungen in der Server-Konsole oder im Client.

Fehler erkennen

[ERROR] addons/mein_addon/lua/autorun/server/sv_mein_script.lua:23: attempt to index a nil value
[ERROR] addons/mein_addon/lua/weapons/meine_waffe/shared.lua:156: 'end' expected (to close 'function' at line 12) near '<eof>'

Ursachen und Lösungen

• Fehlende Abhängigkeiten: Viele Addons benötigen andere Addons als Grundlage (z.B. Wiremod, ULX, DarkRP). Prüfe die Workshop-Seite des Addons auf "Required Items"
• Falsche Ladereihenfolge: Manche Addons müssen vor anderen geladen werden. In der Workshop Collection kannst du die Reihenfolge per Drag-and-Drop anpassen
• Veraltete Addons: Ein Addon wurde seit Jahren nicht aktualisiert und ist inkompatibel mit der aktuellen GMod-Version. Prüfe das letzte Update-Datum im Workshop
• Doppelte Addons: Zwei verschiedene Versionen des gleichen Addons sind installiert. Durchsuche deinen addons/-Ordner nach Duplikaten

Fehlerquelle finden

1. Alle nicht-essentiellen Addons deaktivieren
2. Server starten und prüfen ob der Fehler noch da ist
3. Addons einzeln wieder aktivieren bis der Fehler auftritt
4. Das zuletzt aktivierte Addon ist der Verursacher

2. Server erscheint nicht in der Serverliste

Der häufigste Grund, warum Spieler deinen Server nicht finden.

Ursachen und Lösungen

• Port nicht freigegeben: UDP-Port 27015 muss in Firewall und Router offen sein. Prüfe mit:

  # Auf dem Server selbst
  netstat -an | grep 27015
  
  # Von außen prüfen (auf einem anderen Rechner)
  nmap -sU -p 27015 deine-server-ip

• sv_lan falsch gesetzt: sv_lan 0 muss in der server.cfg stehen. Bei sv_lan 1 erscheint der Server nur im LAN
• Server hinter CGNAT: Manche Internetanbieter verwenden CGNAT (Carrier-Grade NAT) – dann hat dein Server keine öffentliche IP. Lösung: Einen VPS oder Rootserver bei NexoraHost nutzen
• Firewall blockt Query: Neben Port 27015 muss auch der Query-Port (meist 27016) offen sein. Öffne auch UDP 27016

3. "Connection failed after 4 retries"

Dieser Fehler erscheint bei Spielern, die versuchen deinem Server beizutreten.

Ursachen und Lösungen

• Server läuft nicht: Prüfe ob der Server-Prozess aktiv ist:

  # Windows
  tasklist | findstr srcds
  
  # Linux
  ps aux | grep srcds

• Falsche IP oder Port: Der Spieler verwendet die falsche IP oder den falschen Port. Korrekte Syntax: connect 123.123.123.123:27015
• Server voll: maxplayers erreicht? Prüfe die Konsole oder erhöhe das Limit
• Veraltete Client-Version: Der Spieler muss GMod auf die gleiche Version wie der Server aktualisieren
• Server im LAN-Modus: Prüfe sv_lan 0 in der server.cfg

4. "Addon konnte nicht heruntergeladen werden"

Spieler sehen diese Meldung, wenn der Server benutzerdefinierte Dateien nicht übertragen kann.

Ursachen und Lösungen

• FastDL falsch konfiguriert: Wenn du FastDL nutzt, prüfe ob die URL korrekt ist und der Webserver läuft:

  # In server.cfg – FastDL-URL prüfen
  sv_downloadurl "http://deine-domain.de/fastdl/"

• Dateien fehlen auf FastDL: Alle Addons und Maps müssen sowohl auf dem Gameserver als auch auf dem FastDL-Server liegen
• Kein FastDL eingerichtet: Ohne FastDL lädt der Server die Dateien selbst – das ist langsam. FastDL einrichten (siehe Performance-Anleitung)
• Zu große Dateien: Einzelne Dateien über 150 MB machen oft Probleme. Net_splitpacket_maxrate erhöhen:

  net_splitpacket_maxrate 100000

5. Server crashed beim Start oder nach kurzer Zeit

Ursachen und Lösungen

• Fehlende Bibliotheken (Linux):

  # Alle benötigten 32-Bit-Bibliotheken installieren
  sudo apt install -y lib32gcc-s1 lib32stdc++6 lib32z1 lib32ncurses6 lib32bz2-1.0

• Fehlerhaftes Addon: Ein kaputtes Addon crasht den Server sofort. Alle Addons aus dem addons/-Ordner entfernen und einzeln wieder hinzufügen
• Map defekt: Testweise auf eine Standard-Map wie gm_construct wechseln
• Zu wenig RAM: Der Server braucht mehr RAM als verfügbar. RAM-Nutzung mit htop prüfen
• Zu viele Addons: Hunderte Addons überfordern den Server. Auf maximal 50-100 Addons begrenzen

6. "Steam Auth Timeout" oder "No Steam Logon"

Ursachen und Lösungen

• Steam-Server nicht erreichbar: Der Server kann sich nicht bei Steam authentifizieren. Meist ein temporäres Problem – abwarten
• Firewall blockt Steam: Steam benötigt ausgehende Verbindungen auf Port 27014-27050 (TCP). Stelle sicher, dass ausgehende Verbindungen erlaubt sind
• Server-Token fehlt: Manche Server benötigen einen Game Server Login Token (GSLT). Erstelle einen unter steamcommunity.com/dev/managegameservers mit der App-ID 4000
• Token im Startskript setzen:

  +sv_setsteamaccount DEIN_GSLT_TOKEN

7. Spieler werden zufällig gekickt ("Timed out")

Ursachen und Lösungen

• Netzwerk-Timeout zu kurz: Erhöhe die Timeout-Werte in der server.cfg:

  sv_timeout 120
  net_maxroutable 1260
  net_earliertempents true

• Server überlastet: CPU-Last oder RAM voll – mit htop prüfen
• Bandbreite erschöpft: Zu viele Spieler für die verfügbare Upload-Bandbreite. Pro Spieler ca. 0,5-1 Mbps einplanen

8. "VAC banned from secure server"

Ursachen und Lösungen

• Spieler hat VAC-Bann: Der Spieler wurde in einem anderen Spiel per VAC gebannt. In server.cfg:

  sv_kickbanneduser 0  # VAC-gebannter Spieler dürfen beitreten (nicht empfohlen)

• VAC-System nicht erreichbar: Selten – abwarten und später erneut versuchen

9. Karte wechselt nicht oder lädt ewig

Ursachen und Lösungen

• Map nicht installiert: Die Map-Datei fehlt im maps/-Ordner. Workshop-Maps werden automatisch heruntergeladen, wenn die Collection verlinkt ist
• Map zu groß: Sehr große Maps brauchen lange zum Laden – Geduld haben oder kleinere Map wählen
• Fehlerhafte Map: Map ist beschädigt. Neu herunterladen oder andere Map nutzen

10. Allgemeine Debugging-Tipps

# Server mit ausführlichem Logging starten
-condebug +log on

# Logdatei prüfen
cat garrysmod/console.log | grep -i error

# Aktuelle Addon-Fehler anzeigen
cat garrysmod/console.log | grep "addons/" | grep -i error

# Server-Konsole live beobachten (Linux)
tail -f garrysmod/console.log

Schnell-Checkliste bei Problemen

1. Server-Konsole auf rote ERROR-Meldungen prüfen
2. Alle Addons testweise deaktivieren und Server ohne Addons starten
3. Firewall und Portfreigabe prüfen (UDP 27015, 27005, 27016)
4. sv_lan 0 in server.cfg prüfen
5. Ausreichend RAM und CPU verfügbar? (htop)
6. Alle benötigten Bibliotheken installiert? (Linux)
7. FastDL-URL erreichbar und korrekt?
8. Server neustarten – viele temporäre Probleme verschwinden danach

Passende Anleitungen

• Gameserver Hub
• Firewall & Ports
• Server laggt – Diagnose
• DNS Probleme

Server bei NexoraHost: nexorahost.com