Guía del Framework ESX: Instalación Oficial, Actualizaciones y Compatibilidad

ESX Legacy es un framework de roleplay de código abierto para FiveM. Para un nuevo servidor, utilice la plantilla oficial de ESX Legacy en txAdmin o siga la documentación de instalación oficial completa. Instalar solo la es_extended carpeta no es una configuración completa del servidor porque el stack soportado incluye trabajo de base de datos, recursos requeridos y una configuración de inicio ordenada.

Puntos clave

• Utiliza la receta oficial de ESX Legacy de txAdmin para una nueva instalación.
• es_extended es la base principal, no el servidor de roleplay completo.
• La ruta manual documentada incluye oxmysql, spawnmanager, SQL, exclusiones y orden de recursos.
• Antes de una actualización, identifica la versión exacta de ESX o la bifurcación y haz una copia de seguridad tanto de la base de datos como de los recursos.
• Verifica cada script de terceros con el framework actual, el inventario, la biblioteca de la base de datos, los eventos, las exportaciones y las dependencias.

Qué proporciona ESX Legacy

ESX proporciona una base de framework para datos de jugadores y personajes, y para recursos que se integran con sus API y convenciones. Los trabajos, el inventario, la vivienda, la banca, los teléfonos y otros sistemas de juego son recursos separados o partes de una receta seleccionada. Su presencia y comportamiento dependen del stack actual, no solo del hecho de que es_extended está instalado.

La guía oficial Repositorio principal de ESX es la fuente correcta para el código principal actual. Su es_extended manifiesto declara oxmysql como una dependencia. Utilice la documentación oficial y el historial de lanzamientos para identificar lo que tiene; evite un paquete aleatorio anunciado solo como el último ZIP de ESX.

Instala un nuevo servidor ESX con txAdmin

El tutorial oficial del servidor utiliza el desplegador de recetas txAdmin incluido en FXServer. Selecciona la plantilla ESX Legacy y completa la configuración guiada actual en lugar de copiar una carpeta principal en un directorio de recursos vacío.

1. Prepara un entorno FXServer actual y abre el flujo de configuración de txAdmin.
2. Crea una nueva implementación de receta utilizando la plantilla oficial de ESX Legacy.
3. Proporciona la clave del servidor y la configuración de la base de datos documentadas.
4. Permite que la receta despliegue la base de datos y los recursos requeridos.
5. Revisa la configuración generada, los permisos y el orden de los recursos.
6. Inicia el servidor de prueba y verifica la creación de personajes, la persistencia, los trabajos, los permisos y los registros.

Mantén las credenciales fuera de los archivos compartidos y las capturas de pantalla. Después de la implementación, registra las versiones exactas del repositorio o lanzamiento para que las comprobaciones de compatibilidad posteriores se basen en pruebas en lugar de una etiqueta genérica de ESX.

Utiliza la ruta de instalación manual solo cuando sea necesario

La documentación oficial de instalación manual define el límite completo. Cubre los requisitos de oxmysql y spawnmanager, la importación de legacy.sql, el conjunto de recursos principales y complementarios, exclusiones y el orden de inicio requerido. Sigue esa página como un único procedimiento actual. No lo reduzcas a mover es_extended, editar un archivo de configuración y agregar una ensure línea.

Actualiza un servidor ESX existente de forma segura

Primero identifica si el servidor ejecuta ESX Legacy actual, una versión anterior o una bifurcación con cambios principales personalizados. Registra el esquema de base de datos actual, las versiones de recursos y las modificaciones locales. Crea una copia de seguridad restaurable de la base de datos y una instantánea de recursos/configuración antes de reemplazar cualquier cosa.

Lee las notas de migración y lanzamiento entre la versión desplegada y la versión objetivo. Prueba la actualización completa en el entorno de prueba con datos de producción representativos. Una actualización del núcleo puede afectar las exportaciones, eventos, datos de jugadores, tablas de base de datos, integraciones de inventario y scripts dependientes. Valida las reconexiones y reinicios, así como un personaje nuevo.

1. Compara esquemas y migraciones SQL antes de importarlos.
2. Resuelve los cambios principales personalizados de forma explícita en lugar de sobrescribirlos silenciosamente.
3. Comprueba si han cambiado los exports, eventos o identificadores de cada recurso que se integra con el framework.
4. Prueba trabajos, grupos y comandos permitidos y denegados.
5. Revisa los registros del cliente, servidor y base de datos bajo acciones representativas.
6. Conserva los archivos anteriores y la copia de seguridad de la base de datos correspondiente hasta que se acepte el despliegue.

Elige un script compatible con ESX

Lee la información específica del producto sobre entrega, licencia, actualización y soporte. Instala en un servidor de prueba coincidente y prueba los caminos de fallo, incluyendo roles no autorizados y eventos repetidos. Una restricción visible de la interfaz de usuario no es un sustituto de la validación del lado del servidor.

ESX, QBCore o Qbox

No existe un marco universal mejor establecido por las fuentes oficiales. ESX es a menudo la opción de menor riesgo cuando los datos de producción existentes, los scripts y los procedimientos del equipo ya dependen de ESX y ningún beneficio de migración probado supera el costo de conversión. QBCore es una API y un ecosistema de recursos separados. Qbox tiene un puente QB documentado, pero eso no hace que los recursos específicos de ESX sean automáticamente portátiles.

Usa una comparación de frameworks basada en los recursos requeridos, conocimiento del equipo, migración de datos, documentación actual y capacidad de retroceso. Al considerar un cambio, haz un inventario de identidades, dinero, trabajos, inventario, vehículos, vivienda, teléfonos, banca, permisos y eventos personalizados antes de elegir un objetivo.