Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

Anleitungen

Schritt-für-Schritt-Anleitungen, um Ihren eigenen Server, Gameserver und Ihre Website einzurichten und zu betreiben – vom Team, das unsere Infrastruktur in Istanbul betreibt.

FiveM

ESX, QBCore und Qbox: Welches Framework sollten Sie für FiveM wählen?

26 August 2026 10 Min. Lesezeit Aktualisiert:
Diesen Beitrag teilen

Die erste große Entscheidung beim Eröffnen eines FiveM-Roleplay-Servers ist das grundlegende Framework: ESX Legacy, QBCore oder Qbox. In dieser Anleitung vergleichen wir die drei hinsichtlich Community, Script-Ökosystem, Performance, Lernkurve, Dokumentation und Hilfe sowie Migrationsaufwand; wir erklären, welches Framework zu welchem Projekt passt und wie Sie Ihre Wahl mit einem txAdmin-Recipe installieren. Versions- und Abhängigkeitsangaben stammen aus der offiziellen Dokumentation und den Quell-Repositorys der Frameworks.

Bevor Sie beginnen

  • Ein VDS: Die für FiveM empfohlene Familie ist der AMD Ryzen 9 9950X VDS mit seiner hohen Single-Core-Leistung. Für FiveM geeignete Pakete finden Sie auf der FiveM-Server-Seite.
  • Ein Cfx.re-Konto und ein Lizenzschlüssel: Der Schlüssel kommt nicht mehr aus dem Keymaster; Sie erhalten ihn kostenlos auf der Seite „Registration keys“ im Cfx.re Portal (portal.cfx.re). Die Windows-Installationsanleitung von QBCore erwähnt noch den Keymaster; diese Information ist veraltet.
  • MariaDB: Alle drei Frameworks verbinden sich über oxmysql mit der Datenbank und benötigen einen MySQL-kompatiblen Server. Die Dokumentationen von ESX und Qbox raten ausdrücklich von XAMPP ab. Für Qbox ist MariaDB 10.9.0 die Mindestversion und 12.3 LTS (Long-Term Support, Langzeitunterstützung) die empfohlene Version; MySQL wird nicht unterstützt.
  • Festplatte: Die ESX-Installationsdokumentation verlangt etwa 10 GB freien Speicher für die Serverdateien (Artifact), die Ressourcen und die Datenbank; planen Sie auch für die anderen Frameworks mindestens so viel Platz ein.
  • Zusätzliche Voraussetzung für Qbox: qbx_core benötigt FXServer-Build (Artifact) 10731 oder neuer und aktiviertes OneSync.
  • Wenn Sie FXServer noch nicht installiert haben, arbeiten Sie zuerst die FXServer-Installationsanleitung durch; dieser Artikel baut darauf auf.

1. Die drei Frameworks kennenlernen

ESX Legacy ist das älteste der drei. Seine aktuelle Form liegt im Repository esx_core; die Kernressource ist es_extended (Version 1.16.0 laut Manifest) und hängt von den Ressourcen esx_lib und oxmysql ab. Offizielle Add-ons sind in einem separaten Repository gesammelt (esx-legacy-addons). Die Lizenz ist GPL-3.0. Laut offizieller Dokumentation stellt ESX als Kernbausteine ein Job-System, ein Bank- und Geldsystem, die Charaktererstellung und die Inventarverwaltung bereit.

QBCore ist ein Framework rund um die Ressource qb-core, das das „Core Object“-Muster verwendet: Scripts greifen über den Aufruf exports['qb-core']:GetCoreObject() auf den Kern zu. Das Manifest nennt Version 1.3.0, die einzige Abhängigkeit ist oxmysql, und die Lizenz ist GPL-3.0. Die offizielle Dokumentation beschreibt Ressourcen wie qb-inventory, qb-target, qb-multicharacter, qb-phone, qb-policejob, qb-garages, qb-banking und qb-houses einzeln, insgesamt mehr als 50 Ressourcen mit dem Präfix qb-; daher rührt der Eindruck eines „Komplettpakets“.

Qbox ist ein von QBCore abgespaltenes Framework (Fork), das QBCore verbessern will. Die Kernressource ist qbx_core (Version 1.24.0 laut Manifest); ox_lib und oxmysql sind Pflichtabhängigkeiten, und die README nennt außerdem ox_inventory. Das Manifest stellt zusätzlich den Namen qb-core bereit: Da die Bridge-Schicht die dokumentierte Nutzung von qb-core abdeckt, laufen die meisten QBCore-Scripts ohne Änderungen. Laut der FAQ des Projekts wurden die meisten Ressourcen hinsichtlich Codequalität, Sicherheit und Performance überarbeitet; statt eigene Ressourcen zu pflegen, die dahinter zurückbleiben würden, setzt das Projekt auf Open-Source-Projekte, insbesondere auf die ox-Ressourcen von Overextended.

