server.cfg erklärt: Jede Zeile in der FiveM server.cfg, Zeile für Zeile

Du hast server.cfg geöffnet und siehst eine Wand aus Zeilen, die du aus einem Rezept kopiert hast. Diese Anleitung geht durch die Zeilen, die du in den meisten Servern findest, in der Reihenfolge, in der sie normalerweise erscheinen, mit einer kurzen Erklärung und einem Link zu einer ausführlicheren Anleitung.

#Endpoints

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Dies sind die Adresse und der Port, auf denen der Server lauscht. 0.0.0.0 bedeutet jede Netzwerkschnittstelle, und 30120 ist der Standardport. Spieler verbinden sich über UDP und verwenden TCP für HTTP und den txAdmin-Proxy, also öffnest du beide in deiner Firewall. Mit txAdmin werden die Schnittstelle und der Port normalerweise für dich verwaltet, und die txAdmin-Einstellungen können beschwerde, wenn sie nicht übereinstimmen. Wenn Spieler von außen nicht beitreten können, siehe Port-Weiterleitung.

#Name und Listing

sv_hostname "My Server"
sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay, esx, english"
sets locale "en-US"
load_server_icon myLogo.png

• sv_hostname ist der ältere Servername.
• sv_projectName und sv_projectDesc sind der Name und die Beschreibung in der Serverliste. Das sets-Formular veröffentlicht sie.
• tags sind die Schlüsselwörter, nach denen Spieler filtern, und locale ist die Sprache.
• load_server_icon lädt ein kleines PNG aus dem Serverordner.

Farben, Banner und die Symbolgröße werden in Server-Symbol, Banner und Tags behandelt.

#Spieler

sv_maxclients 48

Die Anzahl der Spielerplätze. Über 48 erfordert OneSync und einen Supporter-Tier auf der Cfx.re-Seite. Die Details finden sich in OneSync und das Spielerlimit.

#Schlüssel

sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"
set steam_webApiKey "none"

sv_licenseKey ist der Schlüssel aus dem Cfx.re-Portal, und der Server startet ohne einen gültigen nicht. Siehe Server-Lizenzschlüssel-Fehler. steam_webApiKey wird nur benötigt, wenn du Steam-Identifikatoren haben möchtest, und none wird akzeptiert, wenn du es nicht möchtest. Beide Zeilen sind Geheimnisse: teile deine server.cfg nicht in Screenshots.

#Datenbank

set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

Die Verbindungszeichenfolge, die oxmysql liest. Falsche Werte geben die Fehler in oxmysql-Verbindungsfehler. Verwende set, nicht setr oder sets, damit das Passwort auf dem Server bleibt.

#OneSync und Game Build

set onesync on
sv_enforceGameBuild 3258

onesync on schaltet OneSync ein, das ist der Standard für moderne Server und wird für viele Plätze benötigt. sv_enforceGameBuild zwingt Clients, einen Game Build zu verwenden, und DLC-Autos, Kleidung und Karten benötigen eine aktuelle. Die Build-Nummern und was sie freigeben, findest du in sv_enforceGameBuild und DLC. Verwende eine Build-Nummer, die von deinen Artifacts unterstützt wird, nicht nur die in diesem Beispiel.

#Ressourcen: ensure

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [standalone]

Jedes ensure startet eine Ressource oder einen ganzen Bracket-Ordner. Die Reihenfolge ist wichtig: Datenbanken, Bibliotheken und das Framework zuerst. Siehe server.cfg ensure-Reihenfolge. Wenn eines fehlschlägt, erklärt Ressource konnte nicht gestartet werden die Meldung.

#Berechtigungen: add_ace und add_principal

add_ace group.admin command allow
add_principal identifier.fivem:1234567 group.admin

add_ace gibt einer Gruppe eine Berechtigung, hier jeden Befehl. add_principal setzt einen Spieler (nach Identifizierung) in diese Gruppe. Ersetze den Identifizierer durch deinen eigenen. Die vollständige Erklärung, mit dem Unterschied zwischen ACE und den eigenen Gruppen deines Frameworks, findest du in ACE-Berechtigungen.

#Einschließen anderer Dateien: exec

exec permissions.cfg
exec resources.cfg

exec führt eine andere cfg-Datei aus, als ob ihre Zeilen hier wären. Das Aufteilen von Berechtigungen oder Ressourcen in ihre eigenen Dateien hält server.cfg lesbar, und du kannst die Geheimnisse in einer Datei behalten, die du nie teilst.

#Ein minimales Beispiel

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_licenseKey "cfxk_..."
sv_hostname "My Server"
sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay"
sets locale "en-US"
load_server_icon myLogo.png
sv_maxclients 48
set onesync on
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended

Achtung: Ein Tippfehler in einer Zeile stoppt den Server nicht immer. Ein falsch geschriebenes convar wird stillschweigend erstellt und tut nichts. Wenn eine Einstellung zu ignoriert werden scheint, überprüfe zunächst die Rechtschreibung.

#Checkliste