Qbox Framework Guide: Installieren, QBCore Bridge und Migration

Qbox ist ein FiveM-Rollenspiel-Framework, das als ein QBCore-Fork begann und nun seine eigenen Kern-APIs und Ressourcen bietet. Es hält eine Kompatibilitätsbrücke für viele korrekt geschriebene QBCore-Ressourcen bereit, aber direkter Datenbankzugriff, Zugriff auf interne Dateien und nicht unterstütztes Verhalten sind dokumentierte Ausnahmen. Verwende das offizielle Qbox txAdmin-Rezept für eine neue Installation und überprüfe jede Ressource vor einer Migration.

Wichtige Erkenntnisse

• Qbox ist ein Framework, kein bloßer Bundle von Ox-Dienstprogrammen oder ein umbenannter QBCore-Ordner.
• Der aktuelle offizielle Installationsweg nutzt das QBox-Rezept aus den beliebten Vorlagen in txAdmin.
• Die QB-Brücke kann bei kompatiblen Ressourcen helfen, garantiert aber nicht für jedes QBCore-Skript.
• Die Migration umfasst Konfiguration, Ränge, Inventar- und Datenbankkonvertierung sowie das Testen jeder einzelnen Ressource.
• Es gibt keine quellengestützte universelle Leistungsrangfolge zwischen Qbox, QBCore und ESX.

Was Qbox ist

Die offizielle Qbox-Einführung dokumentiert die Projektgründung am 27. September 2022 und beschreibt ihren Ursprung in QBCore. Das Projekt hat seitdem einen eigenen Kern und verwandte Ressourcen entwickelt. Seine Kompatibilitätsschicht existiert, um die Nutzung vieler QB-Ressourcen zu erleichtern, während Teams aktuelle Qbox-APIs übernehmen, aber Qbox sollte als eigenes Framework und Rezept bewertet werden.

Die aktuellen qbx_core Manifest nennt ox_lib und oxmysql als direkte Abhängigkeiten. Das offizielle Rezept verbindet Qbox und ausgewählte Drittanbieterressourcen zu einem vollständigen Ausgangssystem. Da sich der Rezeptinhalt ändern kann, verlinke das aktuelle Rezept, statt eine lange Abhängigkeitsliste in einem dauerhaft verfügbaren Installationstutorial festzuschreiben.

Installiere Qbox über das offizielle Rezept

1. Bereite eine unterstützte FXServer-Umgebung vor und öffne die gebündelte txAdmin-Einrichtung.
2. Erfülle die in der aktuellen Qbox-Installationsdokumentation aufgeführten Datenbankanforderungen.
3. Wähle das offizielle QBox-Rezept aus den beliebten Vorlagen, statt den Kern nur teilweise von Hand zusammenzustellen.
4. Vervollständige die Rezeptvariablen, die Datenbankkonfiguration und die Serverkonfiguration mit der aktuellen Dokumentation.
5. Überprüfe die generierte Ressourcenliste und die Startreihenfolge vor dem ersten öffentlichen Start.
6. Überprüfe Spieler-Load, Charaktererstellung, Berechtigungen, Persistenz und Logs auf einem Testserver.

Ersetze Anbieter-Manifeste nicht durch verkürzte Beispiele aus einer Anleitung. Installiere offizielle Releases oder Rezeptversionen und behandle ihre Manifeste als verbindliche Vorgaben für Abhängigkeiten. Ändert ein Update eine Kern- oder Bibliotheksanforderung, gleiche die Release-Dokumentation vor der Bereitstellung mit jeder abhängigen Ressource ab.

Qbox und die QBCore-Brücke

Der offizielle Qbox-Konvertierungsleitfaden erklärt, wie die QB-Bridge die Kompatibilität während des schrittweisen API-Austauschs unterstützt. Laut Qbox-FAQ können die meisten korrekt geschriebenen QBCore-Skripte über diese Bridge funktionieren. Es gibt jedoch wichtige Ausnahmen: Ressourcen mit direktem Datenbankzugriff, Zugriff auf interne Kerndateien oder Abhängigkeit von nicht unterstütztem Verhalten benötigen möglicherweise Anpassungen.

