Migrar ESX para QBox: o que transfere, o que quebra e um checklist

Você executar um servidor ESX e quer QBox. Antes de começar, você precisa saber uma coisa: nada transfere por si só. ESX e QBox usam diferentes tabelas, diferentes identificadores de jogadores, diferentes sistemas de itens e diferentes APIs. Este guia diz o que isso significa, como escolher entre uma limpeza e uma migração, o que precisa de uma ponte, e fornece a você uma linha do tempo.

#O que não transfere automaticamente

Seus jogadores mantêm seu identificador de licença, portanto um personagem convertido ainda pode ser vinculado à pessoa certa. O resto tem que ser mapeado.

#Limpar ou migrar

Limpar significa um servidor QBox fresco e novos personagens. É mais limpo e muito mais rápido. Funciona para um servidor que ainda é pequeno, um servidor cujos dados são uma bagunça, ou um que está mudando toda sua direção. Diga a seus jogadores claramente e cedo.

Migrar significa converter os dados. Mantém o progresso do jogador, mas você precisa de um script de conversão que leia suas tabelas ESX e escreva linhas QBox. Escreva para seu próprio servidor, porque cada servidor ESX tem diferentes tabelas e colunas extras. Dinheiro é fácil de mapear. Dinheiro negro, itens customizados e propriedades de veículos requerem cuidado. Um compromisso comum é migrar dinheiro e veículos e devolver itens manualmente.

Qualquer que seja sua escolha, teste a conversão em uma cópia do banco de dados, nunca no ao vivo.

#Planeje a pilha

QBox é executado em uma pilha que difere de um servidor ESX típico:

• qbx_core como o framework
• ox_lib, oxmysql, ox_inventory e ox_target

Veja instale QBox para os detalhes. Se seu servidor ESX já usa ox_inventory, ox_lib e ox_target, uma boa parte da pilha é a mesma, mas seus dados ainda residem nas tabelas do framework, portanto não carrega como está.

#Scripts: converter, ponte ou substituir

Vá através de sua lista de recursos e ordene cada script:

1. Scripts independentes de framework (mapas, veículos, sons, ferramentas autônomas): geralmente apenas funcionam.
2. Scripts que detectam o framework (muitos scripts de loja suportam ESX, QBCore e QBox): eles funcionam, verifique sua config para a configuração de framework.
3. Scripts apenas ESX: estes precisam de uma de três coisas:
   • Converter você mesmo. O guia ESX para QBCore, converter um script ESX para QBCore, e depois converter um script QBCore para QBox mostram as mudanças.
   • Use uma ponte que fornece as funções ESX no topo do QBox, se você aceitar as camadas que adiciona.
   • Substitua por um script nativo QBox. Frequentemente a melhor escolha para trabalhos, habitação e scripts baseados em inventário.
4. Scripts de inventário: estes são os mais difíceis, porque definições de itens e o inventário mudam com o framework.

Escreva a lista. É sua estimativa de trabalho. Preste atenção especial aos scripts que lidam com dinheiro, itens ou veículos, já que eles tocam os dados que você converte.

#Construa um servidor de teste primeiro

1. Crie um segundo servidor com a receita QBox (receitas txAdmin). Nunca trabalhe no ao vivo.
2. Copie os mapas, veículos e recursos autônomos.
3. Adicione os scripts convertidos ou substituídos um de cada vez e reinicie após cada, para que você saiba qual quebra. Veja lendo um erro de script.
4. Importe uma cópia de seus dados ESX, execute o script de conversão e verifique o resultado entrando com uma conta de teste.
5. Teste os loops principais: entrada, trabalhos, dinheiro, lojas, veículos, habitação.

#Checklist de linha do tempo

Use esta ordem e deixe espaço para cada passo:

1. Decida limpar ou migrar, e diga à sua comunidade o plano e a data.
2. Liste todos os seus scripts e marque cada um como funciona, converte, ponte ou substitui.
3. Faça backup dos arquivos ESX e banco de dados. Veja faça backup do seu servidor.
4. Construa o servidor de teste QBox.
5. Converta ou substitua os scripts, então escreva e teste a conversão de dados se você migrar.
6. Teste com jogadores reais se possível, em uma beta aberta.
7. Corrija o que eles encontram. Isso leva mais tempo do que você espera.
8. Mude: anuncie o tempo de inatividade, faça um último backup de ESX, execute a conversão em uma cópia fresca dos dados mais recentes, e inicie QBox.
9. Mantenha o backup ESX por um tempo, caso você deva reverter.

Dica: não altere mais nada ao mesmo tempo. Uma mudança de framework, um novo mapa e uma nova economia juntos tornam impossível dizer o que quebrou.

Se seus jogadores têm muito em jogo, execute o servidor antigo e o novo em paralelo por um curto período. Se seus scripts vêm de uma loja, verifique quais frameworks cada um suporta antes de comprar novos, para que você escolha scripts que também funcionam no QBox.

#Checklist