Bezpośrednia odpowiedź: Migracja ESX do QBCore to kontrolowane przepisanie i migracja danych, a nie zmiana frameworka. Zbuduj czysty serwer stagingowy QBCore, zinwentaryzuj każdą zależność ESX, zdefiniuj jawne mapowanie danych pole po polu, przenieś zasoby do aktualnych API, przećwicz rollback i przełącz się dopiero po przejściu kontroli referencyjnych i rozgrywki.
Co należy zmapować
| Powierzchnia | Decyzja o migracji | Dowód akceptacji |
|---|---|---|
| Tożsamość gracza | Zmapuj stare identyfikatory i postacie do identyfikatorów obywateli QBCore bez kolizji. | Każdy próbkowany gracz jest powiązany z jednym zamierzonym rekordem postaci. |
| Pieniądze i konta | Mapuj każde konto jawnie; nie zakładaj równych nazw ani semantyki. | Suma przed i po uzgodnieniu dla zamrożonej próbki. |
| Prace i stopnie | Zdefiniuj mapowanie dla każdej aktywnej pracy i stopnia, w tym dla bezrobotnych. | Uprawnienia i przepływy płatności pasują do zatwierdzonej mapy. |
| Przedmioty i ekwipunek | Mapuj nazwy, metadane, wagę, sloty i własność magazynu. | Brak osieroconych nazw przedmiotów; ekwipunki pozostają po ponownym połączeniu. |
| Pojazdy i nieruchomości | Normalizuj klucze własności, tablice rejestracyjne, garaże i pola stanu. | Owned records remain unique and accessible. |
| Custom resources | Replace ESX callbacks, events and player APIs with documented QBCore equivalents. | Each end-to-end resource flow passes on staging. |
Migration sequence
- Freeze schema and resource changes; take a restorable database and file backup.
- Build QBCore from its maintained recipe or repository on an isolated staging environment.
- Export a schema inventory and write a versioned mapping for identities, accounts, jobs, items, vehicles and custom tables.
- Make transforms idempotent and run them only against a disposable database copy.
- Port resources one at a time using current QBCore documentation; do not rely on blind event-name replacement.
- Pogodź liczbę wierszy, unikalność, sumy i odwołania osierocone, a następnie uruchom rozgrywkę, połącz ponownie i uruchom testy restartu.
- Przećwicz wycofywanie zmian. Podczas przełączania zatrzymaj zapisy, wykonaj ostateczną kopię zapasową, uruchom ponownie sprawdzony proces i zweryfikuj przed ponownym otwarciem połączeń.
Nie kopiuj generycznego szablonu SQL
Schematy ESX i QBCore różnią się w zależności od wydania, przepisu, zasobów i niestandardowych zasobów. Generyczne polecenie CREATE TABLE lub INSERT może cicho odrzucić metadane lub utworzyć nieprawidłowe wartości domyślne. Wygeneruj SQL migracji z dwóch faktycznie zainstalowanych schematów, przejrzyj ograniczenia i zachowaj mapę tożsamości z wersji starszej do nowej w celu wsparcia i audytu.
Zakres i ograniczenia
To jest plan kontroli migracji, a nie wykonywalny SQL dla nieznanego serwera. Nie szacuje godzin ani nie obiecuje bezstratnej konwersji. Zaszyfrowane lub zdeponowane zasoby mogą nie być przenośne. Sprawdź licencje, bieżące API frameworka i prawa do migracji każdego pakietu przed rozpoczęciem pracy.