Guía de txAdmin 2026: Instala, configura y gestiona tu servidor FiveM

Si estás configurando un servidor FiveM, vas a pasar mucho tiempo dentro de txAdmin. Es el panel de gestión web que se encarga de todo, desde iniciar tu servidor hasta banear jugadores tóxicos. Conocerlo bien te ahorrará horas de depuración.

Esta guía cubre todo, desde tu primer arranque de txAdmin hasta la configuración avanzada — reinicios automáticos, copias de seguridad, gestión de recursos y permisos de administración.

Si aún no has configurado un servidor FiveM, empieza con nuestra Guía completa para principiantes sobre cómo crear un servidor FiveM.

Tabla de contenidos

1. ¿Qué es txAdmin?
2. Instalación de txAdmin (Windows y Linux)
3. Asistente de configuración inicial
4. Entendiendo el panel de txAdmin
5. Configurar server.cfg a través de txAdmin
6. Gestión de recursos
7. Administración de jugadores
8. Reinicios automáticos y copias de seguridad
9. Permisos y roles de administración
10. Solución de problemas comunes
11. FAQ

¿Qué es txAdmin?

Proporciona una interfaz web (accesible en http://TU_IP:40120) que te permite:

• Iniciar, detener y reiniciar tu servidor con un solo clic
• Acceder a la consola del servidor en vivo desde tu navegador
• Editar server.cfg con resaltado de sintaxis
• Navegar, iniciar y detener recursos individuales
• Banear, expulsar y advertir a jugadores
• Programar reinicios y copias de seguridad automáticas
• Gestionar múltiples cuentas de administración con permisos basados en roles
• Ver métricas del servidor (CPU, RAM, número de jugadores) en tiempo real

Instalación de txAdmin

txAdmin viene preincluido con el servidor FiveM. No instalas txAdmin por separado — descargas la compilación del servidor FiveM y txAdmin se lanza automáticamente.

Instalación en Windows

1. Instala Git y 7-Zip si aún no los tienes.
2. Ve a la página oficial de artefactos de FiveM: runtime.fivem.net/artifacts/fivem/build_server_windows/master/
3. Descarga la última compilación "recomendada" (busca la etiqueta verde) — es un archivo .7z.
4. Extrae server.7z en una carpeta (por ejemplo, C:\FXServer\server).
5. Ejecuta FXServer.exe — txAdmin se lanzará automáticamente y abrirá tu navegador.
6. Introduce el PIN que aparece en la consola, haz clic en Link Account y autentícate con tu cuenta CFX.re.

Instalación en Linux

Para producción, Linux es lo recomendado (mejor rendimiento, más fácil de mantener actualizado, menor consumo de memoria).

# Requisitos previos
sudo apt install git xz-utils

Crear un usuario dedicado
sudo adduser fivem
sudo su - fivem

Descargar FXServer
mkdir -p ~/FXServer/server
cd ~/FXServer/server
Reemplaza LATEST_LINK con la URL real de la página de artefactos
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/LATEST_LINK
tar xf fx.tar.xz --strip-components=1
rm fx.tar.xz

Iniciar FXServer
bash run.sh +exec server.cfg

Reemplaza LATEST_LINK con la URL de descarga real de la página de artefactos de Linux. Elige la última compilación recomendada.

Después de iniciar, verás la misma URL de txAdmin. Ábrela en tu navegador.

Nota sobre ejecutar txAdmin detrás de un proxy inverso

Si quieres una URL limpia como panel.tuservidor.com en lugar de tu-ip:40120, configura Nginx o Caddy como proxy inverso. Esto también te permite habilitar HTTPS con Let's Encrypt. Recomendado para cualquier servidor público.

Asistente de configuración inicial

En el primer arranque, txAdmin te guía a través de un asistente de 4 pasos.

Paso 1 — Crea tu cuenta de administrador principal

Crearás la cuenta de administrador principal de txAdmin. Esta cuenta tiene permisos totales sobre el panel. Elige una contraseña fuerte — cualquiera con este acceso controla todo tu servidor.

También puedes vincularla mediante tu cuenta de Discord o CFX.re para inicio de sesión OAuth. Recomendado por seguridad (sin contraseñas que filtrar).

Paso 2 — Vincula tu cuenta CFX.re

txAdmin te pedirá que lo autorices con tu cuenta CFX.re. Esto conecta tu servidor con tu clave de licencia CFX.re para que pueda autenticarse correctamente.

Paso 3 — Configuración del servidor

Se te pedirá:

• Nombre del servidor (por ejemplo, "Mi Servidor RP Increíble")
• Carpeta del servidor — donde vivirán tus resources/ y server.cfg
• Ruta de datos del servidor — donde txAdmin almacena sus datos (logs, copias de seguridad, etc.)

Paso 4 — Elige una receta (o sáltalo)

Esta es la decisión importante: ¿quieres que txAdmin instale automáticamente un servidor base por ti, o quieres empezar desde cero?

Selecciona "Popular Recipes" para ver las plantillas disponibles. La lista varía con el tiempo, pero las opciones típicas incluyen:

• CFX Default FiveM — configuración mínima por defecto, sin base de datos necesaria. Ideal para experimentar por primera vez.
• QBCore — framework QBCore completo + scripts esenciales. Requiere MariaDB.
• ESX Legacy — framework ESX completo + scripts esenciales. Requiere MariaDB.
• QBox — framework QBox completo. Requiere MariaDB.

Después de este paso, txAdmin finaliza la configuración e inicia tu servidor. Deberías ver "Server started" en la consola.

Entendiendo el panel de txAdmin

Una vez conectado, verás el panel principal de txAdmin. Veamos cada sección.

Barra superior

La barra superior muestra:

• Estado del servidor (Online/Offline con número de jugadores)


• Tiempo de actividad del servidor


• Uso de CPU y RAM


• Botones de acción rápida (Iniciar, Detener, Reiniciar servidor)

Barra lateral izquierda

• Dashboard — métricas generales y acciones rápidas
• Players — jugadores conectados + base de datos de todos los jugadores
• History — historial de acciones de administración (baneos, expulsiones, advertencias)
• Whitelist — si la lista blanca está habilitada
• Resources — iniciar/detener/reiniciar scripts individuales
• Server Log — salida de consola en tiempo real
• Server.cfg Editor — edita tu archivo de configuración principal con resaltado de sintaxis
• txAdmin Settings — configura el propio panel

Consola en vivo

La Live Console es donde pasarás la mayor parte de tu tiempo depurando. Muestra la salida del servidor en tiempo real: mensajes del chat, errores, advertencias de recursos, conexiones de jugadores.

Puedes escribir comandos del servidor directamente en la consola — cualquier cosa que escribirías por SSH funciona aquí. Ejemplos:

ensure hz-weather     # iniciar un recurso
restart hz-weather    # reiniciar un recurso
stop hz-weather       # detener un recurso
status                    # mostrar el estado del servidor
players                   # listar jugadores conectados
quit                      # detener el servidor

Configurar server.cfg a través de txAdmin

Tu server.cfg es el corazón de tu servidor FiveM. Controla el nombre del host, el número de slots, la clave de licencia, los permisos de administración y qué recursos iniciar.

El editor integrado de txAdmin incluye resaltado de sintaxis y un botón de "Save & Restart".

Ajustes esenciales de server.cfg

Aquí tienes un server.cfg mínimo para empezar:

# Clave de licencia de portal.cfx.re
sv_licenseKey "tu-clave-aqui"

Identidad del servidor
sv_hostname "^1Mi ^7Servidor ^2RP Increíble"
sv_projectName "MiServidor"
sv_projectDesc "Una comunidad RP amigable"
sv_maxClients 48

Configuración de endpoints
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Etiquetas del servidor (para el navegador de FiveM)
sets tags "roleplay, qbcore, custom"
sets locale "en-US"

Conexión a la base de datos (MariaDB — para ESX/QBCore/QBox)
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

OneSync (necesario para la detección de jugadores del lado del servidor)
set onesync on

Recursos — el orden importa
ensure oxmysql
ensure ox_lib
ensure qb-core
ensure pma-voice
ensure hz-weather
ensure hz-television
... añade más recursos aquí

Orden de los recursos

Los recursos se cargan en el orden en que aparecen en server.cfg. Las dependencias deben ir primero.

Orden habitual:

1. Base de datos (oxmysql — el estándar moderno, reemplaza a mysql-async)


2. Bibliotecas (ox_lib, PolyZone)


3. Núcleo del framework (es_extended, qb-core, qbx_core)


4. Módulos del framework (empleos, banca, inventario)


5. Scripts standalone (HZ-Scripts, clima, TVs, audio, etc.)


6. Últimos (herramientas de administración, mods opcionales)

Gestión de recursos

La pestaña Resources en txAdmin lista cada recurso en tu carpeta resources/, con su estado (iniciado/detenido) y hora de inicio.

Iniciar/detener/reiniciar desde el panel

Haz clic en cualquier recurso y usa los botones:

• Start — equivalente a ensure nombre_del_recurso
• Stop — equivalente a stop nombre_del_recurso
• Restart — detener y luego iniciar

Actualizar la lista de recursos

Si sueltas una nueva carpeta de recurso en resources/ y no aparece en el panel, haz clic en "Refresh". Esto vuelve a escanear la carpeta.

Errores comunes de recursos

La mayoría de los errores de recursos aparecen en la consola con etiquetas [ERROR] o [WARN]:

• Could not find dependency — un recurso necesario no está en ejecución. Consulta la documentación del recurso para ver sus requisitos (a menudo ox_lib, oxmysql).
• Script error: attempt to index a nil value — bug en el script Lua. Lee el número de línea, abre el archivo e investiga.
• oxmysql: no connection — tus credenciales de MariaDB/MySQL en server.cfg son incorrectas o la base de datos no está ejecutándose.

Administración de jugadores

La pestaña Players muestra a todos los conectados, además de una base de datos con búsqueda de todos los jugadores que se han unido alguna vez.

Acciones rápidas por jugador

Haz clic derecho en cualquier jugador para:

• Kick (expulsar con motivo)


• Warn (advertencia registrada en su historial)


• Ban (temporal o permanente)


• DM (mensaje directo en el juego)


• Spectate (observar su partida)


• Teleport (herramienta de administración)

Baneos

Los baneos de txAdmin almacenan la licencia, IP, ID de hardware, Steam, Discord e identificadores de Xbox Live del jugador. Un jugador baneado no puede volver simplemente cambiando su IP o cuenta de Steam — a menos que falsifique su ID de hardware completo.

Para máxima efectividad, aplica los baneos a través de txAdmin (no mediante comandos de chat del juego) para que se guarden en la base de datos de txAdmin.

Reinicios automáticos y copias de seguridad

Dos funciones que todo servidor debe activar: reinicios programados y copias de seguridad automáticas.

Reinicios programados

Los servidores FiveM acumulan memoria lentamente con el tiempo. Un reinicio limpio cada 6-12 horas mantiene el rendimiento estable.

En Settings — Restarter:

• Activa "Scheduled Restarts"


• Establece las horas de reinicio (por ejemplo, 06:00, 18:00 hora del servidor)


• Configura avisos: txAdmin emitirá mensajes en el juego 30, 15 y 5 minutos antes del reinicio

Copias de seguridad automáticas

txAdmin puede hacer copias de seguridad de tu carpeta server-data + base de datos MariaDB de forma programada.

En Settings — Backup:

• Activa "Auto Backup"


• Establece la frecuencia (se recomienda diaria)


• Establece la retención (conservar 7-14 días de copias)


• Especifica el destino de las copias (carpeta local o almacenamiento compatible con S3)

Permisos y roles de administración

txAdmin utiliza un sistema de permisos basado en roles. Los roles por defecto:

• Owner — acceso total a todo (el administrador inicial)
• Admin — puede gestionar jugadores, reiniciar recursos, editar server.cfg
• Moderator — puede expulsar/banear jugadores, ver logs, pero no puede modificar la configuración del servidor
• Roles personalizados — puedes definir los tuyos

Añadir nuevos administradores

En Settings — Admin Management:

1. Haz clic en "Add Admin"


2. Introduce su nombre de usuario/email


3. Asigna un rol


4. Recibirán un enlace de invitación para establecer su contraseña

Discord OAuth (recomendado)

Vincular las cuentas de administración a Discord OAuth es más seguro que las contraseñas:

• Sin contraseñas que filtrar


• Revocación más fácil (solo eliminar de Discord)


• Mejor trazabilidad (nombres de usuario de Discord en los logs)

Solución de problemas comunes

El servidor no arranca

• sv_licenseKey inválida — verifícala en portal.cfx.re
• Conflicto de puertos — otro proceso está usando el puerto 30120
• Un recurso se bloquea al cargar — revisa la consola para ver el último recurso que se cargó

No puedo conectarme al panel web de txAdmin

• El firewall bloquea el puerto 40120
• txAdmin no está en ejecución (el servidor no se ha iniciado)
• IP incorrecta

Los jugadores no pueden conectarse

• Un recurso no se cargó correctamente — revisa la consola buscando [ERROR]
• El servidor está al máximo de capacidad — verifica sv_maxClients
• La versión de GTA V del jugador no está actualizada — dile que actualice

Errores de conexión a MariaDB

• Cadena de conexión incorrecta en server.cfg
• El servidor MariaDB no está en ejecución
• Permisos de usuario incorrectos

¿Qué sigue?

Ahora que conoces txAdmin a fondo:

1. Elige tu framework sabiamente — Comparativa ESX vs QBCore vs QBox
2. Elige tus primeros scripts — Primeros scripts a instalar en tu servidor FiveM
3. Construye tu catálogo de scripts — explora HZ-Scripts para recursos premium plug-and-play

FAQ

Consulta las preguntas frecuentes de cada sección, o navega por las guías relacionadas para temas específicos.