Compatibilidad
Cómo AI Core ejecuta scripts de ESX, QBCore, Qbox y vRP y conecta recursos de terceros.
Casi todos los scripts de FiveM están escritos para ESX, QBCore, Qbox o vRP, así que poder ejecutarlos es un objetivo principal. AI Core no incluye scripts de terceros ni favorece a ningún proveedor: instalas los tuyos.
Tres capas
Puente de frameworks
AI Core proporciona es_extended, qb-core y qbx_core y responde a sus exports, objetos core, objetos de jugador, callbacks, eventos e inclusiones de archivos (@qb-core/shared/locale.lua, @es_extended/imports.lua, @qbx_core/modules/playerdata.lua), de modo que los scripts escritos para ESX, QBCore o Qbox ven a AI Core como su framework y funcionan sin cambios. Para los scripts de vRP, AI Core también proporciona vrp (mira Scripts de vRP más abajo). Sus menús, avisos de texto, barras de progreso y cuadros de entrada se dibujan con la propia interfaz de AI Core.
Capas de integración
AI Core y los scripts ai-* necesitan cosas que proporcionan otros scripts. Cada categoría tiene una interfaz y cada script compatible es un adaptador. AI Core detecta el script instalado al iniciar y cuando los scripts se inician o se detienen; el panel de administración puede cambiar la elección.
| Categoría | Ejemplos |
|---|---|
| Inventario | ai-inventory, ox_inventory, qb-inventory, tgiann-inventory y más |
| Llaves de vehículos | ai-vehiclekeys, qbx_vehiclekeys y otros |
| Dispatch (alertas policiales) | ai-policealert y scripts de alertas |
| Teléfono | tgiann-phone, lb-phone |
| Ropa | ai-appearance, tgiann-clothing |
| Muerte | ai-death, qbx_medical, qb-ambulancejob, esx_ambulancejob, ars_ambulancejob |
| Clima y hora | ai-weathersync, qb-weathersync, Renewed-Weathersync, cd_easytime |
| Prisión | ai-prison, qb-prison |
| Menú radial | ai-radialmenu, qb-radialmenu, ox_lib |
Sustitutos
Varios scripts ai-* responden a la API del script al que reemplazan, así que los scripts de terceros funcionan con ellos sin adaptador: ai-mysql sustituye a oxmysql (también a mysql-async y ghmattimysql), ai-inventory a ox_inventory y qb-inventory, ai-target a ox_target, ai-voice a pma-voice, ai-chat a chat, ai-vehicles y ai-vehiclekeys a los scripts de vehículos de Qbox.
Consulta la lista de scripts compatibles para ver con qué se integra AI Core hoy.
Scripts de vRP
AI Core también proporciona vrp, así que los scripts escritos para el framework vRP lo encuentran y funcionan con los personajes, el dinero, los trabajos, las bandas y el inventario de AI Core. No hay ningún ajuste: todas las versiones de abajo se responden a la vez, y AI Core las distingue por la forma en que lo llaman.
| Versión de vRP | Qué funciona |
|---|---|
| vRP 1.0 | Scripts que usan Proxy / Tunnel con vRP.* y vRPclient.*: usuarios, dinero, grupos y permisos, inventario y cofres, identidad, hambre y sed, menús, avisos de texto, notificaciones, blips y marcadores. |
| vRPex, Zirix, Dunko | Lo mismo, más las funciones extra que añaden estos forks de vRP 1 (format, hasPermissions, tryBankPayment y otras). |
| El antiguo estilo de llamadas de vRP 0.5 | Llamadas que pasan sus argumentos en una tabla con un callback, como vRP.getUserId({source}). |
| vRP 2 y vRP 3 | Extensiones que un script carga con vRP.loadScript. Cada una se ejecuta en su propio sandbox dentro de AI Core: sus globales nunca tocan otro script, y todo lo que registró se quita cuando su recurso se detiene. |
Los menús, avisos de texto y preguntas de sí / no de los scripts de vRP se dibujan con el menú y los diálogos propios de AI Core. Cuando un script añade entradas al menú principal de vRP, los jugadores lo abren con F7; puedes cambiar la tecla en Keybinds del panel de administración.
AI Core se probó en un servidor en marcha con siete scripts públicos de vRP: vrp_basic_mission, vrp_chests, vrp_blips, self_storages, vrp_drugfarms, vrp_worlditems y party_system.
Instalar un script de vRP
Quita el vRP original
AI Core es ahora tu recurso vrp, así que el original tiene que irse. Si tu servidor tiene una carpeta vrp o un driver de base de datos de vRP (vrp_mysql, vrp_oxmysql, vrp_ghmattimysql, vRP-db-drivers), borra la carpeta y su línea ensure en server.cfg. Mientras alguno siga ahí, AI Core rechaza las conexiones e indica qué carpeta borrar.
Añade el script
Pon la carpeta del script en resources/[standalone]/ y añade ensure <nombre de la carpeta> a server.cfg debajo de las líneas ensure ai-*, como con cualquier otro script. No edites el script: su dependencia vrp y su include @vrp/lib/utils.lua llegan a AI Core por sí solos.
Arráncalo y reparte sus permisos
Reinicia el servidor y prueba las funciones del script en el juego. Luego abre el panel de administración (F10) y la pestaña vRP scripts de AI Core: Asked permissions lista cada nombre de permiso que el script pidió. Decide quién recibe cada uno, como explica la siguiente sección.
La pestaña vRP scripts
Los scripts de vRP no preguntan «¿este jugador es policía?». Piden nombres de permiso (police.service), nombres de grupo (police, vip) e ids de ítem (edible|tacos). La pestaña vRP scripts, en la parte de AI Core del panel de administración, decide qué significan esos nombres en tu servidor. Cada cambio se guarda al instante, sin reiniciar. La pestaña tiene cinco tarjetas:
Built-in rules (reglas integradas)
Estos tres interruptores responden a todo nombre de permiso que ninguna regla menciona, así que muchos scripts funcionan antes de que añadas una sola regla:
- Job permissions go to the job: un permiso que empieza por el nombre de un trabajo, como
police.service, va a los miembros de ese trabajo. Con Only while on duty activado, solo lo tienen mientras están de servicio. - admin. permissions go to admins: un permiso que empieza por
admin., comoadmin.tickets, va a los jugadores con derechos de admin (ACEai.admin). - player. permissions go to everyone: un permiso que empieza por
player., comoplayer.phone, va a todos los jugadores.
Asked permissions (permisos pedidos)
Cada nombre de permiso que tus scripts han pedido, con un buscador. Pulsa Add rule junto a un nombre y aparece una regla para él arriba de Permission rules. Una regla nueva da el permiso solo a los admins, hasta que elijas quién debe tenerlo.
Permission rules (reglas de permisos)
Una fila por regla. En Permission name, escribe el permiso (police.service), o un nombre que termine en * (police.*) para cubrir todos los permisos que empiezan así. En Who has it, elige uno:
- Members of a job: elige el trabajo y el Lowest grade (ese rango y todos los superiores). Activa Only on duty si solo deben tenerlo de servicio.
- Members of a gang: elige la banda y el rango más bajo.
- Characters in a group: escribe un nombre de grupo que den los scripts (mira Group names).
- Admins o Everyone.
Varias reglas pueden nombrar el mismo permiso: quien cumpla cualquiera de ellas lo tiene. En cuanto una regla nombra un permiso, las reglas integradas dejan de contar para él. El panel rechaza un rango que el trabajo o la banda no tiene.
Group names (nombres de grupo)
Los scripts de vRP dan y comprueban grupos por su nombre. El nombre propio de un trabajo o de una banda (police, ballas) funciona sin fila. Para cualquier otro nombre que use un script (Coronel, sheriff), añade una fila: escríbelo en Group name y elige qué significa en Means:
- A job grade o A gang grade: cuando un script da este grupo, el personaje recibe ese trabajo o esa banda con ese rango; cuando un script lo comprueba, la respuesta es sí para ese rango y todos los superiores.
- Admins: la comprobación responde sí para los jugadores con derechos de admin. Un script nunca puede hacer admin a nadie: dar este grupo se rechaza.
Un nombre sin fila sigue siendo un grupo propio, guardado con el personaje.
Item names (nombres de ítem)
Vincula un id de ítem que usa un script (Name scripts use, como edible|tacos) con un ítem de tu inventario (Inventory item, elegido de la lista). Un id que ya es el nombre de uno de tus ítems no necesita fila. Sin fila, wbody|WEAPON_X significa el ítem del arma y cualquier otro id a|b significa b.
Ejemplo: un script de policía pide police.service, pero tu trabajo de policía se llama lspd. Añade una regla de permiso con el nombre police.service, Members of a job, el trabajo lspd, rango más bajo 0 y Only on duty activado. Ahora todo policía de servicio tiene el permiso.
Lo que no funciona con vRP
- Creative v5. Su API (nombres en PascalCase,
@vrp/lib/Utils.lua,@vrp/config/*.lua) es distinta y no se responde. - SQL sobre las tablas propias de vRP. AI Core guarda sus propios datos, así que un script que lee o escribe
vrp_users,vrp_user_identities,vrp_user_data,vrp_srv_datao tablas parecidas con sus propias consultas no encuentra nada. - Módulos de vRP que AI Core no tiene: agenda del teléfono, casas, negocios, vehículos propios y garajes, aptitudes, antecedentes policiales y cárcel, tiendas, transformadores de ítems, cajeros, audio y radio, barras de progreso, bans y whitelist, y las misiones de vRP 1 (las misiones de vRP 2 / 3 funcionan). Un script que los use pierde esa parte.
- Los menús no tienen izquierda / derecha. Las opciones que cambian un valor con las flechas solo aceptan una selección simple.
vRP:playerSpawnse dispara una vez por carga de personaje, no tras reaparecer: las reapariciones son cosa del script de muerte.vrpsiempre figura como iniciado. Un script que soporta varios frameworks y comprueba vRP primero usa su código de vRP. Si quieres su código de ESX o QBCore, elige ese framework en la configuración del propio script.- Una extensión de vRP 2 / 3 se ejecuta dentro de AI Core, así que su tiempo de CPU aparece bajo
ai-coreenresmon. Si falla, la consola escribe una línea con su archivo y AI Core sigue funcionando.
Reemplazar un script ai-*
Si instalas un script de pago que reemplaza a uno ai-* (por ejemplo, otro inventario), AI Core te dice qué carpeta borrar y rechaza las conexiones mientras ambos estén en marcha, para que dos scripts nunca se peleen por la misma tarea.
Añadir un script
Dar soporte a un script nuevo es un trabajo pequeño y repetible: copia la plantilla de adaptador de la categoría, rellena sus llamadas y añade una línea al registro. Puedes pedírselo a tu IA.