Traducción automática – aún no revisada por un hablante nativo.

Academy/Proyectos

Crea un recurso de FiveM con Paralake.AI

Abre la carpeta de tu servidor, aprende dónde van los recursos nuevos, añádelos a server.cfg con ensure, pruébalos en un servidor de desarrollo local, reinicia de forma segura y evita los fallos habituales de QBCore y ESX. Además, lo nuevo de la versión 0.1.5 (beta): consola del servidor sin RCON, acciones de recursos verificadas, Error Doctor y comprobaciones de NUI.

Disponible Intermedio · 8 min · Versión: 0.1.5 · Última verificación: 2026-11-17

Requisitos previos

  • Paralake.AI instalado y con la sesión iniciada (consulta Get started with Paralake.AI).
  • Un servidor de desarrollo de FiveM local (FXServer) o una copia de los archivos de tu servidor, no el servidor en vivo con jugadores.
  • Acceso a la consola del servidor (la ventana de FXServer o txAdmin) para hacer pruebas.
  1. Abre la carpeta correcta

    En Home, elige la carpeta de datos de tu servidor de desarrollo, la carpeta que contiene server.cfg y la carpeta resources.

    • Si abres la carpeta de datos, el agente puede ver server.cfg, tu framework y tus recursos existentes.
    • Si solo abres la carpeta resources, el agente puede crear recursos igualmente, pero tendrás que añadir tú la línea ensure a server.cfg.

    También puedes pedirle al agente que lo busque por ti:

    Revisa mi servidor de desarrollo de FiveM y dime cómo está configurado.

    Puede encontrar server.cfg, FXServer, QBCore/ESX/ox, la base de datos, los scripts de inicio y parada, txAdmin, [local] y los registros. Las contraseñas y las claves de licencia nunca se muestran.

  2. Dónde van los recursos nuevos

    Los recursos nuevos siempre van en resources/[local], en una carpeta propia, por ejemplo resources/[local]/my_rental.

    • El nombre de la carpeta es el nombre del recurso que usas con ensure.
    • Un recurso necesita un fxmanifest.lua. El agente lo escribe por ti, junto con los scripts de cliente y servidor.
    • Los archivos de recursos existentes no se modifican mientras el servidor está en marcha. Detén el servidor de desarrollo antes de pedir cambios en un recurso que ya está en uso.
  3. Pide el recurso

    Sé concreto con el framework, el comportamiento y lo que debe comprobar el servidor:

    Crea un recurso de alquiler de vehículos para QBCore con un NPC y un menú. El servidor debe comprobar el precio y el dinero del jugador; nunca te fíes del cliente.

    El agente escribe los archivos directamente, con un punto de restauración para cada cambio. Usa Undo last change o Start over si el resultado no es el que querías. ¿Prefieres aprobar tú cada cambio? Desactiva los cambios automáticos en Settings → Limits.

  4. Añádelo a server.cfg

    Para que el recurso se inicie automáticamente, añade una línea ensure a server.cfg después de los recursos de los que depende, normalmente el recurso de base de datos (por ejemplo oxmysql) y tu framework (qb-core o es_extended):

    ensure oxmysql
    ensure qb-core
    ensure my_rental

    Si tu server.cfg ya tiene ensure [local], todos los recursos de esa carpeta se inician automáticamente y no necesitas una línea aparte.

    ensure my_rental
  5. Prueba en tu servidor de desarrollo

    1. Inicia tu servidor de desarrollo si no está en marcha.
    2. En la consola del servidor, ejecuta refresh para que el servidor encuentre la carpeta nueva.
    3. Ejecuta ensure my_rental (usa el nombre de la carpeta de tu recurso).
    4. Lee la consola. Los errores con el nombre del recurso, el archivo y el número de línea te dicen qué corregir; pega el texto del error (no tu server.cfg) al agente.

    Opcional: deja que el agente registre el servidor en Server Studio (te pide aprobación) e introduce tú mismo allí la contraseña de RCON. Así el agente puede ejecutar refresh, ensure y restart para un recurso en el servidor de desarrollo y leer la consola, cada comando después de tu aprobación.

    Disponible en la versión 0.1.5 (beta): cuando el propio Paralake.AI ha iniciado el servidor de desarrollo, no hace falta RCON; consulta el paso 8.

    refresh
  6. Reinicia de forma segura

    • Es preferible reiniciar un solo recurso (restart my_rental o ensure my_rental) que reiniciar todo el servidor.
    • Reiniciar recursos principales como qb-core, ox_lib u oxmysql afecta a todos los recursos que dependen de ellos. El agente marca esas acciones como críticas y pide una confirmación explícita.
    • Un reinicio completo del servidor desde Paralake.AI solo es posible en un servidor de desarrollo registrado y siempre pregunta antes. Paralake.AI nunca reinicia servidores de producción.
    • En un servidor en vivo, reinicia solo durante una ventana de mantenimiento y hazlo tú mismo.
  7. Notas sobre QBCore y ESX

    • Dile al agente cuál es tu framework. QBCore y ESX usan API distintas (por ejemplo exports['qb-core']:GetCoreObject() frente a exports['es_extended']:getSharedObject()), y mezclarlas es una causa habitual de errores.
    • Comprobaciones en el servidor. Las comprobaciones de dinero, objetos, precios y trabajos van en el script del servidor. Nunca te fíes de los valores enviados desde el cliente.
    • Dependencias. Si el recurso usa oxmysql, ox_lib o un recurso de target o de menú, debe figurar en el manifiesto e iniciarse antes en server.cfg.
    • Cambios en la base de datos. Si el recurso necesita una tabla, pide al agente el SQL en un archivo aparte y ejecútalo tú mismo primero contra la base de datos de desarrollo.
    • ¿Lag o tirones? Con tu aprobación, el agente puede grabar un perfil en un servidor de desarrollo registrado y señalar el recurso que peor rinde.
  8. Llega en 0.1.5: la consola del servidor sin RCON

    Disponible en la versión 0.1.5 (beta).

    • Cuando Paralake.AI ha iniciado tu servidor de desarrollo (por ejemplo con Restart and test en Server Studio, usando el comando de inicio que introdujiste), la IA puede ejecutar start, stop, restart, ensure y refresh directamente en la consola del servidor, sin necesidad de RCON.
    • Cada acción se verifica contra la consola en vivo: se te indica si el recurso se inició o se detuvo, falló o no se confirmó, además de cualquier error nuevo. Solo se informa de éxito cuando la consola lo confirma sin errores. Si reinicias un recurso que no está en marcha, el servidor lo rechaza, y la IA te lo dice y sugiere ensure en su lugar.
    • Cada acción pide tu aprobación, salvo que hayas iniciado una sesión de Trusted Workspace con el ámbito del servidor de desarrollo de FiveM. Los recursos principales como qb-core siguen marcándose como críticos, y los servidores de producción nunca se reinician.
    • Los servidores iniciados fuera de Paralake.AI —con txAdmin, una tarea programada o tu propio script de inicio— siguen necesitando txAdmin o RCON (introduce tú mismo la contraseña de RCON en Server Studio). Otro programa no puede escribir en una consola que no ha iniciado él.
    ensure my_rental
  9. Llega en 0.1.5: Error Doctor, un recurso con un solo prompt, comprobaciones de NUI

    Disponible en la versión 0.1.5 (beta).

    • Error Doctor: pide a la IA que encuentre y corrija errores en el servidor de desarrollo. Lee los últimos errores de la consola en vivo con recurso, archivo y línea, detiene solo ese recurso, corrige el archivo, lo valida, lo vuelve a iniciar con ensure y comprueba que no aparece ningún error nuevo. Mientras el servidor está en marcha, solo se editan así archivos de script de un recurso detenido dentro de [local]; los archivos de streaming nunca se modifican durante el funcionamiento.
    • Un recurso con un solo prompt: describe el recurso y la IA lo crea en resources/[local], ejecuta refresh y ensure y comprueba la consola.
    • Comprobaciones de NUI por niveles: sintaxis y manifiesto, vista previa en el navegador (la NUI en Chrome con callbacks simulados) y recurso iniciado en el servidor. La interacción en el runtime de FiveM y dentro del juego se indica siempre como no verificada; pruébala tú mismo en el juego.
    • La nota final se construye a partir de estas comprobaciones, no de lo que dice la propia IA. Si el texto de la IA contradice la última comprobación, se muestra una corrección.
  10. Cuando funcione

    Prueba con tu propio personaje en el servidor de desarrollo y después pasa el recurso terminado a producción con las herramientas que usas normalmente. Haz una copia de seguridad del servidor de producción antes de añadir nada. Si usas Git, haz primero un commit del recurso; consulta Use Git & GitHub with Paralake.AI.

