Framework installieren (ESX/QBCore)

Framework installieren (ESX oder QBCore)

Ein Framework ist das Rückgrat deines FiveM-Roleplay-Servers. Ohne Framework kannst du keine Jobs, Geldsystem, Inventar oder andere RP-Funktionen nutzen. In dieser Anleitung erklären wir, was ein Framework ist, was die Unterschiede zwischen ESX und QBCore sind und wie du eines auf deinem HytaleNode-Server installierst.

Was ist ein Framework und warum brauchst du es?

Ein Framework ist eine große, umfassende Resource, die die Grundfunktionalität deines RP-Servers regelt. Denke an:

Spielerkonten – Speichern von Charakterdaten, Geld, Jobs und Inventar in der Datenbank
Geldsystem – Bargeld, Bankkonto und Schwarzgeld verwalten
Job-System – Spieler können Jobs mit Gehältern und Rängen haben
Item-System – Items verwenden, geben und handeln
API für andere Resources – Andere Resources (wie Polizei, Rettungsdienst, Shops) nutzen das Framework, um auf Spielerdaten zuzugreifen

Ohne Framework funktionieren all diese Job-Resources, Shops und anderen RP-Scripts einfach nicht. Das Framework ist das Fundament, auf dem alles aufbaut.

ESX vs QBCore: Welches solltest du wählen?

Die zwei beliebtesten Frameworks sind ESX und QBCore. Hier ein Vergleich, der dir bei der Wahl hilft:

Eigenschaft	ESX (es_extended)	QBCore (qb-core)
Alter	Älter, sehr bewährt	Neuer, modern aufgebaut
Community	Enorm, Tausende Resources	Wachsend, Hunderte Resources
Schwierigkeitsgrad	Einfach für den Einstieg	Etwas steilere Lernkurve
Anti-Cheat	Basis, zusätzlich nötig	Besser integriert
Performance	Gut (mit guten Resources)	Gut (mit guten Resources)
Dokumentation	Viele Community-Docs	Offizielle Docs verfügbar
Empfohlen für	Anfänger, kleinere Server	Fortgeschrittene, größere Server

Unsere Empfehlung: Wenn du zum ersten Mal einen FiveM-RP-Server aufsetzt, beginne mit ESX. Es gibt mehr kostenlose Resources und die Community ist größer, sodass du leichter Hilfe findest. Wenn du mehr Erfahrung hast oder einen größeren Server aufsetzen möchtest, ist QBCore eine ausgezeichnete Wahl.

ESX installieren: Schritt für Schritt

Folge diesen Schritten, um ESX auf deinem HytaleNode-FiveM-Server zu installieren:

Schritt 1: Datenbank vorbereiten

Gehe zu deinem Server auf mijn.hytalenode.nl und öffne den Tab „Databases".
Erstelle eine neue Datenbank, falls du noch keine hast. Notiere Datenbankname, Benutzername, Passwort und Host.
Öffne phpMyAdmin über den Link im Panel.
Lade die SQL-Datei von ESX herunter (zu finden im GitHub-Repository von es_extended unter dem Ordner sql/ oder als es_extended.sql).
Gehe in phpMyAdmin zu deiner Datenbank und klicke auf „Importieren". Lade die SQL-Datei hoch und klicke auf „Starten". Dies erstellt alle benötigten Tabellen.

Schritt 2: Benötigte Resources herunterladen und hochladen

Lade folgende Resources von GitHub herunter und lade sie auf deinen Server in den Ordner resources/ hoch (siehe die Anleitung „Resources installieren" für detaillierte Upload-Anweisungen):

oxmysql – github.com/overextended/oxmysql (verwende die Release-Version, nicht den Quellcode)
es_extended – github.com/esx-framework/esx_core
esx_identity – Für Charaktererstellung
esx_skin oder fivem-appearance – Für das Aussehen der Charaktere

Stelle sicher, dass du die Ordner korrekt umbenennst. Entferne eventuelle -main- oder -master-Suffixe von den Ordnernamen.

Schritt 3: server.cfg konfigurieren

Öffne deine server.cfg über den Tab „Dateien" im Panel und füge Folgendes hinzu. Stelle sicher, dass die Datenbankverbindung oben steht:

# Database verbinding
set mysql_connection_string "mysql://GEBRUIKERSNAAM:WACHTWOORD@HOST/DATABASENAAM?charset=utf8mb4"

# Resources laden (volgorde is belangrijk!)
ensure oxmysql
ensure es_extended
ensure esx_identity
ensure esx_skin

Ersetze GEBRUIKERSNAAM, WACHTWOORD, HOST und DATABASENAAM durch deine eigenen Datenbankdaten aus Schritt 1.

Schritt 4: Server neu starten und testen

Speichere die Datei server.cfg.
Starte deinen Server über das Panel neu.
Schaue in der Konsole nach Fehlermeldungen. Wenn alles gut geht, siehst du, dass alle Resources erfolgreich geladen wurden.
Verbinde dich über FiveM mit deinem Server und teste, ob du einen Charakter erstellen kannst.

QBCore installieren: Schritt für Schritt

Die Installation von QBCore folgt größtenteils denselben Schritten wie ESX, aber mit anderen Resources:

Datenbank: Importiere die SQL-Dateien von QBCore in deine Datenbank über phpMyAdmin.
Resources herunterladen: Lade qb-core, qb-multicharacter, qb-clothing und oxmysql von der QBCore-GitHub-Organisation herunter.
Upload: Lade alle Resource-Ordner nach resources/ auf deinen Server hoch.
server.cfg: Füge die Datenbankverbindung und ensure-Zeilen hinzu:

# Database verbinding
set mysql_connection_string "mysql://GEBRUIKERSNAAM:WACHTWOORD@HOST/DATABASENAAM?charset=utf8mb4"

# Resources laden
ensure oxmysql
ensure qb-core
ensure qb-multicharacter
ensure qb-clothing

Starte deinen Server neu und teste die Verbindung.

Nach der Installation: Basis-Resources hinzufügen

Sobald dein Framework läuft, kannst du Schritt für Schritt weitere Resources hinzufügen. Beginne mit den Essentials:

ox_lib – Hilfsbibliothek (funktioniert mit beiden Frameworks)
ox_inventory – Inventarsystem (funktioniert mit beiden Frameworks)
Eine Job-Resource – Z. B. Polizei, um zu testen, ob alles funktioniert

Füge jeweils eine Resource hinzu, starte den Server neu und teste, ob alles funktioniert, bevor du die nächste hinzufügst.

Offizielle Dokumentation

Für detailliertere Informationen zu den Frameworks kannst du die offizielle Dokumentation konsultieren:

ESX-Dokumentation: documentation.esx-framework.org
QBCore-Dokumentation: docs.qbcore.org
Overextended (ox_lib, oxmysql, ox_inventory): overextended.dev
Cfx.re Native Reference: docs.fivem.net/natives – Für Entwickler, die selbst Resources erstellen möchten

Tipp: Nimm dir Zeit, die Dokumentation deines gewählten Frameworks durchzulesen. Dies erspart dir später viele Probleme und hilft dir, deinen Server besser zu verstehen und an deine eigenen Wünsche anzupassen.