FiveM Server Thread Hitch Warning loesen

Die Meldung "server thread hitch warning" in der FiveM-Konsole bedeutet, dass ein Script den Hauptthread laenger als 150 ms blockiert hat. Spieler bemerken das als Lag, Teleport-Ruckler, einfrierende Fahrzeuge oder NPCs, die nicht mehr reagieren. Das Problem liegt fast immer in einer Resource, nicht in der Hardware.

Was technisch passiert

Der FiveM-Server fuehrt alles auf einem einzelnen Thread aus. Jeder Tick muss innerhalb von 16 ms abgeschlossen sein, um 60 Ticks pro Sekunde zu erreichen. Wenn ein Script 150 ms oder mehr fuer eine einzelne Operation benoetigt, gibt FiveM die Hitch Warning aus. Der Server geraet in Rueckstand und muss aufholen, was Spieler als kurzes Einfrieren erleben.

Schritt 1: Ursache finden mit resmon

Verbinde dich mit deinem Server und oeffne die F8-Konsole. Tippe resmon 1. Es erscheint ein Overlay, das pro Resource den CPU- und Speicherverbrauch anzeigt. Jede Resource ueber 0,25 ms ist einen Blick wert. Ueber 1 ms ist verdaechtig. Ueber 5 ms ist mit hoher Wahrscheinlichkeit die Ursache deiner Hitch Warnings.

Schritt 2: Server-Side Profiler

Resmon zeigt das Client-Side-Bild. Fuer serverseitige Probleme verwendest du den integrierten Profiler:

1. Tippe in der Serverkonsole: profiler record 500
2. Warte, bis die Aufnahme abgeschlossen ist.
3. Tippe: profiler save meinprofil
4. Tippe: profiler view meinprofil

Es erscheint ein Link, den du im Browser oeffnest. Das Profil zeigt pro Resource und pro Funktion, wie viel Zeit sie verbraucht hat. Zoome in die Spitzen hinein: Das sind deine Hitch-Verursacher.

Schritt 3: Haeufige Ursachen

• Datenbankabfragen ohne Index. Eine Abfrage wie SELECT * FROM users WHERE identifier = 'steam:xxx' auf einer Tabelle ohne Index auf identifier kann Dutzende Millisekunden pro Aufruf dauern. Fuege die passenden Indexes in deiner Datenbank hinzu.
• Synchrone Schleifen in Lua oder JavaScript. Eine while true do ohne Wait() blockiert den Thread permanent. Jede Schleife in serverseitigem Code braucht eine Wartezeit.
• Zu viele Exports pro Tick. Exports, die jeden Tick aufgerufen werden, statt gecacht oder eventbasiert zu sein, haeufen sich schnell an.
• Nicht optimierte Fahrzeug-YTDs. Custom-Fahrzeuge mit 4096px-Texturen, waehrend FiveM intern auf 1024px begrenzt. Der Server muss die Texturen an jeden Client streamen.
• Zu viele Resources gleichzeitig laden. Hundert Resources sind auf einem RP-Server ueblich, aber jedes Script, das beim Start Daten aus der Datenbank abruft, verursacht eine Spitze.

Schritt 4: Loesen

1. Entferne oder deaktiviere die schwerste Resource und pruefe, ob die Hitches aufhoeren.
2. Ersetze schlecht programmierte kostenlose Scripts durch optimierte Alternativen. Kostenpflichtige Scripts von bekannten Entwicklern sind oft besser optimiert.
3. Fuege Datenbank-Indexes hinzu. Der haeufigste: ALTER TABLE users ADD INDEX (identifier);
4. Fasse Datenbankabfragen zusammen, statt sie pro Spieler pro Sekunde auszufuehren.
5. Richte einen automatischen Neustart ueber txAdmin ein (alle 6 bis 12 Stunden), um Speicherlecks zu begrenzen.

Sind Hitch Warnings schaedlich fuer den Server?

Sie verursachen keinen permanenten Schaden, aber sie machen das Spielerlebnis schlecht. Bei wiederholten Hitches werden Spieler getrennt oder bleiben stecken.

Loest mehr RAM das Problem?

Meistens nicht. Hitch Warnings sind ein CPU-Problem (der Thread ist blockiert), kein Speicherproblem. Mehr RAM hilft nur, wenn der Server aktiv swappt.

Wie verhindere ich Hitches beim Starten?

Hitch Warnings beim Starten sind normal; alle Resources laden ihre Daten gleichzeitig. Es sind die Hitches waehrend des Spielens, die du loesen musst.

Die FiveM-Pakete von HostValues laufen auf Ryzen 9-CPUs mit hoher Single-Core-Taktfrequenz, was der Tick-Zeit direkt zugutekommt. Bei Performance-Fragen hilft unser Supportteam bei der Analyse deiner Profiler-Ausgabe.