Arregla y construye tu servidor de FiveM chateando con un agente

Casi todos los problemas de un servidor de FiveM empiezan igual. Algo se rompe tras un reinicio, abres la consola y te quedas mirando una línea roja que no entiendes. FiveAI pone un agente en ese lugar. Describes el problema en un chat ("el script de garajes se rompió tras el último reinicio") y el agente lee los archivos y la consola de tu servidor, encuentra la causa, edita el recurso, lo reinicia y te cuenta qué cambió. Este artículo recorre la instalación y lo que puedes esperar cuando ya funciona.

Qué necesitas

• Un servidor de FiveM que controles, en un PC con Windows o en una máquina Linux.
• Una cuenta de ChatGPT. FiveAI ejecuta Codex con tu propio plan de ChatGPT, así que no necesitas otra cuenta de IA.

FiveAI admite un servidor de FiveM por cuenta.

Cómo encajan las piezas

La app web y tu servidor no hablan directamente entre sí. Un programa pequeño llamado listener corre en la máquina donde corre tu servidor de FiveM. Vigila la consola, mantiene la conexión con la app y ejecuta el agente cuando envías un mensaje. En la app chateas y ves lo que pasa.

El agente es Codex, el agente de programación de OpenAI, incluido en el listener en una versión fija. Inicia sesión con tu cuenta de ChatGPT, no con una clave que guardemos nosotros.

Paso 1: instala el listener

Abre la página de instalación de la app. Muestra un comando por sistema operativo. Arranca primero tu servidor de FiveM y pega el comando en la máquina donde corre.

Windows. Abre PowerShell y pega el comando de install.ps1. Windows pide permiso para ejecutarse como administrador. Acepta. El instalador crea un usuario dedicado FiveAI y una carpeta protegida, y arranca el listener con ese usuario cuando se enciende el PC. Si rechazas el permiso, se instala igualmente, pero solo para tu usuario. Arranca cuando inicias sesión y el agente puede leer las credenciales de FiveAI. Acepta salvo que tengas un motivo para no hacerlo.

Linux. Pega el comando de install.sh en una terminal. Usa sudo, así que te pide la contraseña. Detecta txAdmin y FXServer, crea un usuario de sistema fiveai y configura un servicio de systemd. El sandbox del agente necesita espacios de nombres de usuario sin privilegios. En Ubuntu 24.04 esa opción viene desactivada y, si está bloqueada, el instalador te indica el comando exacto que debes ejecutar.

Si ejecutas el mismo comando más adelante, actualiza el listener. Al terminar, el instalador muestra un código de vinculación.

Paso 2: vincula el servidor

De vuelta en la app, llegas al paso "Connect your server". Ponle un nombre al servidor y luego:

Enter the 8-character code shown on your server.

Es decir, escribe el código de 8 caracteres que muestra tu servidor y pulsa Connect server. La app crea una cuenta dedicada para ese único servidor y se la entrega al listener una sola vez. Desde entonces el listener inicia sesión con esa cuenta y no tiene las llaves del resto del sistema.

En Windows, el instalador también puede abrir la app con el código ya escrito, así que quizá solo tengas que confirmar el nombre.

Paso 3: conecta ChatGPT

El siguiente paso es Connect ChatGPT. La app le pide a tu listener que inicie un acceso a ChatGPT y te muestra dos cosas:

1. Un botón que abre la página de acceso de ChatGPT.
2. Un código corto para escribir allí.

Termina de iniciar sesión y la app lo detecta sola. OpenAI puede avisarte de que el código lo compartió un sitio web. Es seguro: tu propio servidor lo solicitó cuando pulsaste el botón. FiveAI nunca ve tu contraseña de ChatGPT.

Paso 4: describe el problema

Ahora tienes un cuadro de chat y algunos mensajes de ejemplo (en inglés en la app):

• "What resources does my server have?"
• "Are there any errors in the console?"
• "Create a /heal command that heals the player"

Puedes escribir en español. No hace falta nombrar archivos. Un mensaje como "los jugadores no pueden abrir la tienda desde que actualicé" basta para empezar.

Qué hace el agente

El agente trabaja dentro de tu carpeta server-data, la que contiene server.cfg y resources/. Además de leer y escribir archivos, tiene tres herramientas:

