Traducción automática – aún no revisada por un hablante nativo.
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.
Capítulos
- 00:00 Qué carpeta abrir
- 00:50 Dónde van los recursos nuevos
- 01:30 Pedir un recurso
- 02:30 ensure en server.cfg
- 03:10 Probar y reiniciar de forma segura
- 04:20 Notas sobre QBCore y ESX
Guion / transcripción
Así es como creas un recurso de FiveM con Paralake.AI y lo pruebas de forma segura.
Primero, la carpeta. En Home, abre la carpeta de datos de tu servidor de desarrollo local, la que contiene server.cfg y la carpeta resources. Usa un servidor de desarrollo o una copia, nunca el servidor en vivo con jugadores.
Los recursos nuevos siempre van en resources barra [local]. Los archivos de recursos existentes no se modifican mientras el servidor está en marcha.
Ahora pide el recurso. Indica el framework —QBCore o ESX— y di qué debe comprobarse en el servidor. El agente escribe el fxmanifest y los scripts, con un punto de restauración para cada cambio.
Para iniciar el recurso, añade una línea ensure para él en server.cfg, después del framework y del recurso de base de datos.
Para probarlo, ejecuta refresh y después ensure con el nombre del recurso en la consola del servidor. Si has registrado el servidor en Server Studio e introducido tú mismo la contraseña de RCON, el agente puede ejecutar estos comandos por ti, pero solo después de que apruebes cada uno. Reiniciar un recurso principal como qb-core se marca como crítico, y Paralake.AI nunca reinicia servidores de producción.
Por último: mantén el dinero, los objetos y los precios en el lado del servidor, y nunca te fíes de los valores del cliente.
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.
-
Abre la carpeta correcta
En Home, elige la carpeta de datos de tu servidor de desarrollo, la carpeta que contiene
server.cfgy la carpetaresources.- 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íneaensureaserver.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. - Si abres la carpeta de datos, el agente puede ver
-
Dónde van los recursos nuevos
Los recursos nuevos siempre van en
resources/[local], en una carpeta propia, por ejemploresources/[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.
- El nombre de la carpeta es el nombre del recurso que usas con
-
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.
-
Añádelo a server.cfg
Para que el recurso se inicie automáticamente, añade una línea
ensureaserver.cfgdespués de los recursos de los que depende, normalmente el recurso de base de datos (por ejemplooxmysql) y tu framework (qb-coreoes_extended):ensure oxmysql ensure qb-core ensure my_rentalSi tu
server.cfgya tieneensure [local], todos los recursos de esa carpeta se inician automáticamente y no necesitas una línea aparte.ensure my_rental -
Prueba en tu servidor de desarrollo
- Inicia tu servidor de desarrollo si no está en marcha.
- En la consola del servidor, ejecuta
refreshpara que el servidor encuentre la carpeta nueva. - Ejecuta
ensure my_rental(usa el nombre de la carpeta de tu recurso). - 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,ensureyrestartpara 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 -
Reinicia de forma segura
- Es preferible reiniciar un solo recurso (
restart my_rentaloensure my_rental) que reiniciar todo el servidor. - Reiniciar recursos principales como
qb-core,ox_libuoxmysqlafecta 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.
- Es preferible reiniciar un solo recurso (
-
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 aexports['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_libo un recurso de target o de menú, debe figurar en el manifiesto e iniciarse antes enserver.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.
- Dile al agente cuál es tu framework. QBCore y ESX usan API distintas (por ejemplo
-
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,ensureyrefreshdirectamente 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
ensureen 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-coresiguen 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 - 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
-
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
ensurey 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], ejecutarefreshyensurey 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.
- 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
-
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.
- Ejecuta
refreshen la consola del servidor y despuésensure my_rentalde nuevo. - Comprueba que el nombre de la carpeta y el nombre de ensure son exactamente iguales.
- 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.
- Dile al agente qué framework y qué versión usas y pega el texto del error.
- 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.
- Detén el servidor de desarrollo y vuelve a pedirlo.
- 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.