Cómo instalar txAdmin y crear tu servidor de FiveM (tutorial completo)

Casi todos los servidores de FiveM que hay hoy en día se crearon con txAdmin, el panel de control web que viene incluido dentro del build oficial del servidor. Gestiona el despliegue, los reinicios, los baneos, la consola y tu server.cfg desde una pestaña del navegador, y puede instalarte una base completa de ESX o QBCore en unos pocos clics.

Este tutorial va desde una carpeta vacía hasta un servidor al que tus amigos pueden entrar, explicando por qué importa cada paso, no solo dónde hay que hacer clic.

Qué necesitas antes de empezar

• Una máquina donde ejecutarlo: tu propio PC para pruebas, o un host/VPS de pago para cualquier cosa pública.
• Una cuenta gratuita de Cfx.re para tu license key.
• MySQL o MariaDB: todo framework serio necesita base de datos.
• Unos 45 minutos.

En Windows, instala primero el Microsoft Visual C++ Redistributable (x64). FXServer no arranca sin él, y el error que muestra es críptico: esta única dependencia que falta causa buena parte de los mensajes de “se me cierra al instante”.

En Linux necesitas xz-utils para extraer el build, además de un servidor MySQL/MariaDB.

Paso 1 — Consigue tu license key de Cfx.re

Entra en keymaster.fivem.net, inicia sesión con tu cuenta de Cfx.re (la del foro) y registra una key nueva.

• Elige “I’m using a server hosting provider” o una IP fija si ya la conoces; se puede cambiar más adelante.
• Guarda la key en un sitio seguro. Es una cadena larga y aleatoria.

Esta key identifica tu servidor ante Cfx.re. Trátala como una contraseña: nunca la pegues en una captura de Discord ni la subas a GitHub. Una key filtrada puede acabar usada por otro y con la tuya revocada.

Paso 2 — Descarga los artifacts del servidor

Los artifacts son el build real del servidor (FXServer). Descárgalos del runtime oficial:

• Windows — runtime.fivem.net/artifacts/fivem/build_server_windows/master/
• Linux — runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Coge el build marcado como recommended, no el más nuevo de arriba del todo. Los artifacts de última hora rompen recursos con frecuencia, y el recomendado es contra el que realmente prueban los desarrolladores de scripts. Lo seguimos en nuestra guía de artifacts.

Extráelo en una carpeta dedicada, por ejemplo C:\FXServer\server\ en Windows o /home/fivem/server/ en Linux.

Paso 3 — Organiza la estructura de carpetas

Mantén el build y tus datos del servidor en carpetas separadas. Es la mejor costumbre con la que puedes empezar: actualizar los artifacts más adelante pasa a ser “borrar y reemplazar una carpeta” en vez de una cirugía con cuidado entre tus propios archivos.

C:\FXServer\
├── server\          <- los artifacts extraídos (reemplazables)
└── server-data\     <- tus recursos, server.cfg, copias de la base de datos

Cuando actualices FiveM dentro de seis meses, borras server\, extraes el build nuevo, y todo lo que de verdad es tuyo queda intacto.

Paso 4 — Arranca el servidor por primera vez

Ejecuta el binario:

• Windows — doble clic en FXServer.exe dentro de server\.
• Linux — entra en la carpeta y ejecuta ./run.sh.

Se abre una consola y txAdmin arranca. Verás algo así:

[txAdmin] Starting txAdmin v7.x.x
[txAdmin] Web UI: http://localhost:40120
[txAdmin] PIN: 4821

Abre esa URL en el navegador e introduce el PIN.

Paso 5 — Crea tu cuenta maestra

txAdmin te pide crear la cuenta maestra, el admin de máximo nivel que ningún otro admin puede eliminar.

Usa una contraseña de verdad, no admin123. Este panel puede ejecutar comandos de consola en tu servidor: quien llegue a él es dueño de tu comunidad. Opcionalmente puedes vincular una identidad de Cfx.re o Discord para entrar más cómodo.

¿La pierdes más adelante? Para el servidor y arráncalo una vez con --resetadmin:

FXServer.exe --resetadmin

Paso 6 — Prepara la base de datos

Antes de lanzar el desplegador, ten MySQL/MariaDB listo. En Windows lo habitual es XAMPP o una instalación suelta de MariaDB; en Linux, mariadb-server desde el gestor de paquetes.

Crea una base de datos vacía (por ejemplo fivem) y un usuario con todos los permisos sobre ella. En el siguiente paso le darás a txAdmin una cadena de conexión con esta forma:

mysql://usuario:contraseña@localhost/fivem?charset=utf8mb4

Usa un usuario dedicado, no root, y ponle una contraseña real. La base de datos de un framework acaba guardando los personajes, el dinero y el inventario de cada jugador: es lo único que de verdad no puedes reconstruir.

Paso 7 — Despliega un framework con el desplegador de recetas

Aquí está lo que hace que txAdmin merezca la pena. La pantalla de setup ofrece varios tipos de despliegue; elige recetas populares y luego tu base:

• ESX — el ecosistema más grande; lo más fácil para encontrar scripts, tutoriales y staff que ya lo conozca.
• QBCore — moderno y orientado al rol.
• Qbox — una continuación de QBCore centrada en el rendimiento.

¿Aún no lo tienes claro? Lee nuestra comparativa ESX vs QBCore vs Qbox antes de comprometerte: migrar después es trabajo de verdad.

