Configuración de txAdmin y recetas: despliega un servidor FiveM paso a paso

Descargaste los artefactos del servidor de FiveM, los iniciaste, y ahora txAdmin está pidiendo un PIN, una cuenta y una plantilla. Esta guía te guía a través del primer inicio, vinculando tu cuenta de Cfx.re, eligiendo una receta y qué sucede durante el despliegue.

#Primer inicio y el PIN

En Windows, ejecuta FXServer.exe. En Linux, comienza el run.sh de los artefactos. El primer inicio imprime una URL de txAdmin y un PIN único en la consola. Abre la URL en tu navegador e ingresa el PIN. Solo la persona que puede leer la consola del servidor puede hacer esto, que es el punto.

El PIN solo funciona una vez. Si lo pierdes, detén el servidor e inicia de nuevo para obtener uno nuevo, mientras no hayas terminado la configuración de la cuenta. Si ya lo hiciste y olvidaste tu login, mira txAdmin olvidé contraseña.

#Vincula tu cuenta de Cfx.re

txAdmin te pide crear una cuenta maestra. La vinculas a tu cuenta de Cfx.re, que es la misma cuenta que usas en el foro de FiveM y en el Portal de Cfx.re. Inicia sesión con Cfx.re cuando se solicite, luego elige una contraseña de copia de seguridad para la cuenta para que aún puedas iniciar sesión si el login de Cfx.re está caído.

Mantén esa contraseña en un lugar seguro. Añadirás otros admins más tarde desde la página de admin de txAdmin, cada uno con sus propios permisos.

#Nombre del servidor y tipo de despliegue

El asistente de configuración pide un nombre de servidor, luego el tipo de despliegue. La redacción cambia entre versiones de txAdmin, pero verás opciones a lo largo de estas líneas:

• Recetas populares: plantillas prefabricadas, incluyendo ESX Legacy, QBCore y QBox.
• Plantilla de URL remota: una receta que pegas desde un enlace, por ejemplo una del repositorio propio del framework.
• Plantilla local o receta personalizada: tu propio archivo de receta.
• Datos de servidor existentes: ya tienes una carpeta de datos del servidor con un server.cfg y quieres que txAdmin la ejecute.

Si este es un nuevo servidor, elige una receta popular. Los frameworks actualizan sus recetas, así que obtienes una configuración actual sin buscar enlaces de descarga.

#Elegir una plantilla

¿No estás seguro? Lee instalar ESX Legacy, instalar servidor QBCore e instalar servidor QBox antes de elegir, porque cambiar frameworks después significa convertir tus datos.

#Carpeta y parámetros de receta

Después de elegir una receta, txAdmin muestra la carpeta de datos del servidor. Es donde el despliegue pone server.cfg y la carpeta resources. Mantenla fuera de la carpeta de artefactos, para que puedas actualizar los artefactos sin tocar tus datos (mira actualizar artefactos de servidor FiveM).

Luego viene un formulario con los parámetros de la receta. Campos típicos:

• Clave de licencia de Cfx.re: la clave que tu servidor necesita para iniciar. Genera en el Portal de Cfx.re. Si obtienes un error al respecto, lee el error de license key del servidor.
• Configuración de base de datos: host, usuario, contraseña y nombre de base de datos.
• Máximo de jugadores, nombre del servidor y otras opciones que la receta ofrece.

Cuidado: la clave de licencia es privada. No publiques server.cfg en capturas o mensajes de Discord sin ocultarla.

#Credenciales de base de datos durante el despliegue

Los frameworks mantienen jugadores, dinero, vehículos y más en una base de datos MySQL o MariaDB. La receta necesita iniciar sesión para crear sus tablas. Tienes dos configuraciones usuales:

1. Un servidor de base de datos que ya ejecutas (una MariaDB local, XAMPP, u uno de tu host). Ingresa su host, usuario y contraseña. El usuario necesita permiso para crear una base de datos.
2. Los valores de formulario por defecto de txAdmin, que se ajustan a una configuración local donde la base de datos se ejecuta en la misma máquina.

El despliegue construye la cadena de conexión para ti, así que no necesitas escribirla a mano. En server.cfg la encontrarás como:

set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

Si el servidor más tarde dice que no puede conectar, la solución está en error de conexión oxmysql.

#Qué hace realmente la receta

Una receta es una lista de tareas que txAdmin ejecuta en orden. En términos simples:

1. Descarga recursos: el framework, sus recursos, oxmysql y otras dependencias, usualmente como archivos ZIP de GitHub.
2. Desempaqueta y mueve dentro de la carpeta resources.
3. Crea la base de datos e importa el archivo SQL del framework, usando las credenciales que ingresaste.
4. Escribe server.cfg: tu nombre de servidor, clave de licencia, cadena de conexión, líneas ensure y permisos.

Cuando el despliegue termina, txAdmin muestra el server.cfg generado para que lo revises. Este es el momento correcto para leerlo línea por línea: mira server.cfg explicado. Puedes editarlo, luego guardar e iniciar el servidor.

#Después del despliegue

Comienza el servidor desde el panel de txAdmin y mira la consola. Un inicio saludable termina con los recursos listados como iniciados y sin errores rojo. Luego conéctate con FiveM y comprueba que llegas a la pantalla de carácter o spawneas.

Si un recurso falla, no se pudo iniciar recurso y leer un error de script cubren lo que significan los mensajes. Para tus propios derechos de admin en el juego, mira permisos de ACE.

Consejo: toma una copia de la carpeta de datos del servidor y una exportación de la base de datos justo después de un despliegue limpio. Si rompes algo mientras experimentas, puedes volver a un estado conocido bueno. La guía de copia de seguridad muestra cómo.

#Lista de comprobación