ESX Legacy auf einem FiveM-Server installieren

Wenn Sie einen Rollenspielserver auf FiveM aufbauen, ist ESX Legacy wahrscheinlich der erste Baustein, den Sie setzen: Es ist das am weitesten verbreitete Framework für Wirtschaft, Jobs und Inventar im RP-Ökosystem, kostenlos, Open Source und aktiv von der Community gepflegt. Diese Anleitung deckt die komplette Installation ab, von der Datenbank bis zum ersten Start, samt der häufigsten Fehler und ihrer Behebung.

Rechnen Sie mit 30 bis 45 Minuten für eine saubere Erstinstallation.

Was ist ESX Legacy?

ESX Legacy ist die gepflegte, modernisierte Fassung des historischen ESX-Frameworks (früher es_extended v1). Es liefert die gemeinsame Basis, auf die sich die meisten FiveM-RP-Server stützen: Spielerkonten, Geld (Bargeld und Bank), Inventar, Berufe, Unternehmen und ein Rechtesystem. Die überwiegende Mehrheit der kostenpflichtigen und kostenlosen RP-Skripte am Markt ist dafür gebaut.

Die bekannteste Alternative ist QBCore: Technisch sind beide solide, die Entscheidung hängt vor allem von der Kompatibilität mit den Skripten ab, die Sie einsetzen wollen (siehe die FAQ am Ende der Seite).

Voraussetzungen

• Ein FiveM-Server, der bereits startet (eine cfx-server-data-Basis oder eine Installation über txAdmin). Falls nicht, beginnen Sie mit der Einrichtung des FiveM-Servers, das ist Schritt null vor diesem hier.
• Zugang zu einer MySQL- oder MariaDB-Datenbank. Auf einem FiveM-Server von ElypseCloud ist sie im Angebot enthalten oder als Option verfügbar: Prüfen Sie Ihren Kundenbereich.
• Zugang zum Dateimanager Ihres Panels (bei ElypseCloud Pterodactyl) oder SFTP-Zugang.
• Grundkenntnisse im Bearbeiten der Datei server.cfg.

Schritt 1: Datenbank vorbereiten

Legen Sie eine eigene Datenbank an und verwenden Sie keine, die schon einem anderen Projekt dient. Notieren Sie sich genau:

• den Namen der Datenbank
• den Benutzer und dessen Passwort
• den Host (oft localhost, oder eine interne Adresse bei geteilter Datenbank)

Diese drei Angaben brauchen Sie in Schritt 4.

Schritt 2: oxmysql installieren

ESX Legacy braucht einen asynchronen MySQL-Connector, um mit der Datenbank zu sprechen. Der aktuelle Standard im FiveM-Ökosystem ist oxmysql. Das ältere mysql-async / ghmattimysql funktioniert auf manchen Setups noch, aber oxmysql ist das, was die Dokumentation von ESX Legacy heute empfiehlt. Prüfen Sie die offizielle Doku des Frameworks beim Lesen, das FiveM-Ökosystem bewegt sich schnell.

1. Laden Sie das neueste oxmysql-Release aus dem offiziellen Repository herunter.
2. Legen Sie den Ordner unter resources/[core]/oxmysql ab (das Präfix [core] ist eine Ordnungskonvention, keine technische Vorgabe).
3. Ergänzen Sie in server.cfg, vor jeder Zeile, die ESX lädt:

ensure oxmysql

Schritt 3: es_extended und die ESX-Ressourcen herunterladen

Holen Sie es_extended (den Kern des Frameworks) aus dem offiziellen ESX-Legacy-Repository, zusammen mit den zusätzlichen Ressourcen, die Sie brauchen: spawnmanager, esx_menu_default, esx_context und weitere. Die genaue Liste hängt von der Version und von den Skripten ab, die Sie darauf aufsetzen wollen.

Legen Sie jede Ressource in ihren eigenen Ordner unter resources/[esx]/.

Schritt 4: server.cfg konfigurieren

Ihre server.cfg muss in dieser Reihenfolge laden:

ensure oxmysql
ensure es_extended
ensure spawnmanager
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

Fügen Sie dann den Connection-String Ihrer Datenbank mit Ihren echten Angaben aus Schritt 1 hinzu:

set mysql_connection_string "mysql://benutzer:passwort@localhost/datenbankname?charset=utf8mb4"

Schritt 5: SQL-Schema importieren

Das ESX-Legacy-Repository liefert eine .sql-Datei mit der Grundstruktur (Spielertabellen, Unternehmen und so weiter). Importieren Sie sie über phpMyAdmin, Adminer oder die Kommandozeile in Ihre Datenbank, je nachdem, was Ihr Panel anbietet.

Schritt 6: starten und testen

Starten Sie den Server über Ihr Panel neu und beobachten Sie die Konsole beim Hochfahren. Verbinden Sie sich im Spiel: Sie sollten mit einem leeren Charakter am Spawn landen. Öffnet sich ein ESX-Menü (bei den meisten Konfigurationen standardmäßig F2), funktioniert die Installation.

Häufige Fehler

„oxmysql wasn't ready before a resource was started"

Der MySQL-Connector hatte keine Zeit zu initialisieren, bevor es_extended sich verbinden wollte. Prüfen Sie die Reihenfolge in server.cfg (oxmysql zuerst) und ob der Connection-String korrekt ist.

Verbindungsfehler zur Datenbank („Access denied", „Unknown database")

Prüfen Sie Benutzer, Passwort und Datenbankname in mysql_connection_string und ob der MySQL-Benutzer tatsächlich Rechte auf genau dieser Datenbank hat.

„Could not find resource" beim Start

Eine in server.cfg aufgeführte Ressource liegt nicht an der richtigen Stelle unter resources/, oder der Ordnername stimmt nicht exakt mit dem Eintrag in server.cfg überein, der auf manchen Systemen Groß- und Kleinschreibung unterscheidet.

Der Charakter spawnt nicht / dauerhaft schwarzer Bildschirm

Prüfen Sie, ob spawnmanager nach es_extended geladen wird, und suchen Sie in der Konsole nach einem konkreteren Lua- oder JS-Fehler, bevor Sie weiter suchen.

Wie geht es weiter?

Sobald ESX Legacy steht, hängt der nächste Schritt von Ihrem Projekt ab: Job-Skripte, erweitertes Inventar, Unternehmenssysteme. Zwei Punkte verdienen unabhängig vom Framework Aufmerksamkeit auf der Infrastrukturseite: der verfügbare Arbeitsspeicher, wenn die Zahl der Skripte wächst, und die Qualität der Datenbankverbindung unter Last. Dort fangen die meisten RP-Server an zu ruckeln, nicht in ESX selbst. Wenn Sie mit Ihrem aktuellen Hoster schon an diesem Punkt sind, haben wir dazu eine Seite geschrieben.