Cómo montar un servidor de FiveM con IA en 2026 (Cursor, Claude Code, VS Code)

9 min de lectura

  • fivem ia
  • cursor
  • claude code
  • txadmin

Hoy puedes montar y mantener un servidor de FiveM con un asistente de código por IA, pero solo si le das el contexto correcto. Tal como vienen, Cursor, Claude Code y Copilot conocen los natives de GTA V de hace unos años, mezclan ESX con QBCore y adivinan la sintaxis de oxmysql. El flujo de abajo lo corrige: instala txAdmin con una receta, abre la carpeta del servidor en tu editor, carga skills específicas de FiveM y escribe prompts con errores reales de consola y rutas de archivo en lugar de peticiones vagas. La IA escribe el recurso, tú lo revisas contra docs.fivem.net y lo pruebas en un servidor local antes de que toque producción.

Qué puede y qué no puede hacer la IA por un servidor de FiveM ahora mismo

Ajusta tus expectativas antes de empezar, porque casi toda la frustración con la “IA para FiveM” viene de pedirle lo que no debe.

Lo que funciona bien:

  • Escribir recursos standalone pequeños (un comando, un trabajo simple, un menú de concesionario, un logger por webhook de Discord) cuando describes el comportamiento y el framework con precisión.
  • Explicar un error de consola que le pegas. “attempt to index a nil value (global ‘QBCore’)” es un problema resuelto para un modelo que sabe cómo funcionan los exports de QBCore.
  • Convertir entre frameworks o librerías, por ejemplo pasar un script de mysql-async a oxmysql, o de qb-menu a los menús contextuales de ox_lib.
  • Leer un recurso que no escribiste tú y decirte qué hace, qué eventos expone y dónde es inseguro.

Lo que no funciona:

  • “Hazme un servidor de roleplay completo.” Te dará una carpeta de scripts medio conectados con eventos inventados. Los servidores se construyen recurso a recurso.
  • Cualquier cosa que dependa del estado actual de un script de pago que nunca ha visto. Se inventará los exports y los pondrá mal.
  • Depurar sin logs. Si solo dices “los jugadores no pueden conectarse”, te listará diez causas genéricas. Dale la salida de la consola de txAdmin y normalmente señalará la línea exacta.

Requisitos antes de abrir Cursor o Claude Code

Necesitas un servidor funcionando antes de que la IA sirva de algo. Ten esto listo primero:

  1. Una clave de licencia de Cfx.re. Créala en el Cfx.re Portal (el antiguo Keymaster). Una clave por servidor, vinculada a tu cuenta.
  2. Artefactos de FXServer. Descarga la última build recomendada para Windows o Linux desde la página de artefactos de Cfx.re. No descargues una build vieja cualquiera de un tutorial.
  3. txAdmin. Viene dentro de los artefactos. En Windows ejecutas FXServer.exe, en Linux ./run.sh, y abre el asistente de configuración en el puerto 40120.
  4. MariaDB o MySQL. MariaDB 10.6 o superior es la opción habitual. Crea una base de datos y un usuario con contraseña antes de ejecutar una receta.
  5. Una decisión de framework. ESX, QBCore o Qbox. Si todavía no lo has decidido, lee primero nuestra comparativa ESX vs QBCore vs Qbox. La elección cambia cada prompt que escribirás después.
  6. Un editor con agente. Cursor, Claude Code (terminal) o VS Code con Copilot o Cline. Todos pueden leer una carpeta y editar archivos, que es lo único que importa aquí.

Paso 1: instala txAdmin con una receta

Arranca FXServer.exe (o ./run.sh), abre http://localhost:40120 y sigue el asistente. Cuando pregunte cómo desplegar, elige una receta. Las oficiales cubren ESX Legacy, QBCore y Qbox, y descargan el framework, los recursos base y crean el server.cfg con el orden correcto de ensure por ti.

Durante la receta te pedirá la conexión a la base de datos. Usa el usuario que creaste antes. La receta lo escribe en server.cfg así:

set mysql_connection_string "mysql://fivem:yourpassword@localhost/fivem?charset=utf8mb4"

