Diese Anleitung behandelt die Installation von Ressourcen (Scripts) auf Ihrem FiveM-Server, die Einrichtung einer MySQL-Datenbank für Frameworks wie ESX oder QBCore und das Verständnis der Ressourcen-Ladereihenfolge. Wenn Sie die Ersteinrichtung des Servers noch nicht abgeschlossen haben, beginnen Sie zuerst mit der FiveM Server-Einrichtungsanleitung.

Ressourcen und Scripts installieren

FiveM-Server werden mit Ressourcen (auch Scripts genannt) erweitert. Ressourcen fügen Funktionen wie Autohändler, Jobs, HUD-Elemente, Frameworks und mehr hinzu.

So installieren Sie eine Ressource

1. Laden Sie die Ressource von ihrer Quelle herunter (GitHub, Cfx.re-Foren, Tebex, etc.).
2. Entpacken Sie den Ressourcen-Ordner aus dem ZIP-/Archiv, falls nötig.
3. Laden Sie den Ressourcen-Ordner in das resources/-Verzeichnis Ihres Servers hoch, über den GPanel Dateien-Tab oder per SFTP.
4. Öffnen Sie server.cfg und fügen Sie eine ensure-Zeile für die Ressource hinzu:

# Add your custom resources
ensure my-new-resource

5. Starten Sie den Server über GPanel oder TXAdmin neu, damit die Ressource geladen wird.

Ressourcen-Manifeste

Jede gültige Ressource muss eine Manifest-Datei enthalten. Moderne Ressourcen verwenden fxmanifest.lua, ältere verwenden __resource.lua. Wenn ein heruntergeladener Ressourcen-Ordner keine dieser Dateien enthält, wird die Ressource nicht geladen. Manche Downloads verschachteln den eigentlichen Ressourcen-Ordner in einem äußeren Ordner — stellen Sie sicher, dass der Ordner, den Sie in resources/ platzieren, derjenige ist, der das Manifest enthält.

Ressourcen-Ladereihenfolge

Ressourcen werden in der Reihenfolge geladen, in der sie in server.cfg erscheinen. Wenn eine Ressource von einer anderen abhängt (zum Beispiel ein Job-Script, das von einem Framework wie ESX oder QBCore abhängt), stellen Sie sicher, dass die Abhängigkeit vor der Ressource aufgelistet ist, die sie benötigt:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Ressourcen mit Kategorie-Ordnern organisieren

Sie können Ressourcen in Unterordnern innerhalb des resources/-Verzeichnisses organisieren. Verwenden Sie die Klammer-Notation in server.cfg, um einen gesamten Kategorie-Ordner zu laden:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Dies lädt jede Ressource innerhalb des benannten Unterordners. Es ist eine bequeme Möglichkeit, verwandte Scripts zu gruppieren, ohne jedes einzeln aufzulisten.

Hot-Loading von Ressourcen über TXAdmin

Sie benötigen nicht immer einen vollständigen Serverneustart, um eine neue Ressource zu laden. TXAdmin kann einzelne Ressourcen über seine Resources-Seite starten, stoppen und neu starten. Nachdem Sie eine neue Ressource hochgeladen und ihre ensure-Zeile hinzugefügt haben, können Sie den folgenden Befehl in der TXAdmin Live-Konsole ausführen:

refresh
ensure my-new-resource

Der refresh-Befehl weist den Server an, das resources/-Verzeichnis nach neuen Einträgen erneut zu durchsuchen.

Datenbank-Einrichtung (MySQL / MariaDB)

Viele FiveM-Frameworks und Ressourcen (wie ESX, QBCore oder vRP) benötigen eine MySQL- oder MariaDB-Datenbank. Legion Hosting stellt Datenbank-Zugangsdaten mit Ihrem Server bereit.

Ihre Datenbank-Zugangsdaten finden

1. Gehen Sie in GPanel zum Datenbanken-Tab.
2. Wenn noch keine Datenbank vorhanden ist, klicken Sie auf Neue Datenbank, um eine zu erstellen.
3. Notieren Sie sich folgende Details:
   • Datenbank-Host (Adresse und Port)
   • Datenbankname
   • Benutzername
   • Passwort (klicken Sie auf das Augen-Symbol, um es anzuzeigen)

Datenbankverbindung konfigurieren

Datenbankverbindungsdetails werden in server.cfg über einen Verbindungsstring festgelegt. Das genaue Format hängt davon ab, welche MySQL-Ressource Sie verwenden, aber das gängigste Format ist:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Ersetzen Sie die Platzhalter durch Ihre tatsächlichen Zugangsdaten aus dem Datenbanken-Tab. Zum Beispiel:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Eine MySQL-Ressource auswählen

Welche MySQL-Ressource Sie auch verwenden, sie muss in server.cfg vor allen Ressourcen geladen werden, die davon abhängen:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Framework-Grundlagen

Ein Framework bietet die grundlegenden Gameplay-Systeme, auf denen andere Ressourcen aufbauen — Dinge wie Spieleridentität, Geld, Inventar, Jobs und Fahrzeuge. Die zwei beliebtesten FiveM-Frameworks sind:

Die meisten Frameworks werden über das TXAdmin-Rezeptsystem während der Ersteinrichtung installiert. Wenn Sie bei der TXAdmin-Einrichtung ein Rezept wie "QBCore" oder "ESX" gewählt haben, sind das Framework und seine Kernabhängigkeiten bereits installiert. Wenn Sie ein Framework manuell installieren müssen, folgen Sie der offiziellen Dokumentation:

• ESX-Dokumentation
• QBCore-Dokumentation

Hilfe erhalten

Wenn Sie Unterstützung bei der Ressourcen-Installation oder Datenbankkonfiguration benötigen:

1. Überprüfen Sie die Dokumentation der Ressource oder deren GitHub-Seite auf Installationsanweisungen und bekannte Probleme.
2. Überprüfen Sie die GPanel-Konsole oder TXAdmin-Logs auf Fehlermeldungen.
3. Eröffnen Sie ein Support-Ticket unter https://legionhosting.net/submitticket.php mit Ihren Fehlermeldungen und dem Namen der Ressource, die Sie installieren möchten.

Verwandte Artikel

• FiveM Server-Einrichtungsanleitung
• FiveM Fehlerbehebung
• So laden Sie Dateien per SFTP hoch
• So finden Sie Ihre Server-IP und den Port