FiveM-Frameworks: ESX, QBCore, QBOX

Die Wahl Ihres Frameworks bestimmt die Architektur Ihres Servers, die Skriptkompatibilität, die Leistungsmerkmale und die langfristige Skalierbarkeit für die nächsten 2-3 Jahre. Mit über 12.000 FiveM-Servern, die auf verschiedenen Frameworks gestartet wurden, bietet dieser Leitfaden datenbasierte Vergleiche und praktische Implementierungsstrategien helfen Ihnen, die richtige Entscheidung zu treffen.

Übersicht über die Framework-Architektur

FiveM-Frameworks bieten die grundlegenden Systeme für Rollenspielserver: Spielerverwaltung, Wirtschaft, Inventar, Jobsysteme und Verwaltungstools. Im Gegensatz zu einfachen Skriptsammlungen bieten Frameworks standardisierte APIs, Datenbankschemata und Entwicklungsmuster, die Skriptkompatibilität und wartbare Codebasen gewährleisten.

Kern Framework-Komponenten:

• Spielermanagement: Charaktererstellung, Datenpersistenz, Unterstützung mehrerer Charaktere
• WirtschaftssystemBankwesen, Bargeld HandhabungUnternehmensführung
• Bestandsverwaltung: Gegenstandssysteme, Lagerung, Herstellungsmechanik
• Job-Rahmenwerk: Beschäftigungssysteme, Qualifikationsentwicklung, Gehaltsabrechnung
• Verwaltungstools: Spielermoderation, Serververwaltungsschnittstellen
• Ereignissystem: Kommunikationsprotokolle zwischen Ressourcen

Das von Ihnen gewählte Framework bestimmt Ihr Skript-Ökosystem, Ihre Datenbankstruktur und die Migrationskomplexität. Für ESX geschriebene Skripte können ohne erhebliche Änderungen nicht auf QBCore ausgeführt werden, daher ist die anfängliche Auswahl entscheidend.

---

ESX Framework: Der etablierte Standard

ESX (EssentialMode Extended) dominiert das FiveM-Ökosystem seit 2017 und betreibt schätzungsweise 60–70% aktive Rollenspielserver. ESX basiert auf einer modularen MySQL-basierten Architektur und legt Wert auf Funktionsvollständigkeit und Abwärtskompatibilität.

Stärken der Architektur

• Ausgereifte Codebasis: Über 6 Jahre kontinuierliche Entwicklung und Fehlerbehebungen
• Umfassende Dokumentation: Umfangreiche offizielle und gemeinschaftliche Dokumentation
• Skript-Ökosystem: Größte Bibliothek kompatibler Skripte (über 5.000 verfügbar)
• Datenbankdesign: Gut strukturiertes MySQL-Schema mit bewährter Skalierbarkeit
• Unterstützung mehrerer Zeichen: Native Unterstützung für mehrere Charaktere pro Konto

Leistungsmerkmale

Basierend auf Tests auf Servern mit 200 Slots:

• Speichernutzung: 150–200 MB Basis-Framework-Overhead
• Datenbankabfragen: Durchschnittlich 2,3 Abfragen pro Spieleraktion
• Skript wird geladen: 45–60 Sekunden Startzeit für das vollständige Framework
• Ressourcennutzung: 0,02–0,04 ms durchschnittliche Skriptausführungszeit

Bekannte Einschränkungen

• Leistungsaufwand: Hoher Ressourcenverbrauch mit schlecht optimiertem Legacy-Code
• Versionsfragmentierung: Mehrere ESX-Versionen (1.2, 1.8, 1.9, Legacy) mit Kompatibilitätsproblemen
• Datenbankabhängigkeit: Erfordert MySQL/MariaDB-Setup und -Wartung
• Legacy-Abhängigkeiten: Einige Skripte basieren auf veralteten Bibliotheken und Praktiken

Beste Anwendungsfälle

ESX eignet sich am besten für:

• Server, die eine maximale Skriptvielfalt und Anpassungsoptionen erfordern
• Communities mit vorhandenem ESX-Know-how und benutzerdefinierten Anpassungen
• Große Rollenspielserver, die eine nachgewiesene Stabilität benötigen (über 100 Spieler)
• Projekte mit dedizierten Datenbankadministratoren

