Fehlerbehebung

#Der Server startet, aber nichts lädt

Datenbankverbindung prüfen. Ohne mysql_connection_string bricht der Core ab und alle Module warten vergeblich. Die Konsole sagt es beim Start; scrolle bis ganz nach oben.

Prüfe die Erreichbarkeit getrennt vom Server:

pnpm db:check

#Ein Modul meldet fehlende Abhängigkeit

Das Modul steht in der server.cfg vor dem Modul, das es braucht — meist vor 5mc_core. Reihenfolge korrigieren, siehe server.cfg. Welches Modul was voraussetzt, steht unter Alle Module.

#Änderungen an der Konfiguration wirken nicht

Konfigurationswerte landen beim Bauen im Bundle. Nach jeder Änderung:

node tools/build-resource.mjs resources/5mc_shops

Danach das Modul im Server neu starten. Ein reiner Neustart ohne Build ändert nichts.

#Whitelist lässt plötzlich jeden durch

Das ist Absicht. Bei Datenbankstörung lassen Whitelist, Sperrprüfung und Stummschaltung durch, statt zu blockieren, und schreiben es laut in die Konsole. Ein Datenbankausfall soll keinen Serverausfall auslösen.

Wenn du das bemerkst, ist die Datenbank das Problem — nicht die Whitelist. Prüfe die Verbindung, bevor du an den Einstellungen drehst.

#Zwei Prüfungen beim Verbinden greifen nicht

FiveM erlaubt ein Deferral pro Verbindung, nicht eines pro Ressource. Nur die erste Antwort zählt. Deshalb hält im Framework allein die Warteschlange die Verbindung, und die Sperrprüfung liefert ihr Ergebnis über den Admin-Provider zu.

Wenn du eigene Prüfungen an playerConnecting hängst, läufst du in genau dieses Problem. Häng dich stattdessen an den vorhandenen Weg.

#Eine Oberfläche bleibt schwarz

Zwei häufige Ursachen:

• Hintergrundfarbe gesetzt. Eine NUI liegt über dem Spiel. Setzt das Dokument einen Hintergrund, verdeckt er den Bildschirm.
• backdrop-filter verwendet. In der Chromium-Einbettung von FiveM rendert er über transparentem Grund als schwarzer Kasten.

Beides steht unter Design-Tokens.

#Bilder oder Banner kommen beschädigt an

Das Bildmodul liefert Dateien über einen eigenen Port aus, weil der FXServer Ressourcendateien nicht selbst per HTTP ausliefert und Binärdaten sonst durch die Textkodierung beschädigt werden. Prüfe, ob Port 30121 erreichbar ist und nicht von einem Reverse-Proxy umgeschrieben wird.

#Neustart aus der Konsole geht nicht

Unter txAdmin ist klassisches RCON blockiert. Nutze die Konsole in txAdmin oder, im Entwicklungsbetrieb, die Dev-Brücke:

node tools/serverctl.mjs restart 5mc_inventory

Die Dev-Brücke gehört nicht auf einen Produktivserver.

#Es bleibt unklar

Schreib uns im Discord. Hilfreich sind: welches Modul, welcher Schritt, die Konsolenausgabe von oben bis zur ersten Fehlermeldung und ob es vor einem Update schon so war.