Wie man ESX Legacy auf einem FiveM-Server installiert: Rezept und manuell

Du möchtest einen FiveM-Server mit ESX Legacy haben, und du möchtest wissen, welche Weise du ihn installierst. Es gibt zwei: ein txAdmin-Rezept, das alles macht, und eine manuelle Installation, wo du jedes Stück selbst platzierst. Diese Anleitung behandelt beide, dann was du beim ersten Anmelden überprüfst und die Fehler, die du wahrscheinlich am ehesten siehst.

#Option 1: das txAdmin-Rezept

Dies ist der empfohlene Weg. Wähle im Setup von txAdmin das ESX Legacy-Template aus den beliebten Rezepten. Folge den Schritten in txAdmin Setup und Rezepte: gib deinen Lizenzschlüssel und deine Datenbankdaten ein, überprüfe dann die generierte server.cfg und starte den Server.

Das Rezept lädt es_extended und die Core-Ressourcen, oxmysql und ox_lib herunter, erstellt die Datenbank und importiert die ESX SQL-Datei. Wenn du fertig bist, hast du eine funktionierende Basis. Gehe zu "Erste Anmeldungsprüfungen".

#Option 2: manuelle Installation

Mache dies, wenn du ESX zu einem Server hinzufügst, den du selbst gebaut hast. Du brauchst einen laufenden FXServer, eine MySQL- oder MariaDB-Datenbank und einen Lizenzschlüssel.

#1. Lade die Ressourcen herunter

Hole dir aus den ESX Legacy-Versionen das Core-Pack (es_extended und die Core-Ressourcen, die es verwendet, wie die Identity-, Menu- und Benachrichtigungsressourcen). Lege sie in deinen resources-Ordner, z.B. in resources/[esx]. Du brauchst auch:

• oxmysql, die Datenbankschicht.
• ox_lib, eine gemeinsame Abhängigkeit für moderne ESX-Ressourcen.
• Ein Inventar. Viele ESX Legacy-Server verwenden ox_inventory. Folge der Dokumentation der Version, die du herunterlädst, weil sich die Standardeinrichtung zwischen Versionen ändern kann.

#2. Erstelle die Datenbank und importiere die SQL

Erstelle eine leere Datenbank, z.B. esx:

CREATE DATABASE esx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Dann importiere die SQL-Datei, die mit es_extended geliefert wird (suche nach einer .sql-Datei in seinem Ordner, benannt legacy.sql zum Zeitpunkt des Schreibens). Verwende HeidiSQL, phpMyAdmin oder die mysql-Kommandozeile. Ohne es, wirst du auf Tabelle existiert nicht stoßen.

#3. Bearbeite server.cfg

Stelle die Verbindungszeichenkette ein und starte die Ressourcen in einer guten Reihenfolge:

set mysql_connection_string "mysql://user:password@localhost/esx?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_inventory
ensure [esx]
ensure [standalone]

Die Reihenfolge wird in server.cfg ensure order erklärt. Wenn du die ESX-Identity- oder Multicharakter-Ressourcen verwendest, stelle sicher, dass nur eine Charakterauswahlressource läuft.

#Erste Anmeldungsprüfungen

Starte den Server und lese die Konsole von oben nach unten, bevor du beitrittst. Überprüfe dann:

1. oxmysql verbindet sich. Es gibt eine Zeile über die Datenbankverbindung und keinen roten Fehler direkt danach.
2. es_extended startet ohne Fehler.
3. Du kannst beitreten und die Charaktererstellung oder den Spawn erreichen.
4. Deine Spieler-Reihe existiert. Nachdem du beitrittst, solltest du eine Reihe für dich selbst in der users-Tabelle sehen.
5. Geld und Job laden. Öffne dein Inventar oder führe einen Befehl aus, der dein Konto und deinen Job druckt.

Für Admin-Rechte stelle deine group auf admin in deiner users-Reihe ein, dann beitreten. Für txAdmin und ACE-Befehle, siehe ACE-Berechtigungen.

#Häufige erste Fehler

ESX ist nil in einem Skript. Eine Ressource, die immer noch einen alten Weg verwendet, um ESX zu erhalten, zeigt:

attempt to index a nil value (global 'ESX')

Der moderne Weg ist ESX = exports['es_extended']:getSharedObject(). Siehe ESX ist nil: Behebung von esx:getSharedObject und Kein solcher Export getSharedObject in es_extended.

Kann nicht mit der Datenbank verbinden. Die Verbindungszeichenkette ist falsch, die Datenbank läuft nicht, oder der Benutzer hat keine Rechte. Siehe oxmysql connection error.

Eine Ressource startet nicht. Oft eine fehlende Abhängigkeit oder ein falscher Ordnername. Siehe could not find dependency und couldn't start resource.

Spieler hängen beim Laden. Schaue in der Konsole nach der Ressource, die während des Beitritts einen Fehler macht. Siehe players stuck on the loading screen.

Tipp: Wenn du ein Skript hinzufügst, füge eines nach dem anderen hinzu und starte neu. Wenn ein Fehler erscheint, weißt du, welches Skript ihn verursacht hat.

#Jobs und Gegenstände hinzufügen

Sobald die Basis funktioniert, sind die nächsten Aufgaben Jobs und Gegenstände. Füge einen Job auf ESX hinzu zeigt die Datenbankzeilen, die du brauchst. Für Gegenstände hängt die Weise von deinem Inventar ab: Siehe ox_inventory add items.

#Checkliste