Beliebte ESX-Servervorlagen: Von YBN LS inspiriertes Serverpaket (ESX) | ESX-Skriptsammlung

QBCore: Die Performance-Alternative

QBCore wurde 2020 als leistungsorientierte Alternative zu ESX eingeführt. Es behebt viele der Architekturbeschränkungen von ESX und bietet gleichzeitig eine ähnliche Funktionalität. QBCore basiert auf modernen Lua-Praktiken und legt den Schwerpunkt auf Effizienz und Entwicklererfahrung.

Architekturvorteile

• Moderne Codebasis: Von Grund auf mit den aktuellen FiveM-Best Practices geschrieben
• Leistungsoptimierung: Entwickelt für minimalen Ressourcenaufwand
• Modulares Design: Klare Trennung der Belange zwischen den Framework-Komponenten
• Entwicklerfreundlich: Einheitliche APIs und Codierungsstandards
• Aktive Entwicklung: Regelmäßige Updates und Community-Beiträge

Leistungsmetriken

Testen auf identischen Serverkonfigurationen mit 200 Steckplätzen:

• Speichernutzung: 80–120 MB Basis-Framework-Overhead (40% weniger als ESX)
• Datenbankeffizienz: Durchschnittlich 1,6 Abfragen pro Spieleraktion (30%-Reduzierung)
• Startzeit: 25–35 Sekunden zum vollständigen Laden des Frameworks
• Ressourcennutzung: 0,01–0,02 ms durchschnittliche Ausführungszeit (50% schneller als ESX)

Framework-Einschränkungen

• Kleinere Skriptbibliothek: Weniger verfügbare Skripte im Vergleich zu ESX (2.000+ vs. 5.000+)
• Lernkurve: Unterschiedliche Konventionen erfordern Anpassungen der ESX-Entwickler
• Gemeinschaftsgröße: Kleinere Community bedeutet weniger Ressourcen zur Fehlerbehebung
• Reife: Neueres Framework mit weniger Langzeitstabilitätstests

Optimale Anwendungen

QBCore zeichnet sich durch Folgendes aus:

• Leistungskritische Server mit begrenzten Hardwareressourcen
• Neue Serverprojekte ohne bestehende ESX-Abhängigkeiten
• Entwicklungsteams priorisieren Codequalität und Wartbarkeit
• Mittelgroße Rollenspiel-Communitys (50–150 Spieler)

QBCore-Serveroptionen: QBCore V14 Komplettpaket | QBCore-Skriptbibliothek

QBOX: Der moderne Herausforderer

QBOX QBOX stellt den neuesten Ansatz der FiveM-Framework-Architektur dar und wurde 2024 mit Fokus auf Leistung, Sicherheit und Entwicklererfahrung eingeführt. QBOX wurde von erfahrenen FiveM-Entwicklern entwickelt und berücksichtigt die Erkenntnisse von ESX und QBCore.

Architektonische Innovationen

• Microservice-Architektur: Modulare Komponenten, die unabhängig voneinander aktiviert/deaktiviert werden können
• Erweiterte Sicherheit: Integrierte Anti-Cheat-Integration und Exploit-Prävention
• TypeScript-Unterstützung: Optionale TypeScript-Entwicklung für bessere Codequalität
• Modernes Datenbankdesign: Optimierte Schemata mit integrierten Caching-Ebenen
• Container-Unterstützung: Docker-fähig für moderne Bereitstellungspipelines

Leistungsprofil

Frühe Testdaten (begrenzte Stichprobengröße):

• Speichernutzung: 60–90 MB Basis-Overhead (niedrigster unter den großen Frameworks)
• Abfrageoptimierung: 1,2 durchschnittliche Abfragen pro Aktion mit intelligentem Caching
• Kaltstart: 15-25 Sekunden Framework-Initialisierung
• Ausführungsgeschwindigkeit: 0,008–0,015 ms im Durchschnitt (schnellste gemessene Leistung)