Die offizielle FiveM-Seite Frameworks führt neben diesen drei auch ND und vRP auf. Cfx.re ist mit keinem Framework verbunden, leistet keinen Support für Frameworks und verweist auf die Dokumentation des jeweiligen Projekts; Community-Support gibt es auf den eigenen Discord-Servern der Projekte.

2. Vergleichstabelle

KriteriumESX LegacyQBCoreQbox
Kernressource / Versiones_extended 1.16.0qb-core 1.3.0qbx_core 1.24.0
Pflichtabhängigkeitenesx_lib, oxmysqloxmysqlox_lib, oxmysql, Artifact ≥ 10731, OneSync
DatenbankMySQL-kompatibel; MariaDB empfohlen, kein XAMPPMariaDB + HeidiSQL (offizielle Windows-Anleitung)Nur MariaDB ≥ 10.9.0 (12.3 LTS empfohlen)
LizenzGPL-3.0GPL-3.0GPL-3 (LICENSE-Datei im Repository)
Community und AlterDas älteste der drei; die längste ForengeschichteGroß und aktiv; breites qb-ÖkosystemDas jüngste; Wurzeln in QBCore, eng mit dem ox-Ökosystem verbunden
Script-ÖkosystemOffizielles Add-on-Repository und über Jahre entstandene Community-Scripts; für alte ESX-Versionen geschriebene Scripts können inkompatibel seinSehr breit; über 50 qb-Ressourcen in der offiziellen DokumentationEigene qbx_-Ressourcen + die meisten QBCore-Scripts über die Bridge
PerformanceKein offizieller Vergleichsbenchmark; die Last bestimmen die Scripts, die Sie hinzufügenKein offizieller Vergleichsbenchmark; die Last bestimmen die Scripts, die Sie hinzufügenLaut FAQ auf Performance hin überarbeitet; auf Qbox umgestellte Ressourcen verbrauchen weniger Arbeitsspeicher
LernkurveNiedrig; hier gibt es die meisten Beispiele und TutorialsMittel; Sie müssen das Core Object und die qb-Struktur kennenlernenMittel bis hoch; Kenntnisse in ox_lib und das Lesen englischsprachiger Dokumentation sind Pflicht
Dokumentation und Hilfe (Beobachtung)Die meisten Beispiele und TutorialsAlle qb-Ressourcen einzeln in derselben offiziellen Dokumentation beschriebenDokumentation und Discord überwiegend auf Englisch
Laufen QBCore-Scripts?Nein, es gibt keine BridgeJaGrößtenteils ja (Bridge), mit Ausnahmen

Achten Sie auf die Zeile zur Performance: In älteren Anleitungen kursieren Aussagen wie „QBCore verbraucht viel weniger CPU und RAM“, doch die offiziellen Dokumentationen der Frameworks enthalten keine solche Vergleichsmessung. In der Praxis belasten meist die Inventar-, Handy-, HUD- und Fahrzeug-Scripts den Server, die Sie zusätzlich installieren. Führen Sie den Vergleich auf Ihrem eigenen Server mit resmon durch; wie Sie die Werte lesen, erklärt die Resmon-Anleitung.

3. Dokumentation und Hilfe

Dieser Abschnitt enthält keine messbaren Daten, sondern eine Beobachtung. Da es ESX am längsten gibt, finden Sie dafür die meisten Beispiele und Tutorials. Bei QBCore sind die qb-Ressourcen einzeln in derselben offiziellen Dokumentation beschrieben. Bei Qbox sind die offizielle Dokumentation und der Discord überwiegend auf Englisch. Wenn Ihnen das Lesen englischer Dokumentation schwerfällt, kann das allein schon ein Grund sein, Qbox zu meiden.

4. Migrationsaufwand: von einem Framework zum anderen wechseln

Ein Wechsel des Frameworks ist mehr als das Kopieren von Dateien: Die Tabellenstruktur der Datenbank, die Spielerdaten, die Job- und Item-Definitionen und die Events, auf die Scripts hören, ändern sich alle. Realistisch ist für jede Richtung mit Folgendem zu rechnen:

RichtungAufwandGrund
ESX → QBCoreHochEvent-Namen, Spielerdaten und Tabellen sind völlig verschieden; Scripts werden neu geschrieben und Spielerdaten von Hand konvertiert.
QBCore → ESXHochDerselbe Grund; in keiner der beiden Richtungen gibt es eine offizielle Bridge.
QBCore → QboxNiedrig bis mittelDie Bridge-Schicht führt die meisten qb-Scripts aus; Scripts, die direkt auf Tabellen zugreifen oder interne Dateien von qb-core verwenden, funktionieren nicht mehr.
Qbox → QBCoreMittel bis hochRessourcen, die gegen die Exporte von qbx_core geschrieben sind, haben in QBCore keine Entsprechung; sie müssen neu geschrieben werden.
ESX → QboxHochDie Bridge gilt nur für QBCore-Scripts; bei ESX-Scripts hilft sie nicht.