Seguridad

  • Desarrolla en un servidor de desarrollo o en una copia, no en el servidor en vivo con jugadores.
  • Mantén las comprobaciones de dinero, objetos y precios en el servidor. Nunca te fíes de los valores enviados desde el cliente.
  • Nunca pegues en el chat secretos de server.cfg, la contraseña de RCON, sv_licenseKey ni contraseñas de bases de datos. Introduce tú mismo la contraseña de RCON en Server Studio.
  • Usa solo recursos que tengas derecho a usar. Los recursos filtrados o robados y las formas de saltarse licencias no están permitidos en Paralake.AI.

Solución de problemas

Couldn't find resource my_rental

Causas probables: El servidor no ha buscado carpetas nuevas desde que se creó el recurso. · El nombre de la carpeta y el nombre que va después de ensure no coinciden. · El recurso está fuera de la carpeta resources del servidor.

  1. Ejecuta refresh en la consola del servidor y después ensure my_rental de nuevo.
  2. Comprueba que el nombre de la carpeta y el nombre de ensure son exactamente iguales.
  3. Comprueba que la carpeta está dentro de resources/[local] en el servidor que estás ejecutando.

Contacta con soporte si: La carpeta está en el sitio correcto, se ha ejecutado refresh y el servidor sigue sin encontrarla. Soporte

El recurso se inicia, pero los errores mencionan qb-core o es_extended

Causas probables: El recurso se escribió para otro framework. · El framework se inicia después del recurso en server.cfg.

  1. Dile al agente qué framework y qué versión usas y pega el texto del error.
  2. Mueve la línea ensure de tu recurso por debajo del framework y del recurso de base de datos.
El agente no quiere modificar un recurso

Causas probables: El servidor está en marcha, y los archivos de recursos existentes no se modifican mientras funciona.

  1. Detén el servidor de desarrollo y vuelve a pedirlo.
  2. O pide al agente que cree una versión nueva en resources/[local].

Contacta con soporte si: El servidor está detenido y los cambios se siguen rechazando. Soporte

FAQ

¿Puedo crear directamente en mi servidor en vivo?

No lo hagas. Crea y prueba en un servidor de desarrollo o en una copia, y después pasa tú mismo el recurso terminado a producción. Paralake.AI nunca reinicia servidores de producción.

¿Funciona con ESX y ox?

Sí. El agente puede detectar recursos de QBCore, ESX y ox en tu servidor. Dile para qué framework debe trabajar para que use la API correcta.

¿Por qué solo resources/[local]?

Así los recursos nuevos quedan separados de los que ya tienes en marcha, y nada existente se sobrescribe por accidente.