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

ESX Legacy ist ein Open-Source-Rollenspiel-Framework von 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.
• Überprüfe jedes Drittanbieter-Skript gegen den aktuellen Framework, das Inventar, die Datenbankbibliothek, die Ereignisse, die Exporte und die Abhängigkeiten.

Was ESX Legacy bietet

ESX stellt eine Framework-Grundlage für Spieler- und Charakterdaten sowie für Ressourcen bereit, die mit seinen APIs und Konventionen integriert sind. Jobs, Inventar, Wohnen, Banking, Telefone und andere Spielsysteme sind separate Ressourcen oder Teile eines ausgewählten Rezepts. Ihre Anwesenheit und ihr Verhalten hängen von dem tatsächlichen Stack ab, nicht nur davon, dass es_extended installiert ist.

Das offizielle ESX-Kernrepository ist die korrekte Quelle für den aktuellen Kerncode. Seine es_extended Manifest erklärt oxmysql als Abhängigkeit. Verwende die offizielle Dokumentation und die Versionsgeschichte, um zu identifizieren, was du hast; vermeide ein zufälliges Paket, das nur als das neueste ESX ZIP beworben wird.

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 aus und vervollständige die aktuelle geführte Konfiguration, 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 Serienschlüssel und die Datenbankeinstellungen an.
4. Erlaube dem Rezept, die Datenbank und die erforderlichen Ressourcen zu bereitzustellen.
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. Sie 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 sicherstellen Zeile.

Aktualisiere einen bestehenden ESX-Server sicher

Erkenne zunächst, ob der Server aktuelle ESX Legacy, eine ältere Version oder einen Fork mit benutzerdefinierten Kernänderungen ausführt. Zeichne das aktuelle Datenbankschema, die Ressourcenversionen und die lokalen Änderungen auf. Erstelle ein wiederherstellbares Datenbank-Backup und ein Ressourcen-/Konfigurations-Snapshot, bevor du etwas ersetzst.

Lies die Migrations- und Versionshinweise zwischen der bereitgestellten Version und der Zielversion. Teste das vollständige Upgrade auf einer Staging-Umgebung mit repräsentativen Produktionsdaten. Ein Kern-Update kann Exporte, Ereignisse, Spieler-Daten, Datenbanktabellen, Inventar-Integrationen und abhängige Skripte beeinflussen. Validieren Sie Neuverbindungen 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

Beginne mit der bezahlte FiveM-Skript-Katalog und eingrenze auf ESX-Skripte. Ein ESX-Produktlabel ist ein Startfilter. Bestätige die erwartete ESX-Version oder den Fork, die Datenbankbibliothek, das Inventar, das Ziel- oder Menüsystem, SQL-Änderungen, Ereignisse, Exporte und Berechtigungen. Überprüfe, ob die Ressource ein bestehendes System ersetzt oder damit integriert wird. Zwei Ressourcen, die beide das Inventar oder die Charakterinitialisierung besitzen, können in Konflikt geraten, selbst wenn jede einzeln als ESX-kompatibel gekennzeichnet ist.

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

Es gibt keinen universell besten Rahmen, der von offiziellen Quellen festgelegt wurde. ESX ist oft die risikoärmste Wahl, wenn die bestehenden Produktionsdaten, Skripte und Teamverfahren bereits von ESX abhängen und kein getesteter Migrationsvorteil die Umwandlungskosten überwiegt. QBCore ist ein separates API- und Ressourcen-Ökosystem. Qbox hat eine dokumentierte QB-Brücke, aber das macht ESX-spezifische Ressourcen nicht automatisch portierbar.

Verwende einen Rahmenvergleich basierend auf den erforderlichen Ressourcen, dem Teamwissen, der Datenmigration, der aktuellen Dokumentation und der Rollback-Kapazität. Bei der Betrachtung einer Änderung erfasse Identitäten, Geld, Jobs, Inventar, Fahrzeuge, Wohnungen, Telefone, Banken, Berechtigungen und benutzerdefinierte Ereignisse, bevor du ein Ziel auswählst.

Sichere nächste Schritte

1. Für einen neuen Build starte mit dem aktuellen offiziellen ESX Legacy txAdmin-Rezept.
2. Für einen bestehenden Server dokumentiere die genaue Version und den Fork, bevor du ein Update planst.
3. Für eine neue Ressource überprüfe alle Integrationsgrenzen und stelle sie mit einer repräsentativen Datenbank bereit.
4. Halte die Rahmeninformationen und die kommerziellen Produktanforderungen getrennt und überprüfe beide vor dem Kauf.