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_core jako framework
  • ox_lib, oxmysql, ox_inventory i ox_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:

  1. Skrypty niezależne od frameworku (mapy, pojazdy, dźwięki, narzędzia autonomiczne): zwykle po prostu działają.
  2. Skrypty, które wykrywają framework (wiele skryptów ze sklepów wspiera ESX, QBCore i QBox): działają, sprawdź ich konfigurację dla ustawienia frameworku.
  3. 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.
  4. 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

  1. Utwórz drugi serwer z przepisem QBox (przepisy txAdmin). Nigdy nie pracuj na żywym.
  2. Skopiuj mapy, pojazdy i zasoby autonomiczne.
  3. 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.
  4. Zaimportuj kopię swoich danych ESX, uruchom skrypt konwersji i sprawdź wynik, dołączając z kontem testowym.
  5. 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:

  1. Zdecyduj wipeuj czy migruj i powiedz swojej społeczności plan i datę.
  2. Wymień wszystkie skrypty i oznacz każdy jako działa, konwertuj, most czy zamień.
  3. Utwórz kopię zapasową plików ESX i bazy danych. Przeczytaj backup your server.
  4. Zbuduj serwer testowy QBox.
  5. Konwertuj czy zamień skrypty, potem napisz i testuj konwersję danych, jeśli migrujesz.
  6. Testuj z rzeczywistymi graczami, jeśli to możliwe, w otwartej becie.
  7. Napraw to, co znajdą. To trwa dłużej niż oczekujesz.
  8. Przełącz: ogłoś czas przestoju, utwórz ostatnią kopię zapasową ESX, uruchom konwersję na świeżej kopii najnowszych danych i uruchom QBox.
  9. 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 →

Czytaj dalej