Wie du ein FiveM-Server-Template installierst und überprüfst

Installiere ein FiveM-Server-Template in einem isolierten server-data-Verzeichnis und einer neuen Datenbank. Befolge die Dokumentation genau dieses Pakets. Prüfe die wichtigsten Spielerabläufe, bevor du vorhandene Spielerdaten importierst oder den Server öffentlich öffnest.

Die erforderlichen Dateien zusammentragen

Lade das autorisierte Paket über den Download-Bereich deiner Bestellung herunter und behalte das Originalarchiv sowie die Installationshinweise. Notiere die Framework-Version, die erforderliche Datenbank-Engine, Artifact-Anforderungen, Abhängigkeiten und kontogebundene Lizenzen.

Bei einem Kauf über RPCrate nutze deine Konto-Downloads. Die eigenen Anweisungen des Pakets bestimmen den Archivaufbau und das Update-Verfahren. Fehlen diese, fordere sie an, statt SQL- oder Startup-Einstellungen zu erraten.

Die Umgebung vorbereiten

1. Installiere FXServer nach dem offiziellen betriebssystemspezifischen Verfahren. Halte Server-Binaries, server-data und txAdmin-Profildaten getrennt.
2. Installiere die Datenbank-Engine und Version, die das Template unterstützt. Erstelle eine neue Datenbank und ein dediziertes Konto, das nur auf sie beschränkt ist. Richte das Template nicht auf deine bestehende Live-Datenbank.
3. Sichere den aktuellen Server, wenn du einen ersetzt. Entpacke das Template an den Ort, den sein Deployment-Verfahren erwartet; der resources-Ordner und die server.cfg dürfen nicht unter einem versehentlichen zusätzlichen Archivordner verborgen liegen.
4. Prüfe das mitgelieferte SQL, bevor du es in die neue Datenbank importierst. Kontrolliere die darin ausgewählte Datenbank, Schemaänderungen und Beispielkonten. Brich bei Fehlern ab, anstatt einen destruktiven Import blind erneut auszuführen.

Beispiel: SQL setzt eine fest benannte Datenbank zurück

Verwende für den ersten Import eine isolierte Datenbankinstanz, wenn die SQL-Datei eines Pakets einen festen Datenbanknamen oder destruktive Anweisungen enthält. Prüfe die Anweisungen DROP DATABASE, CREATE DATABASE und USE vor der Ausführung. Die Auswahl einer neuen Datenbank in einem grafischen Client reicht nicht aus, wenn die Datei selbst ein anderes Schema auswählt oder neu erstellt.

Die aktuellen Einrichtungshinweise zu QBCore V5 nennen QBV5/[sql]/fivemstore.sql und warnen, dass die Datei diese Datenbank löscht und neu erstellt: fivemstorev5. Halte vorhandene Datenbanken außerhalb der Testinstanz. Prüfe die Anweisung, importiere die Datei dort und kontrolliere anschließend die Datenbank fivemstorev5 sowie das Importprotokoll. Verbinde das Paket mit der geprüften Datenbank über ein Konto mit entsprechend eingeschränkten Rechten.

Die separate Paketprüfung vom 8. September umfasste die Archivintegrität und einen isolierten SQL-Import. Ein Live-Start von FXServer wurde dabei nicht geprüft. Behandle diese Schritte getrennt: Führe anschließend die unten beschriebenen Laufzeit- und Spielertests durch. Ein erfolgreicher Import allein beweist nicht, dass der Server funktioniert.

Wenn Paket-Anweisungen oder Abhängigkeiten unklar sind, sende Produkt-URL, Umgebung und den ersten Fehler an den RPCrate-Support, ohne Anmeldeinformationen. Dieses Beispiel zeigt das Verhalten dieser V5-Datei; es beweist nicht, dass andere Pakete denselben Datenbanknamen oder Importvorgang verwenden.

Nur die dokumentierten Einstellungen konfigurieren

Trage die Datenbankverbindung an der serverseitigen Stelle ein, die der verwendete Adapter vorsieht. Erfinde keine Einstellung Config.MySQLConnection und speichere keine Passwörter in gemeinsam mit dem Client geladenen Lua-Dateien. Behalte die dokumentierte Startreihenfolge der Abhängigkeiten bei, bis die Paketdokumentation eine Änderung erklärt.

Verwende den aktuellen Cfx.re Portal-Serverschlüssel des Besitzers in sv_licenseKey. Halte ihn privat. Lege die tatsächlichen TCP/UDP-Endpunkte, das unterstützte Slot-Limit und die öffentliche Beschreibung mithilfe der Server-Befehlsreferenzfest. Steam-API-Schlüssel sind geheim, wenn eine Ressource sie benötigt, und dürfen nicht mit sets veröffentlicht werden.

Starte mit der richtigen Konfiguration

Verwende das txAdmin-Profil oder den dokumentierten Launcher, der auf diese Server-Datenkonfiguration verweist. Ein relatives +exec server.cfg wird im Startkontext aufgelöst; der Start aus dem falschen Verzeichnis kann dazu führen, dass keine oder die falsche Konfiguration geladen wird.

Lies den ersten Startfehler. Überprüfe fehlende Ressourcen, Datenbankauthentifizierung, Versionsanforderungen und Berechtigungen, bevor du weitere Ressourcen hinzufügst. Beschränke die Administrationsports getrennt vom öffentlichen Spielendpunkt.

Überprüfe eine vollständige Sitzung

1. Verbinde dich mit dem vorgesehenen Spielendpunkt. Verwende 127.0.0.1 nur, wenn Client und Server auf derselben Maschine laufen.
2. Erstelle einen Testcharakter und teste Inventar, Geld, Jobs, Sprachchat und alle wesentlichen Interaktionen. Vergleiche ein gewöhnliches Konto mit einem Administratorkonto.
3. Verbinde dich erneut und starte den Server neu. Prüfe anschließend, ob die erwarteten Daten erhalten bleiben und keine doppelten Einträge entstehen.
4. Stelle ein Backup in einer separaten Testumgebung wieder her. Notiere jede Datei und Abhängigkeit, die für die Wiederherstellung benötigt wird.
5. Plane die öffentliche Umstellung erst, nachdem diese Prüfungen bestanden sind. Halte den vorherigen Server und die passende Datenbank bis zur Abnahme verfügbar.

Wenn eine Installation fehlschlägt

Teile die Paketversion, die Umgebung, den ersten vollständigen Fehler und die bereits versuchten Schritte dem Supportkontakt des Pakets mit. Entferne Anmeldeinformationen und persönliche Daten aus den Protokollen. Ein nil-Wert allein beweist nicht, dass eine SQL-Tabelle fehlt.