Migra ESX a QBox: cosa viene trasferito, cosa si rompe e un elenco di controllo
Spostare un server FiveM da ESX a QBox: nulla si converte automaticamente, quindi pianifica wipe vs migrate, trova script che hanno bisogno di bridge, configura lo stack e segui una timeline.
Gestisci un server ESX e vuoi QBox. Prima di iniziare, devi sapere una cosa: nulla si trasferisce da solo. ESX e QBox usano tabelle diverse, identificatori di giocatore diversi, sistemi di articoli diversi e API diversi. Questa guida ti dice cosa significa, come scegliere tra un wipe e una migrazione, cosa ha bisogno di un bridge, e ti dà una timeline.
Cosa non viene trasferito automaticamente
| Parte | Perché non si trasferisce |
|---|---|
| Personaggi | ESX li memorizza in users, QBox in players con un citizen id e campi JSON |
| Denaro | ESX ha account per contanti, banca e denaro nero. QBox ha i suoi tipi di denaro |
| Articoli | I nomi degli articoli, i metadati e la tabella dell'inventario non sono gli stessi |
| Veicoli | ESX usa owned_vehicles, QBox ha la sua tabella di veicoli e formato di dati del veicolo |
| Lavori e gradi | Definiti nel database in ESX, nei file del framework in QBox |
| Script | Chiamano funzioni ESX che QBox non ha |
I tuoi giocatori mantengono il loro identificatore di licenza, quindi un personaggio convertito può ancora essere collegato alla persona giusta. Il resto deve essere mappato.
Wipe o migra
Wipe significa un server QBox nuovo e caratteri nuovi. È più pulito e molto più veloce. Si adatta a un server che è ancora piccolo, un server i cui dati sono un disastro, o uno che sta cambiando la sua intera direzione. Dillo ai tuoi giocatori chiaramente e presto.
Migra significa convertire i dati. Mantiene il progresso del giocatore, ma hai bisogno di uno script di conversione che legga le tue tabelle ESX e scriva righe QBox. Scrivilo per il tuo server, perché ogni server ESX ha tabelle diverse e colonne aggiuntive. Il denaro è facile da mappare. Il denaro nero, gli articoli personalizzati e le proprietà del veicolo si prendono cura. Un compromesso comune è migrare denaro e veicoli e restituire articoli a mano.
Qualunque cosa scegli, testa la conversione su una copia del database, mai su quello live.
Pianifica lo stack
QBox viene eseguito su uno stack che differisce da un server ESX tipico:
qbx_corecome frameworkox_lib,oxmysql,ox_inventoryeox_target
Vedi install QBox per i dettagli. Se il tuo server ESX utilizza già ox_inventory, ox_lib e ox_target, una buona parte dello stack è la stessa, ma i suoi dati vivono ancora nelle tabelle del framework, quindi non si trasferisce come è.
Script: converti, bridge o sostituisci
Esamina il tuo elenco di risorse e ordina ogni script:
- Script indipendenti dal framework (mappe, veicoli, suoni, strumenti standalone): di solito funzionano solo.
- Script che rilevano il framework (molti script di negozio supportano ESX, QBCore e QBox): funzionano, controlla la loro config per l'impostazione del framework.
- Script solo ESX: questi hanno bisogno di una di tre cose:
- Convertirlo tu stesso. La guida ESX a QBCore, convert an ESX script to QBCore, e poi convert a QBCore script to QBox mostra i cambiamenti.
- Usa un bridge che fornisci le funzioni ESX in cima a QBox, se accetti i livelli che aggiunge.
- Sostituiscilo con uno script nativo QBox. Spesso la scelta migliore per lavori, alloggi e script basati sull'inventario.
- Script di inventario: questi sono i più difficili, perché le definizioni degli articoli e l'inventario cambiano con il framework.
Scrivi l'elenco. È la tua stima di lavoro. Presta particolare attenzione agli script che gestiscono denaro, articoli o veicoli, poiché toccano i dati che converti.
Costruisci un server di prova per primo
- Crea un secondo server con la ricetta QBox (txAdmin recipes). Non lavorare mai su quello live.
- Copia le mappe, i veicoli e le risorse standalone.
- Aggiungi i script convertiti o sostituiti uno alla volta e riavvia dopo ogni, quindi sai quale si rompe. Vedi reading a script error.
- Importa una copia dei tuoi dati ESX, esegui lo script di conversione, e controlla il risultato unendoti con un account di test.
- Testa i cicli principali: unione, lavori, denaro, negozi, veicoli, alloggi.
Timeline elenco di controllo
Usa questo ordine, e lascia spazio per ogni passo:
- Decidi wipe o migra, e dì alla tua comunità il piano e la data.
- Elenca tutti i tuoi script e contrassegna ognuno come funziona, converti, bridge o sostituisci.
- Backup i file ESX e il database. Vedi backup your server.
- Costruisci il server di prova QBox.
- Converti o sostituisci gli script, quindi scrivi e testa la conversione dei dati se esegui la migrazione.
- Testa con giocatori veri se possibile, in una beta aperta.
- Correggi cosa trovano. Questo prende più tempo di quanto ti aspetti.
- Passa: annuncia il downtime, fai un ultimo backup di ESX, esegui la conversione su una copia nuova dei dati più recenti, e avvia QBox.
- Mantieni il backup ESX per un po', nel caso in cui tu debba tornare indietro.
Consiglio: non cambiare nient'altro nello stesso tempo. Un cambio di framework, una mappa nuova e un'economia nuova insieme rendono impossibile dire cosa si è rotto.
Se i tuoi giocatori hanno molto in gioco, esegui il server vecchio e quello nuovo in parallelo per un breve periodo. Se i tuoi script provengono da un negozio, controlla quali framework supporta ognuno prima di acquistare quelli nuovi, in modo da scegliere script che funzionano anche su QBox.
Elenco di controllo
| Sintomo | Correzione |
|---|---|
| Personaggi mancanti dopo il passaggio | Non si convertono automaticamente: scrivi una conversione o ricomincia fresco |
| Errori di script ESX su QBox | Convertilo, usa un bridge o sostituiscilo |
| Gli articoli scompaiono o si duplicano | Mappa i nomi degli articoli agli articoli ox_inventory e testa la conversione su una copia |
| Veicoli mancanti | Converti owned_vehicles nella tabella di veicoli QBox, incluse le proprietà |
| Denaro nero sparito | QBox non ha account di denaro nero per impostazione predefinita: usa un articolo o un tipo personalizzato |
| Non sono sicuro da dove iniziare | Costruisci un server di prova con la ricetta e sposta gli script uno alla volta |
Risposte rapide
Posso migrare un server ESX a QBox automaticamente?
No. I due framework memorizzano i personaggi, i soldi, gli articoli e i veicoli in tabelle e formati diversi, quindi hai bisogno di uno script di conversione scritto per i tuoi dati, o un nuovo inizio.
I miei script ESX funzionano su QBox?
Non come sono. Gli script ESX chiamano es_extended e funzioni ESX, quindi ognuno ha bisogno di essere convertito, un bridge, o una sostituzione scritta per QBox.
Dovrei fare un wipe o una migrazione?
Wipe se i tuoi dati sono disordinati o i giocatori sono pochi, poiché cominci pulito. Migra se i giocatori hanno progressi che contano, e testa la conversione su una copia prima di toccare il server live.
Script senza questo problema
Mic PhoneUn telefono pieghevole che si apre in un tablet e arriva sul telefono vero del giocatore.Vedi script →
Clothing DesignerDisegna vestiti dentro FiveM — pennello, livelli, import di immagini e IA — e poi indossali.Vedi script →
Shop CreatorCrea un negozio in meno di un minuto — proprietari, dipendenti, casseforti e rapine inclusi.Vedi script →