ESX Framework Guide: Offizielle Installation, Updates und Kompatibilität

ESX Legacy ist ein Open-Source-Rollenspiel-Framework für FiveM. Für einen neuen Server verwende die offizielle ESX Legacy-Vorlage in txAdmin oder folge der vollständigen offiziellen Installationsdokumentation. Die Installation nur des es_extended Ordners ist keine vollständige Serverkonfiguration, da der unterstützte Stack Datenbankarbeit, erforderliche Ressourcen und eine geordnete Startkonfiguration umfasst.

Wichtige Erkenntnisse

• Verwende das offizielle ESX Legacy txAdmin-Rezept für eine neue Installation.
• es_extended ist die Kernbasis, nicht der gesamte Rollenspielserver.
• Der dokumentierte manuelle Weg umfasst oxmysql, spawnmanager, SQL, Ausschlüsse und die Reihenfolge der Ressourcen.
• Vor einem Update identifiziere die genaue ESX-Version oder den Fork und sichere sowohl die Datenbank als auch die Ressourcen.
• Prüfe jedes Drittanbieterskript auf Kompatibilität mit dem aktuellen Framework, dem Inventar, der Datenbankbibliothek, den Events, Exporten und Abhängigkeiten.

Was ESX Legacy bietet

ESX liefert eine Framework-Grundlage für Spieler- und Charakterdaten sowie für Ressourcen, die sich in seine APIs und Konventionen integrieren. Jobs, Inventar, Wohnen, Bankwesen, Telefone und andere Gameplay-Systeme sind separate Ressourcen oder Teile eines ausgewählten Rezepts. Ob sie vorhanden sind und wie sie sich verhalten, hängt vom tatsächlichen Stack ab, nicht nur von der Tatsache, dass es_extended installiert ist.

Das offizielle ESX-Core-Repository ist die richtige Quelle für den aktuellen Core-Code. Das Manifest von es_extended nennt oxmysql als Abhängigkeit. Ermittle anhand der offiziellen Dokumentation und Versionshistorie, welche Version du hast; vermeide beliebige Pakete, die lediglich als neueste ESX-ZIP beworben werden.

Installiere einen neuen ESX-Server mit txAdmin

Das offizielle Server-Tutorial verwendet den gebündelten txAdmin-Rezept-Deployer von FXServer. Wähle die ESX Legacy-Vorlage und schließe die aktuelle geführte Konfiguration ab, anstatt einen Kernordner in ein ansonsten leeres Ressourcenverzeichnis zu kopieren.

1. Bereite eine aktuelle FXServer-Umgebung vor und öffne den txAdmin-Einrichtungsvorgang.
2. Erstelle eine neue Rezeptbereitstellung mit der offiziellen ESX Legacy-Vorlage.
3. Gib den dokumentierten Serverschlüssel und die Datenbankeinstellungen an.
4. Lass das Rezept die Datenbank und die erforderlichen Ressourcen bereitstellen.
5. Überprüfe die generierte Konfiguration, Berechtigungen und Ressourcenreihenfolge.
6. Starte den Testserver und verifiziere die Charaktererstellung, Persistenz, Jobs, Berechtigungen und Protokolle.

Halte Anmeldeinformationen aus geteilten Dateien und Screenshots heraus. Nach der Bereitstellung, trage die genauen Repository- oder Release-Versionen ein, damit spätere Kompatibilitätsprüfungen auf Beweisen basieren, nicht auf einem generischen ESX-Label.

Verwende den manuellen Installationspfad nur bei Bedarf

Die offizielle Dokumentation zur manuellen Installation definiert die vollständige Grenze. Diese umfasst die Anforderungen an oxmysql und spawnmanager, das Importieren von legacy.sql, den Satz an Kern- und Addon-Ressourcen, Ausschlüsse und die erforderliche Startreihenfolge. Folge dieser Seite als ein einzelnes aktuelles Verfahren. Reduziere es nicht auf das Verschieben von es_extended, das Bearbeiten einer Konfigurationsdatei und das Hinzufügen einer ensure Zeile.

Aktualisiere einen bestehenden ESX-Server sicher

Kläre zuerst, ob der Server aktuelles ESX Legacy, eine ältere Version oder einen Fork mit eigenen Kernänderungen verwendet. Erfasse Datenbankschema, Ressourcenversionen und lokale Anpassungen. Erstelle vor Änderungen ein wiederherstellbares Datenbank-Backup und einen Snapshot von Ressourcen und Konfiguration.

Lies die Migrations- und Release-Hinweise zwischen der bereitgestellten Version und der Zielversion. Teste das vollständige Upgrade auf Staging mit repräsentativen Produktionsdaten. Ein Core-Update kann Exporte, Ereignisse, Spielerdaten, Tabellen, Inventarintegrationen und abhängige Skripte beeinflussen. Validiere Wiederverbindungen und Neustarts sowie einen neuen Charakter.

1. Vergleiche Schemata und SQL-Migrationen, bevor du sie importierst.
2. Löse benutzerdefinierte Kernänderungen explizit, anstatt sie stillschweigend zu überschreiben.
3. Überprüfe jede frameworkbewusste Ressource auf geänderte Exporte, Ereignisse oder Identifikatoren.
4. Teste erlaubte und verweigerte Jobs, Gruppen und Befehle.
5. Überprüfe Client-, Server- und Datenbankprotokolle unter repräsentativen Aktionen.
6. Behalte die vorherigen Dateien und das passende Datenbank-Backup, bis das Rollout akzeptiert ist.

Wähle ein ESX-kompatibles Skript

Lies die produktspezifischen Informationen zu Lieferung, Lizenz, Updates und Support. Installiere es auf einem passenden Testserver und teste Fehlerpfade, einschließlich nicht autorisierter Rollen und wiederholter Ereignisse. Eine sichtbare UI-Einschränkung ist kein Ersatz für die serverseitige Validierung.

ESX, QBCore oder Qbox

Die offiziellen Quellen benennen kein universell bestes Framework. ESX ist oft die risikoärmste Wahl, wenn vorhandene Produktivdaten, Skripte und Teamabläufe bereits darauf aufbauen und kein nachgewiesener Migrationsvorteil die Umstellungskosten überwiegt. QBCore ist ein eigenes API- und Ressourcenökosystem. Qbox bietet eine dokumentierte QB-Bridge, die ESX-spezifische Ressourcen jedoch nicht automatisch übertragbar macht.

Verwende einen Framework-Vergleich basierend auf den erforderlichen Ressourcen, dem Teamwissen, der Datenmigration, der aktuellen Dokumentation und der Rollback-Kapazität. Wenn du eine Änderung in Betracht ziehst, inventarisiere Identitäten, Geld, Jobs, Inventar, Fahrzeuge, Wohnungen, Telefone, Banken, Berechtigungen und benutzerdefinierte Ereignisse, bevor du ein Ziel auswählst.