Migriere ESX zu QBox: Was wird übertragen, was bricht und eine Checkliste

Du läufst einen ESX-Server und du möchtest QBox. Bevor du startest, musst du eine Sache wissen: Nichts wird sich automatisch übertragen. ESX und QBox verwenden verschiedene Tabellen, verschiedene Spieler-Identifier, verschiedene Item-Systeme und verschiedene APIs. Dieser Leitfaden sagt dir, was das bedeutet, wie du zwischen einem Wipe und einer Migration wählst, was eine Brücke braucht und gibt dir eine Zeitleiste.

#Was wird sich nicht automatisch übertragen

Deine Spieler behalten ihren License-Identifier, daher kann ein konvertierter Charakter immer noch mit der richtigen Person verlinkt werden. Der Rest muss gemappt werden.

#Wipe oder Migrieren

Wipe bedeutet einen frischen QBox-Server und neue Charaktere. Es ist sauberer und viel schneller. Es passt zu einem Server, der noch klein ist, einem Server, dessen Daten durcheinander sind, oder einem, der seine ganze Richtung ändert. Teile deinen Spielern deutlich und früh mit.

Migrieren bedeutet, die Daten zu konvertieren. Es hält den Spieler-Fortschritt, aber du brauchst ein Konvertierungs-Skript, das deine ESX-Tabellen liest und QBox-Zeilen schreibt. Schreibe es für deinen eigenen Server, weil jeder ESX-Server verschiedene Tabellen und zusätzliche Spalten hat. Geld ist leicht zu mappen. Schwarzgeld, benutzerdefinierte Gegenstände und Fahrzeug-Eigenschaften passen auf. Ein häufiger Kompromiss ist, Geld und Fahrzeuge zu migrieren und Gegenstände von Hand zurückzugeben.

Was immer du wählst, teste die Konvertierung auf einer Kopie der Datenbank, nie der Live-Datenbank.

#Plane den Stack

QBox läuft auf einem Stack, der sich von einem typischen ESX-Server unterscheidet:

• qbx_core als Framework
• ox_lib, oxmysql, ox_inventory und ox_target

Siehe install QBox für die Details. Wenn dein ESX-Server bereits ox_inventory, ox_lib und ox_target verwendet, ist ein guter Teil des Stacks gleich, aber seine Daten leben immer noch in den Framework-Tabellen, daher wird es sich nicht so übertragen.

#Skripte: Konvertieren, Brücke oder Ersetzen

Gehe durch deine Ressourcenliste und sortiere jedes Skript:

1. Framework-unabhängige Skripte (Karten, Fahrzeuge, Sounds, Standalone-Tools): Sie funktionieren normalerweise.
2. Skripte, die das Framework erkennen (viele Store-Skripte unterstützen ESX, QBCore und QBox): Sie funktionieren, überprüfe ihre Config für die Framework-Einstellung.
3. ESX-nur Skripte: Diese brauchen eine von drei Sachen:
   • Konvertiere es selbst. Der ESX zu QBCore Leitfaden, convert an ESX script to QBCore, und dann convert a QBCore script to QBox zeigen die Änderungen.
   • Verwende eine Brücke, die die ESX-Funktionen auf QBox bereitstellt, wenn du die Schichten akzeptierst, die es hinzufügt.
   • Ersetze es mit einem QBox-nativen Skript. Oft die beste Wahl für Jobs, Wohnen und Inventar-basierten Skripten.
4. Inventar-Skripte: Diese sind am schwierigsten, weil Item-Definitionen und das Inventar sich mit dem Framework ändern.

Schreibe die Liste auf. Das ist deine Arbeitsschätzung. Achte besonders auf Skripte, die Geld, Gegenstände oder Fahrzeuge verarbeiten, da sie die Daten, die du konvertierst, berühren.

#Baue einen Test-Server zuerst auf

1. Erstelle einen zweiten Server mit dem QBox-Rezept (txAdmin recipes). Arbeite niemals auf dem Live-Server.
2. Kopiere die Karten, Fahrzeuge und Standalone-Ressourcen.
3. Füge die konvertierten oder ersetzten Skripte nacheinander hinzu und starte nach jedem neu, damit du weißt, welcher kaputt geht. Siehe reading a script error.
4. Importiere eine Kopie deiner ESX-Daten, führe das Konvertierungs-Skript aus und überprüfe das Ergebnis, indem du mit einem Test-Konto beitrittst.
5. Teste die Haupt-Schleifen: Beitritt, Jobs, Geld, Shops, Fahrzeuge, Wohnen.

#Zeitleisten-Checkliste

Verwende diese Reihenfolge und lasse Raum für jeden Schritt:

1. Entscheide Wipe oder Migrieren und teile deiner Community den Plan und das Datum mit.
2. Liste alle deine Skripte auf und markiere jeden als funktioniert, konvertieren, Brücke oder Ersetzen.
3. Sicherung die ESX-Dateien und die Datenbank. Siehe backup your server.
4. Baue den QBox-Test-Server auf.
5. Konvertiere oder ersetze die Skripte, dann schreibe und teste die Daten-Konvertierung, wenn du migrierst.
6. Teste mit echten Spielern, wenn möglich, in einer offenen Beta.
7. Behebe was sie finden. Das dauert länger als du erwartest.
8. Wechsel: kündige Ausfallzeit an, mache eine letzte Sicherung von ESX, führe die Konvertierung auf einer frischen Kopie der neuesten Daten aus und starte QBox.
9. Halte die ESX-Sicherung eine Weile, falls du zurückrollen musst.

Tipp: Ändere nicht gleichzeitig sonst noch etwas. Ein Framework-Wechsel, eine neue Karte und eine neue Wirtschaft zusammen machen es unmöglich zu sagen, was kaputt ging.

Wenn deine Spieler viel auf dem Spiel haben, führe den alten und neuen Server eine kurze Zeit parallel. Wenn deine Skripte von einem Store kommen, überprüfe, welche Frameworks jeder unterstützt, bevor du neue kaufst, damit du Skripte wählst, die auch auf QBox funktionieren.

#Checkliste