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 Installationspfad ist das QBox beliebte Rezept in txAdmin.
• Die QB-Brücke kann bei kompatiblen Ressourcen helfen, garantiert aber nicht für jedes QBCore-Skript.
• Die Migration umfasst Konfiguration, Grade, Inventar und Datenbankkonvertierung sowie Ressourcen-Test.
• 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 seinen Ursprung in QBCore. Das Projekt hat seitdem seinen eigenen Kern und verwandte Ressourcen entwickelt. Seine Kompatibilitätsschicht dient dazu, die Nutzung vieler QB-Ressourcen zu erleichtern, während Teams die aktuellen Qbox-APIs übernehmen, aber Qbox sollte als eigenes Framework und Rezept bewertet werden.

Der aktuelle qbx_core Manifest deklariert direkt ox_lib Und oxmysql Abhängigkeiten. Das offizielle Rezept bringt Qbox und ausgewählte Drittanbieter-Ressourcen in einen vollständigen Start-Stack zusammen. Da sich der Inhalt des Rezepts ändern kann, verlinke auf das aktuelle Rezept, anstatt eine lange Abhängigkeitsliste in einem Evergreen-Installationshandbuch einzufrieren.

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 beliebte Rezept anstelle des manuellen Zusammenstellens eines teilweisen Kerns.
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 keine Anbieter-Manifests durch verkürzte Beispiele, die aus einem Leitfaden kopiert wurden. Installiere die offiziellen Releases oder Rezeptversionen und behandle ihre Manifests als Teil des Abhängigkeitsvertrags. Wenn ein Update eine Kern- oder Bibliotheksanforderung ändert, vergleiche die Versionsdokumentation mit jeder abhängigen Ressource vor der Bereitstellung.

Qbox und die QBCore-Brücke

Der offizielle Qbox-Umwandlungsleitfaden erklärt, wie der QB-Brücke die Kompatibilität unterstützt, während die APIs schrittweise ersetzt werden. Die Qbox-FAQ besagt, dass die meisten korrekt geschriebenen QBCore-Skripte über diese Brücke funktionieren können, und identifiziert dann wichtige Ausnahmen: Ressourcen, die direkt in Datenbanktabellen greifen, interne Kerndateien lesen oder ändern oder sich auf nicht unterstütztes Verhalten verlassen, müssen möglicherweise geändert werden.

Ein als QBCore-kompatibel gekennzeichnetes Produkt sollte daher gegen Qbox als separates Ziel getestet werden. Frage, ob es nur dokumentierte, bridge-abgedeckte APIs verwendet, welche Inventar- und Zielsysteme es erwartet und ob sein SQL ein QB-Schema annimmt, das Qbox nicht auf die gleiche Weise exponiert.

Migrationscheckliste für einen bestehenden QBCore-Server

1. Einfrieren und Inventar: 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. Konvertiere Noten und Daten: folge den aktuellen offiziellen Schritten für numerische Job- und Gang-Grade, 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: Überprüfe Server-, Client- und Datenbankprotokolle und vergleiche die wichtigsten Datensätze vor dem Wechsel.
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 nur weil eine Seite verspricht, dass ein bestimmtes Inventar, eine Datenbankbibliothek oder ein Framework automatisch schneller ist. Die Leistung hängt vom vollständigen Ressourcensatz, der Datenbanklast, dem Spielerverhalten, Artefakten und der Serverkonfiguration ab. Wenn die Leistung ein Entscheidungsfaktor ist, benchenmarke repräsentative Aktionen in äquivalenten Umgebungen und behalte die Protokolle bei.

Produktionsvalidierung

Teste erfolgreiche und abgelehnte Aktionen, nicht nur den Happy Path. Bestätige, dass Geldänderungen nur einmal stattfinden, Job- und Gangberechtigungen nicht autorisierte Spieler ablehnen, das Inventar bei Wiederverbindungen konsistent bleibt, besessene Fahrzeuge bestehen bleiben und administrative Aktionen protokolliert werden. Client-Anfragen müssen auf dem Server validiert werden; ein clientausgelöstes Ereignis ist nicht sicher, nur weil der UI es vor normalen Spielern verbirgt.

Nutzen Sie den Framework-Vergleich für die breitere ESX/QBCore/Qbox-Entscheidung. Bei der Auswahl aus dem bezahlte FiveM-Skript-Katalog, beginnen Sie mit QBOX-Skripte und verifizieren Sie die aktuellen Framework-, Bridge-, Inventar- und Abhängigkeitsanforderungen auf der Produktseite vor dem Kauf.