FivePD-Server einrichten und überprüfen

Um einen FivePD-Server zu erstellen, beginne mit einem funktionierenden FXServer, lade das FivePD-Paket von einer vertrauenswürdigen Quelle herunter, lies die Installationshinweise des Pakets, installiere die deklarierten Abhängigkeiten, füge die Ressourcen zu server.cfghinzu und teste die Basisressource, bevor du Callouts ergänzt. Kopiere nicht blind eine alte Datenbank oder ein Konfigurationsbeispiel: FivePD-Distributionen und Add-ons verwenden nicht alle die gleichen Dateien, Speicher-Layer oder Abhängigkeitsversionen.

Was du vor dem Herunterladen von FivePD benötigst

• Eine saubere FXServer-Instanz, die ohne FivePD erfolgreich startet.
• Einen gültigen Cfx.re-Serverschlüssel und Zugriff auf die Serverkonsole.
• Einen separaten Staging- oder Testserver. Experimentiere nicht mit der einzigen Live-Kopie.
• Das FivePD-Archiv, dessen README oder Dokumentation und jede dort genannte Abhängigkeit.
• Ein Backup von server.cfg, Ressourcenkonfiguration und jeder vom Paket verwendeten Datenbank.

Wenn der zugrunde liegende FiveM-Server noch nicht bereit ist, folge zuerst der txAdmin-Server-Setup-Anleitung . Überprüfe die Dateien und Anforderungen der tatsächlichen FivePD-Distribution, bevor du sie installierst.

Schritt 1: Überprüfe, ob der Basis-FXServer funktioniert

Starte FXServer mit einer minimalen Konfiguration und verbinde dich einmal, bevor du FivePD installierst. Bestätige, dass der Server erscheint, die Konsole frei von Startfehlern ist und ein Client beitreten kann. Dies trennt ein FXServer-, Firewall- oder Server-Key-Problem von einem FivePD-Problem.

Erfasse die aktuellen Artefakt- und Ressourcenversionen. Cfx.re empfiehlt aktuelle Server-Artefakte, aber das Ändern von Artefakt, Game Build, Framework und FivePD-Paket in einem Durchgang erschwert die Isolierung von Fehlern. Ändere jeweils nur eine Ebene.

Schritt 2: Überprüfe den FivePD-Download

Extrahiere das Archiv zuerst außerhalb des Live- resources Verzeichnisses. Finde dessen fxmanifest.lua oder Legacy-Manifest, README, Konfigurationsdateien und Abhängigkeitsdeklarationen. Der Ressourcenordner, der unter resources liegt, muss das Manifest enthalten; ein zusätzliches Archivverzeichnis darüber ist eine häufige Ursache für „resource not found“.

Überprüfe das Archiv auf Anweisungen zu Datenbankimporten, Verbindungszeichenfolgen, Berechtigungen und Ladereihenfolge. Einige Pakete oder Erweiterungen benötigen möglicherweise Speicherplatz in der Datenbank; andere möglicherweise nicht. Erstelle Schemas oder füge SQL nur ein, wenn das installierte Paket dies ausdrücklich verlangt. Veröffentliche niemals Datenbankpasswörter in einem Client-Skript, einer gemeinsamen Konfiguration oder einem öffentlichen Repository.

Schritt 3: Abhängigkeiten vor der Hauptressource installieren

Platziere jede erforderliche Abhängigkeit in ihrem eigenen Ressourcenverzeichnis. Bestätige, dass ihr Name mit dem Manifest und der ensure Zeile übereinstimmt, die du verwenden möchtest. Wenn die Dokumentation eine Reihenfolge angibt, starte freigegebene Bibliotheken und Datenbankbrücken vor FivePD, dann starte Callouts nach der Basisressource.

Eine einfache Konfigurationsform ist:

# Start required libraries first
ensure required_dependency

# Start the FivePD resource after its dependencies
ensure fivepd

# Add one compatible callout only after the base test passes
ensure example_callout

Diese Namen dienen nur als Beispiele. Verwende die tatsächlichen Verzeichnis- und Ressourcennamen aus deinem Download. Der Cfx.re-Befehl ensure startet eine gestoppte Ressource oder startet eine bereits laufende neu.

Schritt 4: Serverseitige Werte sicher konfigurieren

Erstelle die kleinstmögliche Konfiguration für einen ersten Start. Halte Anmeldeinformationen und privilegierte Einstellungen serverseitig. Wo das Paket Standardwerte liefert, kopiere das verteilte Beispiel und ändere nur dokumentierte Schlüssel. Erfinde keine Konfigurationsfelder aus einem nicht verwandten Tutorial: Ein falsch geschriebener Schlüssel kann stillschweigend ignoriert werden, und eine alte Option existiert möglicherweise nicht mehr.

Wenn eine Datenbank erforderlich ist, verwende einen dedizierten Datenbankbenutzer mit nur den notwendigen Berechtigungen. Importiere das passende Schema des Pakets einmal und bestätige dann, dass die Tabellen existieren. Ein erfolgreicher SQL-Import beweist nicht, dass die Ressource eine Verbindung herstellen kann, überprüfe daher die Serverkonsole während des Starts.

Schritt 5: Teste die Basisressource vor zusätzlichen Callouts

1. Starte den Server mit den Abhängigkeiten und FivePD, zunächst ohne optionale Callouts.
2. Beobachte das vollständige Serverprotokoll von der Ressourcenentdeckung bis zum Start.
3. Verbinde dich mit einem sauberen Client und überprüfe die F8-Konsole auf Client-Fehler.
4. Bestätige nur die dokumentierten Basisbefehle und -schnittstellen.
5. Starte die Ressource neu und verbinde dich neu, um Probleme mit der Ladereihenfolge oder Persistenz aufzudecken.

Füge anschließend einen einzelnen Callout hinzu, starte neu und teste ihn. Gehe für weitere Callouts genauso vor. Ein Callout für einen anderen FivePD-Build kann auch bei funktionierender Basisressource fehlschlagen; halte deshalb die letzte funktionierende Version für einen Rollback bereit.

Häufige FivePD-Installationsfehler

Sichere Aktualisierungsreihenfolge

Sichere die funktionierende Ressource und ihre Daten, lies die Versionshinweise, aktualisiere auf Staging und teste die Basis erneut, bevor du optionale Callouts verwendest. Überschreibe keine angepasste Konfiguration, ohne sie zu vergleichen. Wenn ein Update die Datenbank ändert, bewahre sowohl den Pre-Update-Dump als auch die genaue Paketversion auf, die zum Wiederherstellen benötigt wird.

Diese Reihenfolge ist bewusst konservativ: zuerst FXServer, dann Abhängigkeiten, dann FivePD, dann ein Callout. Dadurch erhält jeder Fehler einen kleinen Suchbereich und ein Rollback ist möglich, ohne den gesamten Server neu aufzubauen.