Arranca el servidor una vez desde txAdmin y confirma que puedes conectarte con tu cliente antes de tocar código. Si falla aquí, todavía no es un problema de IA. Nuestro artículo sobre errores de txAdmin que impiden arrancar el servidor cubre los sospechosos habituales.

Paso 2: abre la carpeta del servidor en tu editor

Abre la carpeta completa txData/<tu-servidor>/, no solo un recurso. El agente necesita ver server.cfg, resources/ y el core del framework para tomar decisiones sensatas. En Cursor es File > Open Folder. En Claude Code haces cd a la carpeta y ejecutas claude.

Dos detalles pequeños que ahorran mucho tiempo después:

  • Añade una exclusión tipo .cursorignore o .claudeignore para cache/ y resources/[cfx-default]/ si tu herramienta lo permite. Esos directorios son enormes e inútiles para el modelo.
  • Mantén server.cfg legible. Si una receta dejó 200 líneas de comentarios, el modelo las leerá todas en cada prompt.

Paso 3: instala las skills de FiveAI

Una skill es una carpeta con un archivo SKILL.md más archivos de referencia que el agente carga cuando sale el tema. Es la diferencia entre que el modelo adivine qué devuelve lib.callback.await y que lo sepa de verdad.

Para un servidor recién instalado, pon estas cuatro:

  • fivem-basics: estructura de recursos, fxmanifest.lua, scripts de cliente frente a servidor, eventos, natives.
  • oxlib: callbacks, menús contextuales, diálogos de entrada, zonas, notificaciones.
  • oxmysql: MySQL.query.await, MySQL.insert, sentencias preparadas, transacciones.
  • Tu framework: esx-framework o qbcore-framework.

Descarga cada una desde su página (un zip con SKILL.md y los archivos de referencia) y colócala donde tu herramienta busca las skills:

  • Claude Code: .claude/skills/<skill-name>/ dentro de la carpeta del servidor.
  • Cursor: .cursor/rules/ (renombra SKILL.md a <skill-name>.mdc o referéncialo desde un archivo de reglas).
  • VS Code con Copilot: .github/instructions/ o referencia el archivo desde copilot-instructions.md.

La carpeta exacta varía según la herramienta y cambia entre versiones, así que revisa las notas de instalación en la página de skills. Una vez cargadas, pregúntale al agente “¿qué skills de FiveM tienes disponibles?” para confirmar que las ve.

Paso 4: patrones de prompt que producen código funcional

Los prompts vagos producen scripts vagos. Estos patrones funcionan en la práctica:

Pega el error y luego pregunta.

Esta es la salida de consola al arrancar el servidor: [ script:qb-garages ] SCRIPT ERROR: @qb-garages/server/main.lua:42: attempt to index a nil value (field 'Functions'). Explica la causa y dame la corrección en ese archivo.

Describe un recurso standalone con restricciones explícitas.

Escribe un recurso standalone llamado fa_repairkit para QBCore usando ox_lib y oxmysql. Ítem usable repairkit que repara el vehículo propio más cercano durante 10 segundos con un lib.progressBar. Valida en el servidor que el jugador realmente tiene el ítem antes de quitárselo. Incluye fxmanifest.lua, client.lua, server.lua y el SQL del ítem si hace falta.

Pide una revisión antes de pedir una funcionalidad.

Lee resources/[custom]/my_shop y lista cada evento de servidor que confía en datos del cliente sin comprobarlos.

Fuerza el framework.

Este servidor corre ESX Legacy 1.10 con ox_inventory. No uses esx_addoninventory ni xPlayer.addInventoryItem; usa los exports de ox_inventory.

Fíjate en que todos nombran el framework, la librería y una ruta de archivo. Eso es lo que le falta al modelo cuando produce código roto, y es exactamente lo que una skill aporta por defecto.

Paso 5: revisa lo que escribió la IA