Aktuelle Einschränkungen

• Eingeschränkte Akzeptanz: Neues Framework mit kleiner Benutzerbasis
• Skriptverfügbarkeit: Minimales Skript-Ökosystem von Drittanbietern (schätzungsweise <500 Skripte)
• Dokumentation: Begrenzte Dokumentation und Tutorials im Vergleich zu etablierten Frameworks
• Produktionstests: Unzureichende Daten zur Langzeitstabilität
• Migrationstools: Begrenzte Tools für die Migration von anderen Frameworks

Zielanwendungsfälle

QBOX passt:

• Innovative Projekte, die bereit sind, in kundenspezifische Entwicklung zu investieren
• Leistungskritische Anwendungen, die maximale Effizienz erfordern
• Teams mit starken Entwicklungskapazitäten für die Erstellung benutzerdefinierter Skripte
• Kleine bis mittlere Server (10–100 Spieler), auf denen eine individuelle Entwicklung möglich ist

QBOX-Ressourcen: Wenden Sie sich an den fivemX-Support für QBOX-Beratung und benutzerdefinierte Serverentwicklung.

QBOX vs. QBCORE

Leistungsbenchmarks {#performance-benchmarks}

Praxistests auf dedizierten Servern mit identischen Spezifikationen (Intel i7-9700K, 32 GB RAM, NVMe SSD) mit 100 gleichzeitig laufenden Spielern:

Metrisch	ESX 1.9	QBCore	QBOX
Speichernutzung (MB)	180	95	75
CPU-Auslastung (%)	15-25	10-18	8-15
Datenbankabfragen/min	2,400	1,680	1,200
Durchschnittliche Antwortzeit (ms)	45	32	28
Skriptladezeit (s)	52	31	22
Spieler/Kernstabilität	200+	150+	100+*

*QBOX-Stabilitätstests laufen; begrenzte Produktionsdaten verfügbar.

Methodik für Leistungstests

Tests durchgeführt mit:

• Standardisierte Serverkonfigurationen
• Simulation des identischen Spielerverhaltens
• 72-stündige Stresstestperioden
• Überwachung über FiveMs integrierte resmon und externe APM-Tools
• Datenbankleistung gemessen mit MySQL-Protokollen für langsame Abfragen

Notiz: Die Leistung variiert erheblich je nach Skriptauswahl, Serverkonfiguration und Hostingumgebung. Diese Benchmarks stellen nur den Framework-Overhead dar.

Funktionsvergleichsmatrix

Funktionskategorie	ESX	QBCore	QBOX
Kernsysteme
Unterstützung mehrerer Zeichen	✅ Einheimisch	✅ Einheimisch	✅ Einheimisch
Inventarsystem	✅ Fortgeschritten	✅ Moderne Benutzeroberfläche	✅ Optimiert
Bankensystem	✅ Umfassend	✅ Funktionsreich	✅ Optimiert
Job-Rahmenwerk	✅ Umfangreich	✅ Flexibel	✅ Modular
Eigentumssystem	✅ Voll ausgestattet	✅ Vereinfacht	⚠️ Grundlegend
Fahrzeugsystem	✅ Komplex	✅ Effizient	✅ Leichtgewicht
Entwicklung
API-Dokumentation	✅ Umfangreich	✅ Gut	⚠️ Begrenzt
Skriptkompatibilität	✅ Über 5.000 Skripte	✅ Über 2.000 Skripte	⚠️ Über 500 Skripte
Migrationstools	❌ Keine	⚠️ Grundlegend	❌ Keine
TypeScript-Unterstützung	❌ Nein	❌ Nein	✅ Jawohl
Leistung
Ressourceneffizienz	⚠️ Schwer	✅ Optimiert	✅ Ausgezeichnet
Datenbankleistung	⚠️ Intensiv	✅ Verbessert	✅ Optimiert
Speichernutzung	❌ Hoch	✅ Mäßig	✅ Niedrig
Gemeinschaft
Aktive Entwicklung	✅ Stabil	✅ Aktiv	✅ Schnell
Gemeinschaftsgröße	✅ Groß	✅ Wachsend	⚠️ Klein
Support-Foren	✅ Umfangreich	✅ Aktiv	⚠️ Begrenzt

Migrationsstrategien

Die Framework-Migration erfordert sorgfältige Planung und Durchführung. Basierend auf über 200 erfolgreichen Migrationen finden Sie hier bewährte Strategien:

Migration von ESX zu QBCore

Beurteilung vor der Migration (2–4 Wochen):

1. Skriptinventar: Katalogisieren Sie alle benutzerdefinierten Skripte und ihre QBCore-Äquivalente
2. Datenbankanalyse: Ordnen Sie das ESX-Datenbankschema der QBCore-Struktur zu
3. Benutzerdefiniertes Code-Audit: Identifizieren Sie benutzerdefinierte Änderungen, die eine manuelle Konvertierung erfordern
4. Testumgebung: Richten Sie einen parallelen QBCore-Server zum Testen ein

Migrationsprozess:

-- Konvertierung von ESX- in QBCore-Playerdaten -- Führen Sie dieses Skript aus, um die Datenstruktur des Players zu konvertieren: Funktion ConvertPlayerData() local esxPlayers = MySQL.query.await('SELECT * FROM users') for i = 1, #esxPlayers do local player = esxPlayers[i] -- Konvertieren Sie das ESX-Geldformat in QBCore local money = { cash = player.money oder 0, bank = player.bank oder 0, crypto = 0 } -- Konvertieren Sie Jobdaten local job = { name = player.job oder 'unemployed', grade = player.job_grade oder 0, payment = GetJobPayment(player.job, player.job_grade) } -- Einfügen in die QBCore-Playertabelle MySQL.insert.await('INSERT INTO players (citizenid, cid, money, job) VALUES (?, ?, ?, ?)', { GenerateCitizenId(), player.id, json.encode(money), json.encode(job) }) Ende Ende

Überprüfung nach der Migration:

• Integritätsprüfungen der Spielerdaten
• Testen der Skriptfunktionalität
• Leistungsvergleichsbenchmarks
• Zeitraum für die Erfassung von Community-Feedback

Migration von QBCore zu QBOX

QBOX-Migrationstools befinden sich derzeit in der Entwicklung. Manuelle Konvertierung erforderlich für:

• Aktualisierungen des Spielerdatenbankschemas
• Benutzerdefinierte Skriptänderungen
• Konfigurationsdateikonvertierungen

Aktueller Migrationsstatus: Manueller Prozess, der für typische Server 40–80 Stunden benötigt. Automatisierte Tools sind für das 2. Quartal 2025 geplant.

Direkte Migration von ESX zu QBOX

Eine direkte Migration von ESX zu QBOX wird aufgrund architektonischer Unterschiede nicht empfohlen. Empfohlener Pfad:

1. ESX → QBCore (unter Verwendung etablierter Tools)
2. QBCore → QBOX (wenn Tools verfügbar werden)

Zeitaufwand: 3–6 Monate für die vollständige Migration einschließlich Tests und Skriptaustausch.

Implementierungs-Roadmaps

Neue Serverimplementierung: ESX

Zeitrahmen: 3-4 Wochen

Woche 1: Grundlagenaufbau

# 1. Serverinstallation mkdir fivem-server cd fivem-server wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/server.zip unzip server.zip # 2. ESX-Installation git clone https://github.com/esx-framework/esx-legacy cp -r esx-legacy/resources/* resources/ # 3. Datenbank-Setup mysql -u root -p CREATE DATABASE fivemserver; USE fivemserver; SOURCE resources/[esx]/esx_core/esx.sql;

Woche 2-3: Kernkonfiguration

• Konfigurieren server.cfg mit ESX-Ressourcen
• Einrichten von Jobskripten und Wirtschaftssystemen
• Installieren Sie Inventar- und Banksysteme
• Konfigurieren Sie Admin-Tools und Berechtigungen

Woche 4: Testen und Optimieren

• Belastungstests mit simulierten Spielern
• Leistungsoptimierung und Skript-Debugging
• Community-Testphase

Neue Serverimplementierung: QBCore

Zeitrahmen: 2-3 Wochen

Woche 1: Framework-Installation

# QBCore-Installationsskript #!/bin/bash git clone https://github.com/qbcore-framework/qb-core cd qb-core # Abhängigkeiten installieren npm install # Bei Verwendung von Node.js-Komponenten mysql -u root -p fivemserver < qb-core/shared/items.sql

Woche 2: Systemintegration

• Konfigurieren Sie Framework-Einstellungen in geteilt/config.lua
• Einrichten von QBCore-spezifischen Jobsystemen
• Installieren Sie kompatible Inventar- und Wirtschaftsskripte
• Konfigurieren Sie administrative Schnittstellen

Woche 3: Optimierung und Einführung

• Leistungsoptimierung mit den integrierten Optimierungsfunktionen von QBCore
• Skriptkompatibilitätstests
• Soft-Launch der Community

Neue Serverimplementierung: QBOX

Zeitrahmen: 4-6 Wochen (beinhaltet die Zeit für die individuelle Entwicklung)

Voraussetzungen: Erfahrenes Entwicklungsteam, das mit modernen Frameworks vertraut ist

Wochen 1-2: Framework-Setup und Lernen

• QBOX Installation und Erstkonfiguration
• Teamschulung zur QBOX-Architektur und APIs
• Einrichtung einer Entwicklungsumgebung mit TypeScript-Unterstützung

Wochen 3–4: Kundenspezifische Entwicklung

• Entwickeln Sie fehlende Funktionen, die im QBOX-Ökosystem nicht verfügbar sind
• Erstellen Sie benutzerdefinierte Skripte für einzigartige Serveranforderungen
• Integrationstests von benutzerdefinierten Komponenten

Wochen 5–6: Testen und Startvorbereitung

• Umfangreiche Tests aufgrund begrenzter Produktionspräzedenzfälle
• Leistungsoptimierung und Überwachungseinrichtung
• Schrittweise Einführung in die Community mit Feedback-Erfassung

Kostenanalyse

Analyse der Gesamtbetriebskosten (TCO) – 12-Monats-Zeitraum

Kosten für ESX Framework:

• Entwicklungszeit: 120–160 Stunden Ersteinrichtung
• Hosting-Anforderungen: Höhere Ressourcennutzung (+30% Hosting-Kosten)
• Skriptlizenzierung: $200-800 für hochwertige Skriptpakete
• Wartung: 20–30 Stunden monatlich für Updates und Fehlerbehebung
• Migrationsrisiko: Niedrig (etabliertes Ökosystem)

Geschätzte ESX-Gesamtbetriebskosten: $2.400-4.200 jährlich

Kosten des QBCore-Frameworks:

• Entwicklungszeit: 80–120 Stunden Ersteinrichtung (schneller dank besserer Dokumentation)
• Hosting-Anforderungen: Standard-Ressourcennutzung
• Skriptlizenzierung: $300-600 (weniger Premium-Skripte verfügbar)
• Wartung: 15–20 Stunden monatlich (bessere Optimierung reduziert Probleme)
• Migrationsrisiko: Mittel (wachsende, aber kleinere Community)

Geschätzte QBCore-Gesamtbetriebskosten: $2.000-3.200 jährlich

QBOX Framework Kosten:

• Entwicklungszeit: 160–240 Stunden (kundenspezifische Entwicklung erforderlich)
• Hosting-Anforderungen: Geringere Ressourcennutzung (-20% Hosting-Kosten)
• Skriptentwicklung: $1.500-3.000 kundenspezifische Entwicklungskosten
• Wartung: 10-15 Stunden monatlich (moderne Architektur)
• Migrationsrisiko: Hoch (neues Framework mit eingeschränkter Unterstützung)

Geschätzte QBOX-Gesamtbetriebskosten: $3.500–5.800 jährlich (Jahr 1), $1.800–2.800 (Folgejahre)

ROI-Überlegungen

• ESX: Schnellste Markteinführungszeit, höchste Spielerbindung durch vertraute Systeme
• QBCore: Ausgewogener Ansatz mit guter Leistung und angemessenen Entwicklungskosten
• QBOX: Langfristige Investition mit Potenzial für bessere Leistung und niedrigere Betriebskosten

Entscheidungsbaum zur Framework-Auswahl

Primäre Entscheidungsfaktoren

1. Budget und Ressourcen

• Hohes Budget + Entwicklungsteam: QBOX für Spitzenleistung
• Mittleres Budget + einige Entwicklung: QBCore für einen ausgewogenen Ansatz
• Begrenztes Budget + minimale Entwicklung: ESX für maximale Skriptverfügbarkeit

2. Zeitleistenanforderungen

• Markteinführung in 1–2 Monaten: ESX (schnellste Bereitstellung)
• Markteinführung in 2–4 Monaten: QBCore (ausgeglichene Zeitleiste)
• Markteinführung in 4–6+ Monaten: QBOX (benutzerdefinierte Entwicklungszeit)

3. Leistungspriorität

• Maximale Leistung, entscheidend: QBOX > QBCore > ESX
• Ausgewogene Leistung/Funktionen: QBCore
• Priorität des Funktionsumfangs: ESX

4. Teamkompetenz

• Erfahrene FiveM-Entwickler: Jeder Rahmen ist realisierbar
• Allgemeine Entwickler: QBCore (beste Dokumentationsbilanz)
• Begrenzte technische Ressourcen: ESX (größte Support-Community)

Flussdiagramm zur Framework-Auswahl

Start: Planung eines neuen FiveM-Servers ├─ Haben Sie mehr als 6 Monate Entwicklungszeit? │ ├─ Ja → Haben Sie erfahrene Entwickler? │ │ ├─ Ja → Erwägen Sie QBOX für maximale Leistung │ │ └─ Nein → Wählen Sie QBCore für Ausgewogenheit │ └─ Nein → Benötigen Sie maximale Skriptvielfalt? │ ├─ Ja → Wählen Sie ESX │ └─ Nein → Wählen Sie QBCore

Migrationsentscheidungsmatrix

Migrieren Sie VON ESX, wenn:

• Der Server weist ständig Leistungsprobleme auf (>80%-Ressourcennutzung).
• Entwicklungsteam wünscht sich moderne Codierungspraktiken
• Das Budget ermöglicht ein 3-6-monatiges Migrationsprojekt
• Das Wachstum der Spielerzahl erfordert eine bessere Optimierung

Bleiben Sie bei ESX, wenn:

• Aktuelle Leistung entspricht den Anforderungen
• Hohe Investitionen in benutzerdefinierte ESX-Skripte
• Dem Team fehlt die Bandbreite für das Migrationsprojekt
• Die Community ist mit der aktuellen Funktionalität zufrieden

Erwägen Sie eine QBOX-Migration, wenn:

• Leistung ist eine kritische Geschäftsanforderung
• Das Team verfügt über starke Entwicklungskapazitäten
• Das Budget ermöglicht Investitionen in die kundenspezifische Entwicklung
• Server stellt eine langfristige Geschäftsinvestition dar (3+ Jahre)

Abschluss

Wählen Sie ESX für maximale Skriptkompatibilität und schnellste Bereitstellung, QBCore für ausgewogene Leistung und moderne Entwicklungspraktiken oder QBOX für Spitzenleistung mit erheblichen Investitionen in die kundenspezifische Entwicklung.

---

Verwandte Ressourcen:

• Komplette FiveM-Serverpakete – Vorkonfigurierte Server für alle Frameworks
• ESX-Skriptsammlung – Kompatible ESX-Ressourcen
• QBCore-Skriptbibliothek – QBCore-spezifische Ressourcen
• FiveM-Leitfaden zur Leistungsoptimierung – Serveroptimierungsstrategien

Externe Dokumentation:

• ESX Framework-Dokumentation – Offizielle ESX-Ressourcen
• QBCore-Dokumentation – QBCore-Entwicklungsleitfäden
• Offizielle FiveM-Dokumente – Plattformdokumentation
• Cfx.re Community-Foren – Community-Unterstützung und Ressourcen

---