Die FAQ von Qbox nennt die Ausnahmen ausdrücklich: direkter Zugriff auf Datenbanktabellen, Zugriff auf Dateien von qb-core, die nicht für die Nutzung durch andere Ressourcen gedacht sind, und die falsche Verwendung vorhandener Funktionen. Multijob-Scripts funktionieren, wenn sie Jobs über die Exporte von qbx_core hinzufügen, ändern und entfernen. Fragen Sie vor Ihrer Entscheidung die Autoren Ihrer kostenpflichtigen Scripts: „Funktioniert es mit der Qbox-Bridge?“

5. Nach Ihrem Projekt entscheiden

  • Ihr erster Server und eine kleine Freundesgruppe: ESX Legacy. Hier gibt es die meisten Beispiele, die meisten fertigen Scripts und die einfachste Fehlersuche.
  • Sie möchten ein integriertes Stadtpaket mit Handy-, Inventar-, Polizei-, Garagen- und Wohnsystemen: QBCore. Alle diese qb-Ressourcen sind in derselben offiziellen Dokumentation einzeln beschrieben.
  • Sie haben ein technisches Team und wünschen sich ein langlebiges Projekt sowie das ox_lib/ox_inventory-Ökosystem: Qbox. Sie erhalten Ressourcen, die auf Sicherheit und Codequalität hin überarbeitet wurden, und können dank der Bridge die meisten Ihrer vorhandenen QBCore-Scripts weiterverwenden. Im Gegenzug müssen Sie englischsprachige Dokumentation lesen; die README rät außerdem davon ab, den Kern über seine Konfigurationsdateien hinaus zu verändern.
  • Sie betreiben bereits einen QBCore-Server und möchten modernisieren: Wechseln Sie zuerst auf einem Testserver zu Qbox, notieren Sie die Scripts, die mit der Bridge nicht funktionieren, und gehen Sie dann live.
  • Sie betreiben bereits einen ESX-Server: Wenn der Server problemlos läuft, wechseln Sie das Framework nicht; halten Sie es_extended aktuell und ersetzen Sie alte Scripts durch ihre Legacy-kompatiblen Versionen.

6. Das gewählte Framework mit einem txAdmin-Recipe installieren

Die Dokumentationen aller drei Frameworks verweisen für die Installation auf die txAdmin-Liste „Popular Recipes“. txAdmin wird mit FXServer ausgeliefert: Es öffnet sich, wenn Sie FXServer ohne den Parameter +exec server.cfg starten, und gibt die Einrichtungsadresse in der Konsole aus. Unter Windows Server entpacken Sie das Archiv nach C:\FXServer\server und starten FXServer.exe. Unter Linux (Ubuntu/Debian) führen Sie, nachdem Sie das Artifact in den Ordner ~/FXServer/server heruntergeladen haben, Folgendes aus:

cd ~/FXServer/server && tar xf fx.tar.xz
bash ~/FXServer/server/run.sh

Verknüpfen Sie im Browser Ihr Cfx.re-Konto per PIN, legen Sie ein Admin-Passwort fest, wählen Sie das Recipe und geben Sie im Recipe Deployer die Datenbankdaten und den Lizenzschlüssel ein; starten Sie den Server im letzten Schritt mit „Save & Run Server“. Die Installation von MariaDB und die Einstellungen in server.cfg behandelt die QBCore-Installationsanleitung ausführlich, den Rest von txAdmin die txAdmin-Anleitung. Die Einstellungen, die sich zwischen den Frameworks unterscheiden, sind:

EinstellungESX LegacyQBCoreQbox
txAdmin-RecipeESX LegacyQBCore FrameworkQBox Framework
FXServer-BuildNeuester Build; der „recommended“-Build kann Fehler auslösenKein Minimum im ManifestMindestens 10731, OneSync aktiviert
Datenbank (Beispiel)localhost, Port 3306, Name esx_legacylocalhost, Port 3306, ein Name Ihrer WahlEbenso; auf dem Server muss MariaDB 10.9.0 oder neuer laufen
Erster StartKein zusätzlicher Schritt in der DokumentationWarten Sie, bis yarn install abgeschlossen istTabellenänderungen und Indizes werden beim Start der Ressource automatisch angewendet

Bei allen dreien ist der Spielport 30120 TCP+UDP (endpoint_add_tcp "0.0.0.0:30120" und endpoint_add_udp "0.0.0.0:30120"); die txAdmin-Weboberfläche lauscht standardmäßig auf 40120 TCP. Öffnen Sie diese Ports in der Firewall des Betriebssystems.

