Migrar de ESX a QBox: qué se transfiere, qué se rompe y una lista de verificación

Ejecutas un servidor de ESX y quieres QBox. Antes de comenzar, necesitas saber una cosa: nada se transfiere por sí solo. ESX y QBox usan diferentes tablas, diferentes identificadores de jugador, diferentes sistemas de artículos y diferentes APIs. Esta guía te dice qué significa eso, cómo elegir entre un wipe y una migración, qué necesita un puente, y te proporciona una cronología.

#Qué no se transfiere automáticamente

Tus jugadores mantienen su identificador de licencia, así que un personaje convertido aún puede estar vinculado a la persona correcta. El resto tiene que ser mapeado.

#Wipe o migrar

Wipe significa un servidor de QBox nuevo y personajes nuevos. Es más limpio y mucho más rápido. Se adapta a un servidor que aún es pequeño, un servidor cujos datos son un desastre, o uno que está cambiando su dirección completa. Dile a tus jugadores claramente y con anticipación.

Migrar significa convertir los datos. Mantiene el progreso del jugador, pero necesitas un script de conversión que lea tus tablas de ESX y escriba filas de QBox. Escríbelo para tu propio servidor, porque cada servidor de ESX tiene diferentes tablas y columnas adicionales. El dinero es fácil de mapear. El dinero negro, los artículos personalizados y las propiedades del vehículo requieren cuidado. Un compromiso común es migrar dinero y vehículos y devolver artículos a mano.

Sea cual sea que elijas, prueba la conversión en una copia de la base de datos, nunca la activa.

#Planifica el stack

QBox se ejecuta en un stack que difiere de un servidor típico de ESX:

• qbx_core como el framework
• ox_lib, oxmysql, ox_inventory y ox_target

Ver instalar QBox para los detalles. Si tu servidor ESX ya usa ox_inventory, ox_lib y ox_target, una buena parte del stack es la misma, pero sus datos aún viven en las tablas del framework, así que no se traslada como está.

#Scripts: convertir, puente o reemplazar

Repasa tu lista de recursos y ordena cada script:

1. Scripts independientes del framework (mapas, vehículos, sonidos, herramientas independientes): generalmente funcionan.
2. Scripts que detectan el framework (muchos scripts de tienda soportan ESX, QBCore y QBox): funcionan, verifica su config para la configuración del framework.
3. Scripts solo de ESX: estos necesitan una de tres cosas:
   • Convertirlo tú mismo. La guía de ESX a QBCore, convertir un script de ESX a QBCore, y luego convertir un script de QBCore a QBox muestra los cambios.
   • Usa un puente que proporcione las funciones de ESX sobre QBox, si aceptas las capas que agrega.
   • Reemplázalo con un script nativo de QBox. A menudo la mejor opción para trabajos, vivienda y scripts basados en inventario.
4. Scripts de inventario: estos son los más difíciles, porque las definiciones de artículos y el inventario cambian con el framework.

Escribe la lista. Es tu estimación de trabajo. Presta especial atención a los scripts que manejan dinero, artículos o vehículos, ya que tocan los datos que conviertes.

#Construye un servidor de prueba primero

1. Crea un segundo servidor con la receta de QBox (recetas de txAdmin). Nunca trabajes en el activo.
2. Copia los mapas, vehículos y recursos independientes.
3. Agrega los scripts convertidos o reemplazados uno a la vez y reinicia después de cada uno, para que sepas cuál se rompe. Ver leer un error de script.
4. Importa una copia de tus datos de ESX, ejecuta el script de conversión, y verifica el resultado uniéndote con una cuenta de prueba.
5. Prueba los bucles principales: unir, trabajos, dinero, tiendas, vehículos, vivienda.

#Cronología lista de verificación

Usa este orden, y deja espacio para cada paso:

1. Decide wipe o migrar, y dile a tu comunidad el plan y la fecha.
2. Enumera todos tus scripts y marca cada uno como funciona, convertir, puente o reemplazar.
3. Haz una copia de seguridad de los archivos y la base de datos de ESX. Ver hacer copia de seguridad de tu servidor.
4. Construye el servidor de prueba de QBox.
5. Convierte o reemplaza los scripts, luego escribe y prueba la conversión de datos si migras.
6. Prueba con jugadores reales si es posible, en una beta abierta.
7. Arregla lo que encuentren. Esto toma más tiempo del que esperas.
8. Cambia: anuncia downtime, toma una última copia de seguridad de ESX, ejecuta la conversión en una copia nueva de los datos más recientes, e inicia QBox.
9. Mantén la copia de seguridad de ESX por un tiempo, en caso de que debas hacer rollback.

Consejo: no cambies nada más al mismo tiempo. Un cambio de framework, un nuevo mapa y una nueva economía juntos hacen imposible saber qué se rompió.

Si tus jugadores tienen mucho en juego, ejecuta el servidor antiguo y el nuevo en paralelo por un tiempo corto. Si tus scripts vienen de una tienda, verifica qué frameworks soporta cada uno antes de comprar nuevos, para que selecciones scripts que también funcionen en QBox.

#Lista de verificación