Migracja ESX do QBox: co się przenosi, co się psuje i lista kontrolna
Przenoszenie serwera FiveM z ESX do QBox: nic się nie konwertuje automatycznie, więc zaplanuj wipe czy migrację, znajdź skrypty, które potrzebują mostów, ustaw stack i postępuj według osi czasu.
Uruchamiasz serwer ESX i chcesz QBox. Zanim zaczniesz, musisz wiedzieć jedną rzecz: nic się nie przenosi samo. ESX i QBox używają różnych tabel, różnych identyfikatorów graczy, różnych systemów przedmiotów i różnych API. Ten przewodnik mówi ci, co to oznacza, jak wybrać między wipeowaniem a migracją, co potrzebuje mostu i daje ci oś czasu.
Co się nie przenosi automatycznie
| Część | Dlaczego się nie przenosi |
|---|---|
| Postacie | ESX je przechowuje w users, QBox w players z identyfikatorem obywatela i polami JSON |
| Pieniądze | ESX ma konta dla gotówki, banku i czarnych pieniędzy. QBox ma własne typy pieniędzy |
| Przedmioty | Nazwy przedmiotów, metadane i tabela ekwipunku nie są takie same |
| Pojazdy | ESX używa owned_vehicles, QBox ma własną tabelę pojazdu i format danych pojazdu |
| Prace i stopnie | Zdefiniowane w bazie danych w ESX, w plikach frameworku w QBox |
| Skrypty | Wołają one funkcje ESX, które QBox nie ma |
Twoi gracze zachowują swój identyfikator licencji, więc skonwertowana postać może być wciąż powiązana z właściwą osobą. Reszta musi być zmapowana.
Wipeuj lub migruj
Wipeuj oznacza świeży serwer QBox i nowe postacie. Jest czystszy i znacznie szybszy. Pasuje do serwera, który jest wciąż mały, serwera, którego dane są bałaganem, lub tego, który zmienia całą swoją kierunek. Powiedz swoim graczom wyraźnie i wcześnie.
Migruj oznacza konwersję danych. Zachowuje postęp gracza, ale potrzebujesz skryptu konwersji, który czyta twoje tabele ESX i pisze wiersze QBox. Napisz to dla twojego własnego serwera, ponieważ każdy serwer ESX ma różne tabele i dodatkowe kolumny. Pieniądze są łatwe do zmapowania. Czarne pieniądze, niestandardowe przedmioty i właściwości pojazdu potrzebują opieki. Typowy kompromis to migracja pieniędzy i pojazdów i zwrot przedmiotów ręcznie.
Cokolwiek wybierzesz, testuj konwersję na kopii bazy danych, nigdy na żywej.
Zaplanuj stack
QBox działa na stacku, który różni się od typowego serwera ESX:
qbx_corejako frameworkox_lib,oxmysql,ox_inventoryiox_target
Przeczytaj install QBox dla szczegółów. Jeśli twój serwer ESX już używa ox_inventory, ox_lib i ox_target, dobra część stacku jest taka sama, ale jego dane wciąż żyją w tabelach frameworku, więc się nie przenoszą takie jakie są.
Skrypty: konwertuj, most czy zamień
Przejdź przez swoją listę zasobów i posortuj każdy skrypt:
- Skrypty niezależne od frameworku (mapy, pojazdy, dźwięki, narzędzia autonomiczne): zwykle po prostu działają.
- Skrypty, które wykrywają framework (wiele skryptów ze sklepów wspiera ESX, QBCore i QBox): działają, sprawdź ich konfigurację dla ustawienia frameworku.
- Skrypty tylko ESX: te potrzebują jednej z trzech rzeczy:
- Konwertuj sam. Przewodnik ESX do QBCore, konwertuj skrypt ESX do QBCore, a następnie konwertuj skrypt QBCore do QBox pokazuje zmiany.
- Użyj mostu, który dostarcza funkcje ESX na topie QBox, jeśli akceptujesz warstwy, które dodaje.
- Zamień go na natywny skrypt QBox. Często najlepszy wybór dla prac, domów i skryptów opartych na ekwipunku.
- Skrypty ekwipunku: te są najtrudniejsze, ponieważ definicje przedmiotów i ekwipunek zmieniają się z frameworkiem.
Napisz listę. To twój szacunek pracy. Zwróć szczególną uwagę na skrypty, które obsługują pieniądze, przedmioty lub pojazdy, ponieważ dotykają danych, które konwertujesz.
Najpierw zbuduj serwer testowy
- Utwórz drugi serwer z przepisem QBox (przepisy txAdmin). Nigdy nie pracuj na żywym.
- Skopiuj mapy, pojazdy i zasoby autonomiczne.
- Dodaj konwertowane lub zamienione skrypty jeden za razem i uruchom ponownie po każdym, aby wiedzieć, który się psuje. Przeczytaj czytanie błędu skryptu.
- Zaimportuj kopię swoich danych ESX, uruchom skrypt konwersji i sprawdź wynik, dołączając z kontem testowym.
- Testuj główne pętle: dołączanie, prace, pieniądze, sklepy, pojazdy, mieszkania.
Lista kontrolna osi czasu
Użyj tej kolejności i zostaw przestrzeń dla każdego kroku:
- Zdecyduj wipeuj czy migruj i powiedz swojej społeczności plan i datę.
- Wymień wszystkie skrypty i oznacz każdy jako działa, konwertuj, most czy zamień.
- Utwórz kopię zapasową plików ESX i bazy danych. Przeczytaj backup your server.
- Zbuduj serwer testowy QBox.
- Konwertuj czy zamień skrypty, potem napisz i testuj konwersję danych, jeśli migrujesz.
- Testuj z rzeczywistymi graczami, jeśli to możliwe, w otwartej becie.
- Napraw to, co znajdą. To trwa dłużej niż oczekujesz.
- Przełącz: ogłoś czas przestoju, utwórz ostatnią kopię zapasową ESX, uruchom konwersję na świeżej kopii najnowszych danych i uruchom QBox.
- Zachowaj kopię zapasową ESX przez chwilę, na wypadek, gdybyś musiał się wycofać.
Porada: nie zmieniaj niczego innego w tym samym czasie. Zmiana frameworku, nowa mapa i nowa ekonomia razem sprawiają, że niemożliwe jest powiedzenie, co się psuje.
Jeśli twoi gracze mają wiele na czekaniu, uruchom stary i nowy serwer równolegle przez krótki czas. Jeśli twoje skrypty pochodzą ze sklepu, sprawdzaj, które frameworki każdy wspiera, zanim kupisz nowe, abyś wybrał skrypty, które również działają na QBox.
Lista kontrolna
| Objaw | Naprawa |
|---|---|
| Postacie brakują po przełączeniu | Nie konwertują się automatycznie: napisz konwersję lub zacznij na nowo |
| Błędy skryptu ESX na QBox | Konwertuj to, użyj mostu czy zamień go |
| Przedmioty znikają lub duplikują się | Mapuj nazwy przedmiotów na przedmioty ox_inventory i testuj konwersję na kopii |
| Pojazdy brakują | Konwertuj owned_vehicles na tabelę pojazdu QBox, włącznie z właściwościami |
| Czarne pieniądze znikły | QBox domyślnie nie ma konta czarnych pieniędzy: użyj przedmiotu czy własnego typu |
| Nie wiem, od czego zacząć | Zbuduj serwer testowy z przepisem i przenieś skrypty jeden za razem |
Szybkie odpowiedzi
Czy mogę automatycznie przeprowadzić migrację serwera ESX do QBox?
Nie. Dwa frameworki przechowują postacie, pieniądze, przedmioty i pojazdy w różnych tabelach i formatach, więc potrzebujesz skryptu konwersji napisanego dla twoich danych, lub świeży start.
Czy moje skrypty ESX działają na QBox?
Nie takie jakie są. Skrypty ESX wołają es_extended i funkcje ESX, więc każdy potrzebuje konwersji, mostu lub zamiany napisanej dla QBox.
Czy powinienem wipeować czy migrować?
Wipeuj, jeśli twoje dane są bałaganem lub graczy jest mało, ponieważ zaczynasz czystą kartą. Migruj, jeśli gracze mają postęp, który ma znaczenie, i testuj konwersję na kopii, zanim dotkniesz serwera na żywo.
Skrypty bez tego problemu
Mic PhoneSkładany telefon, który rozkłada się w tablet i działa też na prawdziwym telefonie gracza.Zobacz skrypt →
Clothing DesignerProjektuj ubrania w FiveM — pędzel, warstwy, import obrazów i AI — a potem je noś.Zobacz skrypt →
Shop CreatorZbuduj sklep w niecałą minutę — właściciele, pracownicy, sejfy i napady w zestawie.Zobacz skrypt →