Después txAdmin te pedirá:

1. Un nombre de servidor y la carpeta de datos (server-data\).
2. Tu cadena de conexión del paso 6.
3. Tu license key del paso 1.

Dale a desplegar. txAdmin descarga el framework, importa el SQL, escribe un server.cfg funcional y arranca el servidor. Mira el log: si algo falla, te dice exactamente qué pieza ha sido.

Paso 8 — Revisa tu server.cfg

La receta escribe una configuración que funciona, pero conviene que entiendas qué hay dentro. txAdmin trae un editor integrado (Settings → CFG Editor), así que no necesitas tocar archivos por FTP para cambios pequeños.

Las líneas que más importan:

sv_hostname "Mi servidor de rol"
sv_maxclients 48
sv_licenseKey "tu-key-aqui"

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# OneSync — necesario para más de 32 jugadores
set onesync on
sv_enforceGameBuild 3095

Dos cosas que se aprenden por las malas:

• sv_maxclients no es una estrategia de crecimiento. Empieza en 32–48. Un servidor vacío de 128 slots parece muerto; uno lleno de 48 parece vivo.
• sv_enforceGameBuild fija el build de GTA que espera tu servidor. Cámbialo solo cuando un recurso necesite de verdad contenido DLC más nuevo, y cuenta con volver a probarlo todo después.

Paso 9 — Abre los puertos correctos

Los jugadores conectan por el 30120, en TCP y UDP. Si solo abres TCP, el servidor aparece en la lista pero nadie puede entrar: un clásico que cuesta una tarde entera.

Nunca expongas el 40120 públicamente. Si necesitas acceso remoto, ponlo detrás de una VPN o de un proxy inverso con HTTPS y contraseña fuerte. Un panel de txAdmin abierto en internet es una consola remota completa de tu servidor, y hay bots que lo escanean.

Paso 10 — Aprende a usar el panel

Dedícale diez minutos; se amortizan solos:

• Dashboard — gráfica de rendimiento en vivo. Cuando los jugadores digan “va lageado”, aquí lo confirmas.
• Live Console — la consola real del servidor en el navegador. Léela de arriba abajo y arregla siempre el primer error rojo; el resto suelen ser consecuencia.
• Players — buscar, avisar, kickear, banear y ver el historial por identificador.
• Restarter — reinicios programados. Configúralos desde el primer día (ver abajo).
• CFG Editor — editar server.cfg sin FTP.
• Bot de Discord — opcional; mensajes de estado y whitelist por roles.

Configura ya los reinicios programados

En Settings → Restarter, programa reinicios cada 6–12 horas. Un FXServer que lleva mucho tiempo levantado acumula memoria y se degrada poco a poco, y un reinicio programado con cuenta atrás es invisible para los jugadores. Un crash imprevisto en hora punta no lo es.

Paso 11 — Añade tus primeros recursos

Con el framework en marcha, los recursos van en server-data/resources/, cada uno activado con una línea ensure. El orden importa: las dependencias arrancan primero.

# Núcleo — estos van primero
ensure oxmysql
ensure ox_lib
ensure es_extended

# Jugabilidad
ensure my-inventory
ensure my-hud

Añade los recursos de uno en uno, reiniciando entre cada uno. Si sueltas quince scripts de golpe y el servidor muere, tienes quince sospechosos. De uno en uno, siempre sabes exactamente qué lo ha roto.

Los sistemas que los jugadores notan antes son el inventario y el HUD: están en pantalla constantemente, así que definen cómo se siente tu servidor más que cualquier script de trabajos. Nuestra guía de mejores inventarios para FiveM compara las opciones; si quieres uno que cubra ESX, QB, QBCore y Qbox desde una sola base de código, Quasar Inventory es el todoterreno pulido al que seguimos volviendo en nuestras pruebas. Para instalarlo paso a paso, sigue nuestro tutorial de instalación de inventario.

Paso 12 — Prueba bien y luego abre

Conecta en local con connect localhost desde el cliente de FiveM (consola F8), y luego que un amigo entre por tu dirección pública.

Recorre el bucle completo antes de anunciar nada: aparecer, coger un trabajo, ganar dinero, abrir el inventario, guardar un objeto, comprar y sacar un coche, reloguear y comprobar que todo persiste. Reloguear es la prueba de verdad: la mayoría de los “mi servidor pierde los datos de los jugadores” son un problema de base de datos que solo aparece al reconectar.

Haz copias de tu base de datos — txAdmin no las hace por ti

Este es el fallo más común en servidores por lo demás bien llevados. txAdmin gestiona tu servidor; no hace copias de tu base de datos. Monta tu propio volcado programado:

mysqldump -u fivem -p fivem > backup-$(date +%F).sql

Automatízalo (cron o el Programador de tareas) y guarda copias fuera de la máquina. Un servidor que puedes reconstruir en una tarde es una molestia. Una base de datos que no puedes restaurar es el final de la comunidad.

Solución de problemas

Qué hacer a continuación

Ya tienes un servidor funcionando, reiniciable y con copias de seguridad. Las dos cosas que deciden si los jugadores se quedan son el rendimiento y un bucle de juego coherente, no cuántos scripts tengas.

Lee nuestra guía de optimización antes de tu primera noche con gente, y cómo reducir el lag cuando llegue, que llegará. Después cierra las puertas: nuestra guía de seguridad cubre qué endurecer antes de que merezca la pena atacarte.