Ressourcenverhalten	Migrationserwartung
Nutzt dokumentierte QB-APIs, die durch die Brücke abgedeckt sind	Kandidat für Brückentests; Kompatibilität muss noch überprüft werden.
Liest Framework-Tabellen direkt	Überprüfe Abfragen und Schema-Annahmen, bevor du Live-Daten änderst.
Lädt interne Kern-Dateien	Refaktoriere zu unterstützten Exporten oder Modulen, wo dokumentiert.
Erwartet Job- oder Gang-Ränge als Textwerte	Prüfe die Qbox-Anforderungen zur Umstellung auf numerische Ränge.
Verwaltet Inventar- oder Charakterdaten	Verwende den dokumentierten Umwandlungspfad und validiere jede Beziehung.

Teste ein als QBCore-kompatibel gekennzeichnetes Produkt daher gesondert mit Qbox. Kläre, ob es ausschließlich dokumentierte und von der Bridge abgedeckte APIs verwendet, welche Inventar- und Target-Systeme es erwartet und ob sein SQL ein QB-Schema voraussetzt, das Qbox anders bereitstellt.

Migrationscheckliste für einen bestehenden QBCore-Server

1. Änderungen pausieren und Bestand erfassen: zeichne Kern, Datenbank, Inventar, Jobs, Gangs, Fahrzeuge, Wohnungen, Telefone, Berechtigungen und benutzerdefinierte Ressourcen auf.
2. Sicherungskopie erstellen: Erstelle wiederherstellbare Datenbank- und Ressourcensnapshots vor der Konvertierungsarbeit.
3. Überprüfe die Konfiguration: Qbox dokumentiert Änderungen an Konfigurationsdateien und API-Zugriff; kopiere alte Kern-Internals nicht blind.
4. Ränge und Daten konvertieren: Befolge die aktuellen offiziellen Schritte für numerische Job- und Gang-Ränge sowie die Inventar- und Datenbankkonvertierung.
5. Ressourcen prüfen: klassifiziere jede Integration als bridge-abgedeckt, anpassbar oder inkompatibel.
6. Teste in Stufen: validiere Charaktere, Geld, Jobs, Gangs, Inventar, Fahrzeuge, Berechtigungen und Verbindungsverhalten.
7. Untersuche die Beweise: Prüfe Server-, Client- und Datenbanklogs und vergleiche vor der Umstellung die Anzahl der relevanten Datensätze.
8. Halte Rollback verfügbar: ändere nicht die einzige Produktionsdatenbank mit einem generischen Konvertierungssnippet.

Wähle Qbox aus expliziten Gründen

Qbox passt zu einem neuen Server, der absichtlich das aktuelle Qbox-Rezept und die APIs möchte. Es kann auch zu einem QBCore-Team passen, das bereit ist, die Brückenkompatibilität zu überprüfen und die dokumentierte Umwandlungsarbeit abzuschließen. Es ist ein schlechtes Migrationsziel, wenn kritische Ressourcen auf undokumentierte Kerninternals angewiesen sind und das Team sie nicht sicher ersetzen oder anpassen kann.

Wähle Qbox nicht allein aufgrund eines Versprechens, ein bestimmtes Inventar, eine Datenbankbibliothek oder ein Framework sei automatisch schneller. Leistung hängt von sämtlichen Ressourcen, Datenbanklast, Spielerverhalten, Artefakt und Serverkonfiguration ab. Ist sie entscheidend, miss repräsentative Aktionen in gleichwertigen Umgebungen und bewahre die Protokolle auf.

Produktionsvalidierung

Teste erfolgreiche und verweigerte Aktionen. Prüfe, ob Geldänderungen genau einmal erfolgen, Job- und Gangberechtigungen unbefugte Spieler abweisen, Inventare bei erneuten Verbindungen konsistent bleiben, Fahrzeuge im Spielerbesitz erhalten bleiben und administrative Aktionen protokolliert werden. Clientanfragen müssen serverseitig validiert werden; ein vom Client auslösbares Event ist nicht allein dadurch sicher, dass die UI es vor normalen Spielern verbirgt.

Nutze den Framework-Vergleich für die breitere ESX/QBCore/Qbox-Entscheidung. Bei der Auswahl aus dem Katalog für kostenpflichtige FiveM-Skripte, beginne mit QBOX Scripts und verifiziere die aktuellen Framework-, Bridge-, Inventar- und Abhängigkeitsanforderungen auf der Produktseite vor dem Kauf.

Platziere Qbox in der Framework-Entscheidung

Vergleiche das aktuelle Qbox-Rezept mit dem dedizierten Leitfaden zur QBCore-Architektur und dem vollständigen Entscheidungsleitfaden für ESX, QBCore und Qbox bevor du Produktionsdaten konvertierst.

Referenzdokumentation

Quelle: docs.qbox.re · Quelle: docs.qbox.re · Quelle: docs.qbox.re