Nunca hagas ensure de un recurso escrito por IA sin leerlo. Una lista de cinco minutos:

  1. Natives. Abre docs.fivem.net/natives y busca cada native que no reconozcas. Si no está ahí, no existe. Los modelos inventan nombres como GetVehicleOwner que suenan bien y no son reales.
  2. Exports. Por cada exports['some_resource']:Something() comprueba que el recurso real lo expone. Haz grep en el recurso buscando exports( o exports. para estar seguro.
  3. Cliente frente a servidor. Las llamadas a base de datos, los cambios de dinero y la entrega de ítems van en el servidor. Si ves MySQL en client.lua, para.
  4. fxmanifest.lua. Confirma fx_version 'cerulean', game 'gta5', lua54 'yes' si el código usa características de Lua 5.4, y que shared_script '@ox_lib/init.lua' está presente cuando se usa ox_lib.
  5. Validación de eventos. Cada handler de RegisterNetEvent en el servidor debe validar source y los argumentos. Mira nuestro artículo sobre por qué ChatGPT escribe scripts de FiveM rotos para ver los patrones.

Paso 6: un ciclo de pruebas local

Mantén producción y desarrollo separados, aunque “producción” sea un servidor con 8 amigos dentro.

  1. Levanta un segundo perfil de txAdmin en tu PC con la misma receta y una copia de la base de datos (haz mysqldump de la real e impórtala en local).
  2. Añade el recurso nuevo a server.cfg con ensure fa_repairkit, arranca el servidor y vigila la consola en vivo de txAdmin buscando el nombre del recurso.
  3. Prueba como jugador. Si algo falla, copia la línea exacta de la consola de vuelta al editor y pide la corrección.
  4. Cuando funcione, sube el recurso a git. Una carpeta resources/[custom] en un repositorio es el seguro más barato que vas a comprar en tu vida.
  5. Despliega al servidor real con refresh y ensure fa_repairkit desde la consola de txAdmin, o reinicia en una hora tranquila.

Repite este ciclo y verás que la IA mejora en la segunda y tercera iteración, porque ahora tiene en contexto las cadenas de error reales de tu instalación.

Dónde encaja la app FiveAI

El flujo de arriba funciona con cualquier editor, pero tiene un punto débil: el asistente solo ve archivos. No ve la consola de txAdmin, la base de datos ni lo que hace el servidor mientras corre. Así que tú te conviertes en el puente de copiar y pegar entre los logs y el chat.

FiveAI elimina ese paso. Corre en la misma máquina que tu servidor, se conecta a txAdmin y a tu base de datos, y lee los logs por sí misma. Cuando dices “el script de garajes se rompió tras el último reinicio”, revisa la consola, encuentra el recurso que falla, lee el archivo y propone la corrección, usando las mismas skills descritas arriba. Si prefieres no gestionar editores y carpetas de skills, ese es el camino más fácil.

Preguntas frecuentes

¿Puede la IA montar un servidor de FiveM completo por sí sola?

No. No puede instalar nada y no puede tomar decisiones de diseño sobre tu economía o tus trabajos. Lo que sí puede hacer es escribir y corregir recursos individuales rápido una vez que txAdmin, la base de datos y un framework están en su sitio. Trátala como un desarrollador junior rápido que necesita instrucciones precisas y revisión.

¿Qué es mejor para FiveM, Cursor o Claude Code?

Ambos leen tu carpeta del servidor y editan archivos, y ambos cargan skills. Cursor es más amigable si quieres un editor visual con diffs en línea. Claude Code vive en la terminal y se maneja bien ejecutando comandos y leyendo muchos archivos a la vez. Elige el que ya uses; las skills funcionan en los dos.

¿Necesito saber Lua para usar IA en FiveM?

No para empezar, pero sí lo suficiente para revisar lo que escribe. Aprende a leer un fxmanifest.lua, a distinguir un script de cliente de uno de servidor y a reconocer una llamada a base de datos. Nuestra skill lua-basics y la skill fivem-basics cubren exactamente ese terreno, y la IA puede explicarte cualquier línea que le pegues de vuelta.

Añade estas skills a Cursor, VS Code o Claude Code para que la IA conozca las APIs reales que se mencionan en este artículo.