ESX Legacy es un framework de código abierto para roleplay en FiveM. Para un servidor nuevo, utiliza la plantilla oficial de ESX Legacy en txAdmin o sigue la documentación oficial de instalación completa. Instalar únicamente la carpeta es_extended no configura un servidor completo, porque el conjunto de sistemas compatible incluye tareas de base de datos, recursos necesarios y una configuración de inicio ordenada.
Puntos clave
- Utiliza la receta oficial de ESX Legacy de txAdmin para una nueva instalación.
es_extendedes 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.
El repositorio oficial del core de ESX es la fuente correcta del código actual del core. Su manifiesto de es_extended declara oxmysql como dependencia. Utiliza la documentación oficial y el historial de versiones para identificar lo que tienes; evita paquetes de procedencia incierta anunciados únicamente 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.
- Prepara un entorno FXServer actual y abre el flujo de configuración de txAdmin.
- Crea una nueva implementación de receta utilizando la plantilla oficial de ESX Legacy.
- Proporciona la clave del servidor y la configuración de la base de datos documentadas.
- Permite que la receta despliegue la base de datos y los recursos requeridos.
- Revisa la configuración generada, los permisos y el orden de los recursos.
- 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 alcance completo. Incluye los requisitos de oxmysql y spawnmanager, la importación de legacy.sql, el conjunto de recursos del core y complementarios, las exclusiones y el orden de inicio necesario. Sigue esa página como un único procedimiento vigente. No la reduzcas a mover es_extended, editar un archivo de configuración y añadir una línea ensure.
| Área de instalación | Pruebas para conservar |
|---|---|
| Núcleo y complementos | Repositorio, etiqueta o commit exacto para cada recurso ESX. |
| Base de datos | Configuración de conexión, SQL importado y una copia de seguridad previa al cambio. |
| Dependencias | oxmysql, spawnmanager y cualquier biblioteca específica del recurso. |
| Orden | Las instrucciones ensure documentadas y cualquier exclusión deliberada. |
| Verificación | Registros de inicio, persistencia de personajes y verificaciones de permisos. |
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.
- Compara esquemas y migraciones SQL antes de importarlos.
- Resuelve los cambios principales personalizados de forma explícita en lugar de sobrescribirlos silenciosamente.
- Comprueba si han cambiado los exports, eventos o identificadores de cada recurso que se integra con el framework.
- Prueba trabajos, grupos y comandos permitidos y denegados.
- Revisa los registros del cliente, servidor y base de datos bajo acciones representativas.
- 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.