Häufige Fehler

  • „Native XXXXXXXX is not supported“: Laut ESX-Dokumentation liegt die Ursache im als „recommended“ markierten Build; laden Sie das neueste Artifact herunter. Unter Qbox startet qbx_core überhaupt nicht, wenn der Build unter 10731 liegt.
  • „ESX Multicharacter couldn't connect to the database“: Der MySQL-Verbindungsstring in server.cfg ist falsch oder die Datenbank läuft nicht. Korrigieren Sie den String gemäß der oxmysql-Dokumentation und prüfen Sie, ob der MariaDB-Dienst läuft.
  • „ESX = nil“: Die Lösung laut ESX-Dokumentation besteht darin, es_extended auf die neueste Version zu aktualisieren; besorgen Sie außerdem Legacy-kompatible Versionen aller Scripts, die für alte ESX-Versionen geschrieben wurden.
  • Qbox startet nicht mit MySQL oder XAMPP: Das ist das erwartete Verhalten. Qbox benötigt JSON_VALUE(), ADD COLUMN IF NOT EXISTS und CREATE INDEX IF NOT EXISTS; installieren Sie MariaDB 10.9.0 oder neuer.
  • Ein QBCore-Script wirft unter Qbox Fehler: Das Script schreibt höchstwahrscheinlich direkt in Tabellen oder greift auf interne Dateien von qb-core zu. Fragen Sie den Autor nach einer Qbox-Version; für Multijob brauchen Sie eine Version, die die Exporte von qbx_core nutzt.
  • Ihr eigenes Benachrichtigungssystem erscheint unter Qbox nicht: Laut FAQ müssen Sie ox_lib anpassen, damit Benachrichtigungs-Events an Ihr eigenes System weitergeleitet werden.
  • Der Lizenzschlüssel wird nicht akzeptiert: Erstellen Sie den Schlüssel statt über die Keymaster-Adresse aus älteren Anleitungen auf der Seite „Registration keys“ im Cfx.re Portal und fügen Sie ihn ohne Leerzeichen in das Lizenzfeld des Recipe Deployers ein.

Häufig gestellte Fragen

Ist ESX Legacy dasselbe wie „altes ESX“?

Nein. Legacy ist der aktuelle Zweig, der im Repository esx_core gepflegt wird; für alte ESX-Versionen geschriebene Scripts können mit dem aktuellen Kern inkompatibel sein. Verwenden Sie für neue Installationen nur Legacy und besorgen Sie die Legacy-kompatiblen Versionen Ihrer Scripts.

Führt Qbox meine QBCore-Scripts wirklich aus?

Die Bridge-Schicht deckt die dokumentierte Nutzung von qb-core ab, einschließlich exports['qb-core']:GetCoreObject(); deshalb laufen die meisten Scripts unverändert. Ausnahmen sind Scripts, die direkt auf die Datenbank zugreifen, interne Dateien von qb-core verwenden oder Funktionen falsch aufrufen. Probieren Sie es zuerst auf einem Testserver aus.

Welche Datenbank sollte ich installieren?

MariaDB. Die Dokumentationen von ESX und Qbox lehnen XAMPP ausdrücklich ab, und Qbox unterstützt auch MySQL nicht. MariaDB unter Windows zu installieren und mit HeidiSQL zu verwalten, ist der Weg, den die offizielle Anleitung von QBCore beschreibt.

Kann ich das Framework später wechseln?

Ja, aber ein Wechsel zwischen ESX und QBCore/Qbox bedeutet, dass Sie Spielerdaten und Scripts von Grund auf neu aufsetzen. Am wenigsten schmerzhaft ist der Weg von QBCore zu Qbox. Treffen Sie die Entscheidung deshalb vor der Eröffnung des Servers, anhand der Liste Ihrer Scripts.

Hängt der benötigte VDS vom gewählten Framework ab?

Nicht spürbar; alle drei verlangen eine starke Single-Core-Leistung, ein NVMe-Laufwerk und ausreichend RAM. Der Ressourcenbedarf hängt vor allem von der Spielerzahl und der Script-Last ab. Überwachen Sie den Verbrauch mit resmon und den Live-Nutzungsdiagrammen (CPU, RAM, Festplatte, Netzwerk) im Kundenbereich.

Verwandte Anleitungen

Die eigene Dokumentation der Frameworks: das ESX-Installationstutorial und die Qbox-FAQ; für QBCore die Installationsanleitungen für Windows und Linux unter qbcore.org/docs.

Kommentare0

Noch keine Kommentare

Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.

Diskutieren Sie mit

Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.

Keinen Beitrag verpassen

Erhalten Sie unsere neuesten Tutorials, Anleitungen und Produktneuigkeiten direkt in Ihr Postfach.

Sie haben unseren Newsletter abonniert.