• fx console muestra la salida más reciente de la consola.
• fx restart <recurso> reinicia un recurso e informa si arrancó o falló.
• fx sql lee y modifica tu base de datos. El agente mira primero las tablas reales en lugar de suponer cómo las organiza tu framework.

Sigue unas reglas que le importan a un dueño de servidor:

• Investiga antes de editar. Lee primero la consola y los archivos relevantes.
• Las funciones nuevas van en un recurso nuevo. Crea una carpeta en resources/[fiveai]/ y añade una línea ensure a server.cfg, así que tus scripts actuales no se tocan.
• Pregunta antes de cambiar lo que ya existe. Si pides tres rangos de mecánico y el trabajo tiene cinco, te dice cuáles dos quitaría y espera tu confirmación.
• Pregunta antes de tocar la base de datos de forma destructiva. Borrar, vaciar y eliminar tablas, o hacer actualizaciones masivas, requiere tu confirmación, y te muestra las filas que cambiaría una escritura.
• Comprueba qué cayó con un reinicio. Reiniciar un recurso detiene los que dependen de él, así que el agente revisa la consola después y los vuelve a arrancar.

Responde con palabras normales y en el idioma en que escribiste: qué encontró o arregló, qué archivos tocó y qué deberías revisar después.

El sandbox y la consola en vivo

El agente no tiene vía libre. Codex corre dentro de un sandbox, con permiso de escritura solo en tu carpeta server-data (puede descargar scripts de internet, pero no cambia nada fuera de ella). No puede moverse por el resto de tu máquina.

En la parte inferior del espacio de trabajo ves la consola en vivo del servidor, la misma salida que verías en txAdmin. Cuando el agente reinicia un recurso, ves las líneas pasar en tiempo real. Si el agente dice que arregló algo y la consola dice otra cosa, lo notas al instante.

Dónde ayuda y dónde mandas tú

Un agente que puede editar tu servidor es útil y también un riesgo real, así que trátalo como a un ayudante rápido que es nuevo en tu proyecto.

• Revisa lo que cambió. El agente te dice qué archivos tocó. Ábrelos. Nuestro artículo sobre por qué ChatGPT escribe scripts de FiveM rotos lista qué comprobar.
• Haz copias de seguridad. Pon resources/ en git y exporta la base de datos antes de cambios grandes. El agente pregunta antes de los pasos destructivos en la base de datos, pero una copia cubre los errores que nadie anticipó.
• Prueba primero en un servidor de desarrollo. Todo lo que toque dinero, trabajos o ítems merece una prueba lejos de tus jugadores.
• Sé específico cuando importe. Di qué framework usas (ESX, QBCore o Qbox) y a qué recurso te refieres. El agente carga skills de FiveM para esto, pero no puede adivinar un script de pago que nunca ha visto.
• Algunas cosas siguen siendo tuyas. Si el problema está fuera de la carpeta server-data, por ejemplo un puerto cerrado en tu router, el agente puede decirte qué cambiar, pero no puede hacerlo por ti.

Si tu servidor no arranca en absoluto, empieza con nuestra guía de errores de arranque de txAdmin. Cuando la consola vuelva a mostrar salida, el agente puede seguir desde ahí.

Si estás sopesando opciones, nuestra comparativa de herramientas de IA para FiveM explica en qué acierta cada una y dónde falla.

Preguntas frecuentes

¿Necesito saber programar?

No. El agente está pensado para dueños de servidor que no programan y explica los términos la primera vez que los usa. Aun así, tienes que leer sus resúmenes y probar el resultado en el juego.

¿Funciona con ESX, QBCore y Qbox?

El agente carga skills de FiveM, Lua, ESX, QBCore, ox_lib, oxmysql, base de datos, NUI, seguridad y Fivemanage cuando una tarea las necesita. Dile qué framework usas para que parta de la API correcta.

¿Pasa mi contraseña de ChatGPT por FiveAI?

No. El acceso se hace en la página de ChatGPT, con un código que solicitó tu listener. FiveAI nunca ve tu contraseña.

¿Puedo usarlo en más de un servidor?

Cada cuenta conecta un servidor de FiveM.