Schnelle Antwort: Beginne mit dem offiziellen Cfx.re-Beispiel, ändere nur das Endpunkt, die Projektfelder, die Slot-Grenze, den Server-Registrierungsschlüssel und die explizite Ressourcenliste, dann validiere in txAdmin und teste eine direkte Verbindung. Bewahre eine bekannte, funktionierende Kopie vor jeder Änderung auf.
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sets sv_projectName "Mein Server"
sets sv_projectDesc "Eine klare Ein-Satz-Beschreibung"
sv_hostname "Mein Server"
set onesync on
sv_maxclients 48
sv_licenseKey "ersetze_mit_portal_schlüssel"
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcapSicherheitsgrenze: sv_endpointDatenschutz Versteckt Spieler-IPs in öffentlichen Berichten; es bietet keinen DDoS-Schutz oder verschleiert den Server-Origin. Deaktiviere RCon, es sei denn, es ist explizit erforderlich, und veröffentliche niemals echte Lizenzen, Datenbank-, Steam-, Tebex- oder Webhook-Geheimnisse.
Der server.cfg file ist das Herz jedes FiveM-Servers. Es definiert, wie dein Server läuft: Slots, Netzwerk, Spielversion, OneSync, Protokollierung und Sichtbarkeit in der Serverliste. Dieser Leitfaden ist für Serverbesitzer und Entwickler die sichere Standardeinstellungen, Produktionshärtung und Leistungsbestpraktiken wünschen. Mach immer Backups und nutze Versionskontrolle. Wenn du neu bist, starte mit unserem Wie man einen FiveM-Server erstellt. Für tiefere Optimierungen, siehe unseren Leistungszentrum.
TL;DR: Produktionsreife Baseline (kommentiert)
Eine saubere server.cfg ist die Grundlage der Stabilität. Nachfolgend zwei Beispiele: ein minimaler Entwicklerkonfiguration und ein gehärtete Produktionskonfiguration.
Minimale Entwicklerkonfiguration
# server.cfg (Entwicklung) # Grundkonfiguration für lokales Testen # Netzwerk endpoint_add_tcp "0.0.0.0:30120" # TCP-Port-Bindung endpoint_add_udp "0.0.0.0:30120" # UDP-Port-Bindung # Server-Info sv_hostname "Mein Dev-Server" sv_maxclients 8 # OneSync set onesync on # Ressourcen (Grundbeispiel) ensure mapmanager ensure chat ensure spawnmanager ensure sessionmanager ensure hardcap ensure baseevents # Berechtigungen (Standard-ACL) exec permissions.cfg
Gehärtete Produktionskonfiguration
# server.cfg (Produktion) # Netzwerk endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" # Sicherheit sv_endpointPrivacy true # Versteckt Spieler-IP-Adressen in öffentlichen Serverberichten; es versteckt nicht den Server-Origin sv_scriptHook 0 # Deaktiviere Client-Modifikationen # Rcon_password nicht setzen, es sei denn, Legacy RCon ist explizit erforderlich # Slots sv_maxclients 64 # An Host-Kapazität anpassen # Spielversion (verwende die neueste empfohlene) # Optional: Pinne eine dokumentierte Spielversion nur, wenn deine Ressourcen sie erfordern # Projektinfo sv_hostname "FIVEMX Roleplay | Serious RP" sets sv_projectName "FIVEMX RP Server" sets sv_projectDesc "Realistischer RP mit QBCore & benutzerdefinierten Skripten" sets tags "roleplay, seriousrp, qbcore" sets locale "en-US" load_server_icon mylogo.png sets banner_detail "https://cdn.example.com/banner.png" sets banner_connecting "https://cdn.example.com/loading.png" # OneSync set onesync on # Ressourcen (verwende Ressourcenliste) exec resources.cfg # Protokollierung & ACL set sv_logLevel 2 exec permissions.cfg # txAdmin-Integration # Lade Framework/Datenbank-Konfiguration aus einer separat berechtigten Konfiguration; veröffentliche keine echten Anmeldedaten
Tipp: Validiere deine Konfiguration nach Änderungen immer mit txAdmin-Gesundheitsprüfungen und Konsolenprotokollen. Siehe txAdmin-Protokolle.
Serverinformationen und -liste
Die folgenden Convars steuern, wie Ihr Server in der Server-Browser und API:
| Convar | Zweck | Beispiel | Wann ändern | Vorbehalte |
|---|---|---|---|---|
sv_hostname | Öffentlicher Name in der Serverliste | sv_hostname "Mein RP-Server [EN]" | Immer eingestellt | Vermeide Sonderzeichen, halte es klar |
legt sv_projectName fest | Interner Projektanzeigename | setzt sv_projectName "MyCommunityRP" | Branding, Multi-Server-Setups | Nur in der Listen-Benutzeroberfläche sichtbar |
legt sv_projectDesc fest | Beschreibung in der Liste angezeigt | setzt sv_projectDesc "QBCore RP Server" | Regeln, Sprache und Funktionen hinzufügen | Halte es unter 100 Zeichen |
setzt Tags | Serverlisten-Tags | setzt Tags „Rollenspiel, Autos, QBCore“ | Verbessere die Auffindbarkeit | Verwende nur offizielle Tags |
legt das Gebietsschema fest | Standardsprache | setzt das Gebietsschema „en-US“ | Serversprache anpassen | Falsches Gebietsschema kann den Server verbergen |
sv_endpointDatenschutz | Öffentliche IP im Browser verbergen | sv_endpointPrivacy true | Empfohlen für die Produktion | Spieler verbinden sich über Cfx-Relay |
Serversymbol laden | 96×96 PNG-Symbol | load_server_icon mylogo.png | Für das Branding | Muss quadratisch sein, <96×96 Pixel |
setzt banner_detail | Großes Banner in der Serverliste | setzt banner_detail "url" | Optional, aber empfohlen | Muss eine HTTPS-URL sein |
setzt banner_connecting | Beim Verbinden angezeigtes Banner | setzt banner_connecting "url" | Gut zum Branding/Laden | Verwende CDN, um Lags zu vermeiden |
Sieh dir die offiziellen Cfx.re-Serverbefehl und ConVar-Referenz für die aktuelle Syntax und das Verhalten.
Vernetzung & Slots
FiveM-Server verwenden TCP/UDP-EndpunkteStandardmäßig ist Port 30120 verwendet wird.
endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" sv_maxclients 64
- Führe mehrere Server auf einem Gerät aus mit Port-Offsets: zB
30121,30122. - Passe Firewall-Regeln an, um TCP/UDP-Ports zu öffnen.
sv_maxclientsBeeinflusst direkt CPU- & RAM-Nutzung — setze nicht höher, als dein Hardware es schafft. Server-Hosting-Anbieter anzeigen
Warnung: Mache MySQL- oder RCON-Ports nicht für das Internet zugänglich.
Spielaufbau und Artefakte
Eine FXServer-Artifact-Version und eine GTA V-Spielversion sind separate Entscheidungen. Aktualisiere Artifacts über den empfohlenen Cfx.re-Pfad; setze sv_enforceGameBuild nur, wenn der Server dokumentierte GTA-Inhalte benötigt, und überprüfe den Wert gegen die aktuelle Cfx.re-Befehlsreferenz.
# Optionale Einstellung nur zum Starten; wähle einen Wert aus der aktuellen Cfx.re-Referenz # sv_enforceGameBuild
- [Offizielles Convars-Dokument][1] listet gültige Buildnummern auf.
- Eingebautes Set
server.cfgoder in txAdmin → Einstellungen → FXServer → Zusätzliche Argumente:
+set sv_enforceGameBuild 2944
- Lade die neueste Version herunter Artefakte von [runtime.fivem.net][4] (Windows) oder der Linux-Build-Seite.
- Mische niemals Client- und Server-Builds.
OneSync-Konfiguration
OneSync ermöglicht serverseitige Entitätssynchronisierung: mehr Spieler, genauere Zustände, besseres Streaming. Verwende immer OneSync ein für moderne Frameworks (QBCore, ESX).
| Einstellung | Wirkung | Typischer Wert | Auswirkungen auf CPU/Speicher | Dokumente |
onesync | Aktiviert OneSync | An | Höhere CPU-Auslastung | [OneSync-Dokumente][3] |
onesync_population | Steuert lokale NPCs/Verkehr | An (optional) | Erhöht die CPU-Last | [OneSync-Dokumente][3] |
onesync_distanceCullVehicles | Fahrzeuge effizient streamen | WAHR | Bessere Leistung, spart Bandbreite | [OneSync-Dokumente][3] |
Tipp: Skala
sv_maxclientsmit Hardware. Verwenden Resmon-Führer um die Auswirkungen auf die Ressourcen zu messen.
Startreihenfolge und Abhängigkeiten von Ressourcen
Die Ressourcen werden in der von sicherstellen. Starte immer Abhängigkeiten zuerst.
# resources.cfg (geteilte Datei) oxmysql sicherstellen qb-core sicherstellen qb-adminmenu sicherstellen qb-inventory sicherstellen qb-policejob sicherstellen my-custom-scripts
In server.cfg:
exec resources.cfg
- Behalte Frameworks und DB-Connector zuerst.
- Gruppenbezogene Ressourcen.
- Vermeiden
sicherstellen *in der Produktion; es verursacht eine nichtdeterministische Ordnung.
Sicherheit und Missbrauchshärtung
Eine sichere server.cfg verhindert Lecks und Missbrauch.
Checkliste:
sv_endpointPrivacy truesv_scriptHook 0(Client-Mods blockieren)- Stark oder behindert
rcon_password - Verwenden
Hauptbenutzer hinzufügenUndadd_acefür ACLs - Halte Geheimnisse aus öffentlichen Repositories und Client/Shared-Resource-Dateien fern; beschränke den Zugriff auf die server-eigene Konfiguration, die sie enthält
- Aktualisiere Artefakte regelmäßig
- Monitor txAdmin-Protokolle
- Verwenden Resmon-Führer um schwere Skripte zu erfassen
ACL-Beispiel:
add_ace group.admin-Befehl erlaubt add_principal identifier.steam:110000112345678 group.admin
CDN und Asset-Streaming (wann verwenden)
Für große MLOs, benutzerdefinierte Autos und Texturen, verwende einen CDN, um Beitrittszeiten.
- Hoste Dateien auf einem CDN wie Cloudflare R2 (setze [CORS-Header][6]).
- Für hohe Leistung unterstützt BunnyCDN [Bereichsanfragen][7] (erforderlich für
.rpfStreaming). - Füge versionierte URLs hinzu, um Cache-Konflikte zu vermeiden.
Sieh dir unseren Ladezeiten optimieren Führung.
Mythen und veraltete Flaggen
Viele Konfigurationen online zeigen immer noch Quell-Engine-Cvars wie:
sv_maxrate 0 sv_minrate 30000 sv_maxupdaterate 60
Nicht verwenden. Diese werden in FiveM nicht unterstützt und haben keine Wirkung. Siehe [offizielle Convars][1].
Veraltete/alte Convars:
sv_master1→ nicht mehr benötigt.sv_useDirectListing→ ersetzt durchsv_endpointDatenschutz.
Validierung und Fehlerbehebung
Schlüsselprüfungen nach der Bearbeitung server.cfg:
| Symptom | Wahrscheinliche Ursache | Fix | Zeit |
| Server startet nicht | Syntaxfehler in der Konfiguration | Konsole prüfen, ungültige Zeilen entfernen | 5 m |
| Nicht in der Serverliste | Fehlen sv_hostname/Tags | Hostnamen/Tags hinzufügen, Firewall prüfen, sv_master1 | 10 m |
| Spieler können keine Verbindung herstellen | Ports geschlossen / falsche IP | Öffne 30120 TCP+UDP, überprüfe Endpunkt_hinzufügen_* | 15 m |
| Hohe CPU-Auslastung | Zu viele Slots / schlechte Skripte | Untere sv_maxclients, verwenden Leistungsoptimierung | 20 m |
| Lange Ladezeiten | Große Vermögenswerte nicht optimiert | Verwenden Ladezeiten optimieren + CDN | 20 m |
| Abstürze nach dem Update | Build-Nichtübereinstimmung | Stift sv_enforceGameBuild, aktualisiere [Artefakte][4] | 15 m |
Entdecke vollständige Server-Produkte für Starts und Neuaufbauten.
Interne Ressourcen und nächste Schritte
Häufig gestellte Fragen
1. Was ist server.cfg in FiveM?
Es handelt sich um die Hauptkonfigurationsdatei, die Servername, Slots, Ressourcen, Netzwerk, Sicherheit und Sichtbarkeit definiert.
2. Wo soll ich platzieren server.cfg?
Innerhalb deines Server-Ordners (neben server.exe oder FXServer Einstiegspunkt). txAdmin lädt es automatisch.
3. Was ist der Unterschied zwischen Satz, Sätze, Und setr?
Satz: Nur-Server-Variable.Sätze: wird in der Serverliste angezeigt (öffentliche Informationen).setr: mit Clients synchronisiert.
4. Mein Server wird nicht in der Liste angezeigt. Warum?
Überprüfen sv_hostname, setzt Tags, legt das Gebietsschema fest, Und sv_endpointDatenschutz. Stelle auch sicher, dass deine Ports offen sind.
5. Wie erhöhe ich die Anzahl der Spielerplätze?
Ändern sv_maxclients. Skaliere schrittweise und überwache mit Resmon-Führer. Stelle sicher, dass deine Hardware und dein Netzwerk damit zurechtkommen.
6. Was ist sv_enforceGameBuild?
Eine Convar, die Clients zwingt, eine bestimmte GTA V-Version zu verwenden. Verhindert Abstürze durch nicht übereinstimmende Versionen. Siehe [Convars-Dokument][1].
7. Soll ich Build-Nummern oder Aliase verwenden?
Beides funktioniert. Numerisch (2944) ist explizit; Alias (mp2024_02) ist einfacher zu verfolgen. Beide werden unterstützt.
8. Wo stelle ich ein sv_enforceGameBuild in txAdmin?
In txAdmin → Einstellungen → FXServer → Zusätzliche Argumente. Beispiel: +set sv_enforceGameBuild 2944.
9. Was ist OneSync?
Ein System, das mehr Spieler, präzises Entity-Streaming und Server-Autorität ermöglicht. Erforderlich für moderne Frameworks. Siehe [OneSync-Dokumente][3].
10. Infinity vs. Legacy OneSync?
Legacy = bis zu 64 Slots. Infinity = unterstützt 128+, erweiterte Entity-Synchronisation. Verwende immer Onesync ein (Standardmäßig unendlich).
11. Wie organisiere ich Ressourcen?
Verwenden exec resources.cfg. Starte DB-Connector zuerst, dann Frameworks, dann Jobs/Skripte. Vermeide sicherstellen *.
12. Meine Banner werden nicht in der Serverliste angezeigt.
Stelle sicher, dass die URLs HTTPS sind, öffentlich und auf die richtigen Bildgrößen zeigen. Verwende einen CDN für Zuverlässigkeit.
13. Wozu dienen die txAdmin-Protokolle?
Sie zeigen Fehler, Abstürze, Ressourcenprobleme. Siehe txAdmin-Protokolle.
14. Wie überprüfe ich Leistungsprobleme?
Verwenden Antwort 1 in der Konsole. Siehe unsere Resmon-Führer für Details.
15. Werden Source Engine Rate Flags benötigt?
NEIN. sv_maxrate, sv_minrate, sv_maxupdaterate tu nichts in FiveM. Verwende stattdessen [Convars doc][1].
Credits:
- [Convars – Cfx.re-Dokumente][1]
- [Serverbefehle – Cfx.re-Dokumente][2]
- [OneSync – Cfx.re-Dokumente][3]
- [Artefakte (Windows-Builds) – runtime.fivem.net
Verwandte FiveMX-Ressourcen
Verwende diese Abschnitte, um verwandte FiveM-Kategorien zu vergleichen und Ressourcen einzurichten, bevor du einen Live-Server änderst.
Konfigurationsprüfungen vor dem Hinzufügen von Ressourcen
Wenn neue Ressourcen Jobs, EMS-Workflows oder die Server-Startreihenfolge ändern, überprüfe FiveM Jobs Creator Setup-Notizen, vergleiche medizinische Skripte, und behalte die Failed to Inflate-Fehlerbehebung verfügbar für Probleme beim Laden von Ressourcen.
Für die listen-spezifischen Felder und den aktuellen sv_master1 Verhalten, fahre fort mit dem FiveM Server-Listen-Konfigurationshandbuch.
