> For the complete documentation index, see [llms.txt](https://docs.instantroot.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.instantroot.de/gameserver/fivem/server.cfg-verstehen-und-bearbeiten.md). # Server.cfg verstehen und bearbeiten Die `server.cfg` ist eine der wichtigsten Dateien deines FiveM Servers. In dieser Datei legst du grundlegende Einstellungen fest, startest Ressourcen und hinterlegst wichtige Werte wie Servername, Slots, License Key oder Datenbankverbindung. Wenn dein FiveM Server nicht startet, nicht in der Serverliste erscheint oder bestimmte Ressourcen nicht geladen werden, liegt die Ursache häufig in der `server.cfg`. ### Was ist die server.cfg? Die `server.cfg` ist die zentrale Konfigurationsdatei deines FiveM Servers. Dort wird festgelegt: * unter welchem Namen dein Server angezeigt wird * wie viele Spieler verbinden können * welche Ressourcen beim Start geladen werden * welcher License Key verwendet wird * welche Tags und Beschreibungen angezeigt werden * ob bestimmte Funktionen aktiviert oder deaktiviert sind * wie sich der Server mit einer Datenbank verbindet Die Datei wird beim Start des Servers geladen. Änderungen an der `server.cfg` werden deshalb meistens erst nach einem Neustart aktiv. ### Wo finde ich die server.cfg? Du findest die `server.cfg` im Dateimanager deines FiveM Servers im INSTANTPANEL. Je nach Serverstruktur liegt die Datei häufig im Hauptverzeichnis deines Servers oder in einem Konfigurationsordner. Typische Speicherorte sind: * `server.cfg` * `/home/container/server.cfg` * `/txData/default/server.cfg` * `/txData/[Profilname]/server.cfg` Wenn du txAdmin verwendest, kann die aktive `server.cfg` in einem txAdmin-Profilordner liegen. Achte deshalb darauf, wirklich die Datei zu bearbeiten, die dein Server beim Start verwendet. ### server.cfg bearbeiten Gehe so vor: 1. Öffne das INSTANTPANEL. 2. Wähle deinen FiveM Server aus. 3. Öffne den Dateimanager. 4. Suche die Datei `server.cfg`. 5. Öffne die Datei im Editor. 6. Nimm die gewünschten Änderungen vor. 7. Speichere die Datei. 8. Starte den Server neu. **Wichtig:** Erstelle vor größeren Änderungen ein Backup der Datei. So kannst du bei Fehlern schnell zur vorherigen Version zurückkehren. ### Aufbau der server.cfg Eine `server.cfg` besteht aus einzelnen Befehlen und Einstellungen. Ein einfacher Eintrag sieht zum Beispiel so aus: `sv_hostname "Mein FiveM Server"` Der erste Teil ist der Befehl oder die Einstellung. Der zweite Teil ist der Wert. Bei Texten werden häufig Anführungszeichen verwendet. Beispiel: | Bestandteil | Bedeutung | | --------------------- | ------------------------------- | | `sv_hostname` | Einstellung für den Servernamen | | `"Mein FiveM Server"` | angezeigter Name des Servers | ### Kommentare verwenden Kommentare sind Zeilen, die nicht ausgeführt werden. Sie dienen nur als Notiz oder Erklärung. In der `server.cfg` werden Kommentare meistens mit `#` geschrieben. Beispiel: `# Das ist ein Kommentar` Du kannst Kommentare nutzen, um deine Konfiguration übersichtlicher zu machen. Beispiel: `# Servername und Beschreibung` `sv_hostname "Mein FiveM Roleplay"` ### Wichtige Einstellungen In der `server.cfg` gibt es einige Einstellungen, die besonders häufig verwendet werden. | Einstellung | Bedeutung | | ----------------------------- | ------------------------------- | | `sv_hostname` | Name des Servers | | `sets sv_projectName` | Projektname in der Serverliste | | `sets sv_projectDesc` | Beschreibung in der Serverliste | | `sv_maxclients` | maximale Spieleranzahl | | `sv_licenseKey` | FiveM License Key | | `ensure` | startet eine Ressource | | `set mysql_connection_string` | Datenbankverbindung | | `sets tags` | Tags für die Serverliste | | `locale` | Sprache oder Region | | `endpoint_add_tcp` | TCP-Portbindung | | `endpoint_add_udp` | UDP-Portbindung | ### Servername ändern Der Servername wird mit `sv_hostname` gesetzt. Beispiel: `sv_hostname "INSTANTROOT FiveM Server"` Nach dem Speichern musst du den Server neu starten. Der Name wird anschließend im FiveM Client und teilweise auch in der Serverliste angezeigt. ### Projektname und Beschreibung ändern Für die Serverliste werden häufig zusätzlich Projektname und Beschreibung verwendet. Beispiel: `sets sv_projectName "INSTANTROOT Roleplay"` `sets sv_projectDesc "Deutscher FiveM Roleplay Server"` Der Projektname ist eine kurze Bezeichnung. Die Beschreibung kann etwas genauer erklären, worum es auf dem Server geht. ### Maximale Spieleranzahl ändern Die maximale Spieleranzahl wird über `sv_maxclients` festgelegt. Beispiel: `sv_maxclients 32` Der Wert legt fest, wie viele Spieler gleichzeitig auf deinen Server verbinden können. **Hinweis:** Setze die Spielerzahl realistisch. Mehr Slots bedeuten nicht automatisch, dass der Server stabil mit so vielen Spielern läuft. Die tatsächliche Leistung hängt von Ressourcen, Scripts, Fahrzeugen, Datenbank und Serverauslastung ab. ### FiveM License Key eintragen Damit ein FiveM Server korrekt funktioniert, wird ein License Key benötigt. Der Eintrag sieht so aus: `sv_licenseKey "dein_license_key"` Achte darauf, den Key vollständig und ohne zusätzliche Leerzeichen einzutragen. **Wichtig:** Gib deinen License Key nicht öffentlich weiter. Der Key gehört zu deinem Server und sollte nicht in Screenshots, öffentlichen Logs oder Supportanfragen sichtbar sein. ### Ressourcen starten Ressourcen werden in FiveM über `ensure` gestartet. Beispiel: `ensure chat` `ensure spawnmanager` `ensure sessionmanager` `ensure hardcap` `ensure mysql-async` `ensure mein_script` Der Name hinter `ensure` muss exakt dem Ordnernamen der Ressource entsprechen. Beispiel: Wenn der Ressourcenordner so heißt: `mein-polizei-script` Dann muss der Eintrag so aussehen: `ensure mein-polizei-script` ### Unterschied zwischen ensure und start In älteren Konfigurationen wird häufig `start` verwendet. Beispiel: `start mein_script` Heute wird meistens `ensure` empfohlen. `ensure` sorgt dafür, dass eine Ressource gestartet wird und bei Bedarf wieder gestartet werden kann, falls sie gestoppt wurde. Für neue Einträge solltest du in der Regel `ensure` verwenden. ### Reihenfolge von Ressourcen Die Reihenfolge in der `server.cfg` ist wichtig. Manche Ressourcen benötigen andere Ressourcen, bevor sie starten können. Beispiel: * zuerst Framework * dann Datenbankressource * dann Abhängigkeiten * danach eigene Scripts Eine typische Reihenfolge kann so aussehen: 1. Grundressourcen 2. Datenbankressource 3. Framework, zum Beispiel ESX oder QBCore 4. Abhängigkeiten 5. Jobs, Systeme und Scripts 6. Maps, Fahrzeuge und Kleidung Wenn eine Ressource vor ihrer Abhängigkeit startet, kann sie Fehler verursachen oder nicht funktionieren. ### Datenbankverbindung eintragen Viele FiveM Server verwenden eine Datenbank, besonders Roleplay-Server mit ESX oder QBCore. Die Datenbankverbindung wird meistens über einen Connection String gesetzt. Beispiel: `set mysql_connection_string "mysql://benutzer:passwort@host/datenbank?charset=utf8mb4"` Die Werte müssen zu deiner Datenbank passen. | Bestandteil | Bedeutung | | ----------------- | ---------------------------------------- | | `benutzer` | Datenbankbenutzer | | `passwort` | Passwort des Datenbankbenutzers | | `host` | Datenbankserver | | `datenbank` | Name der Datenbank | | `charset=utf8mb4` | Zeichensatz für Sonderzeichen und Emojis | **Wichtig:** Wenn dein Datenbankpasswort Sonderzeichen enthält, kann es sein, dass der Connection String angepasst werden muss. Prüfe bei Datenbankfehlern immer zuerst Benutzername, Passwort, Host und Datenbankname. ### Tags setzen Tags helfen dabei, den Server in der FiveM Serverliste einzuordnen. Beispiel: `sets tags "german, roleplay, esx, economy"` Verwende passende Tags und vermeide falsche oder irreführende Angaben. ### Sprache und Region setzen Je nach Konfiguration kannst du eine Sprache oder Region setzen. Beispiel: `sets locale "de-DE"` Das hilft Spielern, deinen Server besser einzuordnen. ### Ports und Endpoints In vielen FiveM-Konfigurationen findest du Einträge wie: `endpoint_add_tcp "0.0.0.0:30120"` `endpoint_add_udp "0.0.0.0:30120"` Diese Einträge legen fest, auf welchem Port der Server Verbindungen annimmt. Der Standardport für FiveM ist häufig `30120`. **Wichtig:** Ändere diese Werte nur, wenn du genau weißt, was du tust oder der Support dich dazu auffordert. Falsche Portwerte können dazu führen, dass dein Server nicht mehr erreichbar ist. ### OneSync OneSync ist eine wichtige FiveM-Funktion für moderne Server. Je nach Serverkonfiguration kann OneSync über die Konfiguration oder über txAdmin verwaltet werden. Typische Einträge können sein: `set onesync on` oder: `set onesync legacy` oder: `set onesync infinity` Welche Einstellung sinnvoll ist, hängt von deinem Server, deinen Scripts und deiner FiveM-Version ab. ### Icon und Banner Einige Server verwenden eigene Bilder für die Darstellung in der Serverliste. Je nach Konfiguration können dafür Dateien und Einträge in der `server.cfg` genutzt werden. Beispiel: `load_server_icon logo.png` Die Datei muss im richtigen Verzeichnis liegen und korrekt benannt sein. ### sv\_scriptHookAllowed Mit `sv_scriptHookAllowed` wird festgelegt, ob ScriptHook erlaubt ist. Beispiel: `sv_scriptHookAllowed 0` Für öffentliche Roleplay-Server sollte ScriptHook in der Regel deaktiviert sein. | Wert | Bedeutung | | ---- | ---------------------- | | `0` | ScriptHook deaktiviert | | `1` | ScriptHook aktiviert | **Wichtig:** Aktiviere ScriptHook nur, wenn du genau weißt, warum du es brauchst. Auf öffentlichen Servern kann es ein Sicherheitsrisiko darstellen. ### RCON RCON ermöglicht entfernte Serverbefehle. Wenn RCON verwendet wird, sollte ein sicheres Passwort gesetzt werden. Beispiel: `rcon_password "sehr_sicheres_passwort"` **Wichtig:** Verwende kein einfaches Passwort und veröffentliche den RCON-Zugang niemals. Wer Zugriff auf RCON hat, kann administrative Befehle ausführen. ### Beispielstruktur einer server.cfg Eine einfache Struktur kann so aussehen: | Bereich | Beispiel | | ------------ | ------------------------------------------------------------------------- | | Netzwerk | `endpoint_add_tcp "0.0.0.0:30120"` | | Netzwerk | `endpoint_add_udp "0.0.0.0:30120"` | | Servername | `sv_hostname "Mein FiveM Server"` | | Beschreibung | `sets sv_projectDesc "Deutscher Roleplay Server"` | | Slots | `sv_maxclients 32` | | License Key | `sv_licenseKey "dein_license_key"` | | Datenbank | `set mysql_connection_string "mysql://user:pass@host/db?charset=utf8mb4"` | | Ressource | `ensure chat` | | Ressource | `ensure mein_script` | ### Häufige Fehler in der server.cfg #### Fehlende Anführungszeichen Texte sollten häufig in Anführungszeichen stehen. Falsch: `sv_hostname Mein FiveM Server` Besser: `sv_hostname "Mein FiveM Server"` #### Falscher Ressourcenname Der Name bei `ensure` muss exakt dem Ordnernamen entsprechen. Wenn der Ordner `policejob` heißt, muss auch `ensure policejob` eingetragen werden. #### Ressource liegt im falschen Ordner Ressourcen müssen im richtigen `resources`-Ordner liegen. Wenn eine Ressource nicht gefunden wird, prüfe: * liegt der Ordner im richtigen Verzeichnis? * ist die Ressource entpackt? * gibt es keine doppelte Unterordnerstruktur? * stimmt der Name in der `server.cfg`? #### Doppelte Einträge Doppelte oder widersprüchliche Einträge können Probleme verursachen. Beispiel: `sv_maxclients 32` und später: `sv_maxclients 64` In diesem Fall kann unklar sein, welcher Wert aktiv ist. Halte deine Datei sauber und entferne alte Einträge. #### Falscher License Key Ein falscher oder fehlender License Key kann dazu führen, dass der Server nicht korrekt startet oder nicht sichtbar ist. Prüfe: * Key vollständig kopiert? * keine Leerzeichen? * richtige IP bei der Key-Erstellung verwendet? * Key nicht abgelaufen oder gesperrt? #### Fehlerhafte Datenbankverbindung Wenn ESX, QBCore oder andere Ressourcen Datenbankfehler anzeigen, prüfe: * Datenbankhost * Benutzername * Passwort * Datenbankname * importierte SQL-Dateien * verwendete MySQL-Ressource, zum Beispiel `oxmysql` #### Falsche Startreihenfolge Wenn Ressourcen Abhängigkeiten benötigen, müssen diese vorher gestartet werden. Beispiel: `ensure oxmysql` `ensure es_extended` `ensure esx_policejob` Hier muss `oxmysql` vor ESX starten, und ESX vor den ESX-Jobs. ### Nach Änderungen immer neu starten Viele Änderungen in der `server.cfg` werden erst nach einem Neustart aktiv. Nach dem Speichern solltest du deshalb: 1. Server stoppen. 2. Einige Sekunden warten. 3. Server wieder starten. 4. Konsole prüfen. 5. Fehler oder Warnungen beachten. Ein einfacher Neustart reicht meistens aus. Bei größeren Problemen ist ein kompletter Stop-und-Start oft sauberer. ### Konsole nach Fehlern prüfen Nach jeder Änderung solltest du die Konsole prüfen. Achte besonders auf Meldungen wie: * `Couldn't find resource` * `Failed to load resource` * `Access denied` * `You lack the required entitlement` * `sv_licenseKey was not specified` * `Could not connect to database` * `Error parsing script` * `No such export` * `Started resource` * `Stopping resource` Nicht jede Warnung ist kritisch. Wiederkehrende Fehler sollten aber geprüft werden. ### Schritt-für-Schritt: Änderung sicher testen Wenn du eine Änderung an der `server.cfg` vornehmen möchtest, gehe so vor: 1. Backup der aktuellen `server.cfg` erstellen. 2. Nur eine Änderung durchführen. 3. Datei speichern. 4. Server neu starten. 5. Konsole prüfen. 6. Funktion testen. 7. Erst danach die nächste Änderung durchführen. Ändere nicht zu viele Dinge gleichzeitig. Sonst ist später schwer erkennbar, welche Änderung ein Problem verursacht hat. ### Server startet nach Änderung nicht mehr Wenn der Server nach einer Änderung nicht mehr startet, gehe so vor: 1. Öffne die Konsole. 2. Prüfe die letzte Fehlermeldung. 3. Öffne die `server.cfg`. 4. Mache die letzte Änderung rückgängig. 5. Prüfe Anführungszeichen und Schreibweise. 6. Speichere die Datei. 7. Starte den Server neu. Wenn du ein Backup erstellt hast, kannst du die vorherige Version wiederherstellen. ### Server wird nicht in der Liste angezeigt Wenn dein Server läuft, aber nicht in der FiveM Serverliste sichtbar ist, prüfe: * ist der License Key korrekt? * ist der Server vollständig gestartet? * ist `sv_hostname` gesetzt? * sind Ports korrekt? * ist der Server direkt per IP erreichbar? * blockiert eine fehlerhafte Ressource den Start? * wurde der Server gerade erst gestartet? Die Serverliste kann etwas Zeit benötigen. Teste zusätzlich immer die direkte Verbindung.