ai-core
El framework. Jugadores y personajes, la pantalla de personajes, dinero, trabajos y bandas, permisos, el panel de administración y el puente ESX, QBCore, Qbox y vRP.
ai-core es AI Core en sí: el framework sobre el que se construyen todos los demás scripts. Sabe quién está jugando, qué personaje eligió, cuánto dinero tiene, a qué trabajos y bandas pertenece y quién es administrador. Aloja el panel de administración de todos los scripts y permite que los scripts de ESX, QBCore, Qbox y vRP funcionen sin cambios.
Esta página es un resumen. El panel de administración en sí se describe en Panel de administración.
Jugadores y personajes
- Cuentas. Un jugador se identifica por su cuenta de FiveM (el identificador
fivem:). Conectarse sin ella se rechaza. Los ids de licencia y de Discord se guardan junto a ella para los scripts que los leen. - Varios personajes por cuenta (3 ranuras por defecto). Los jugadores pueden borrar personajes salvo que lo desactives.
- Pantalla de personajes. Los personajes del jugador están en una escena real de la ciudad, cada uno con su ropa; la cámara se desliza hasta el elegido. En ella se muestran el nombre de tu servidor, el subtítulo y el lema.
- Crear un personaje pide nombre y apellido, fecha de nacimiento (edad mínima 18 por defecto), sexo y nacionalidad. Después, un personaje nuevo pasa por el creador de ropa (ai-appearance u otro script de ropa).
- Dónde aparecer. Un personaje nuevo aparece en el punto First spawn. De forma opcional, tras elegir un personaje, una lista muestra la última ubicación y los lugares que configures.
- Guardado. El dinero y las pertenencias a trabajos y bandas se guardan al momento. La posición, el blindaje y otros cambios pequeños se guardan cada 5 minutos (panel), al cerrar sesión, al detener el recurso y al apagar txAdmin.
- PvP. Un interruptor decide si los jugadores pueden hacerse daño entre sí (activado por defecto); los administradores lo cambian en el juego con
/togglepvp.
Dinero
- Cuentas Cash (500 al empezar), Bank (5000), Dirty money y Crypto por defecto. Añades, renombras o quitas cuentas en el panel (Money accounts), cada una con una cantidad inicial y si puede quedar por debajo de cero.
- Los trabajos y las bandas también tienen sus propias cuentas (dinero de sociedad).
- Cada cambio se escribe con una fila de registro: quién, cuánto, el motivo.
Trabajos y bandas
- Varios trabajos por personaje (3 por defecto, o uno cuando Several jobs per character está desactivado), y varias bandas (2 por defecto) con una banda activa.
- Servicio. Un personaje está de servicio como mucho en un trabajo. El salario solo viene del trabajo en el que está de servicio. Los jugadores empiezan fuera de servicio al entrar salvo que actives Keep duty after rejoining.
- Sueldo. Cada 15 minutos (panel) los jugadores de servicio reciben el salario de su rango en su cuenta bancaria, pagado por el servidor o, si lo eliges, desde la cuenta propia del trabajo.
- Hora punta. Fuera de las horas de más actividad (18:00 a 01:00 por defecto) los salarios bajan a la mitad. Las horas, el recorte y el interruptor están en el panel; un trabajo puede tener sus propias horas.
- Los trabajos y las bandas en sí (rangos, salarios, rangos de jefe) son registros de las pestañas Jobs y Gangs del panel.
Permisos
- Los administradores son los jugadores con el ACE
ai.admin. Elpermission.cfgde la receta se lo da agroup.admin; añade un jugador conadd_principal identifier.fivem:<id> group.admin. En un servidor nuevo, la tarjeta de bienvenida muestra la línea exacta. - Los comandos hechos con la lib de AI Core comprueban los permisos en el servidor: todos, administradores, o ciertos ACE y grupos. La pestaña Commands del panel lista cada comando con quién puede usarlo.
- Permisos de trabajo y banda. ai-core refleja las pertenencias en principals de ACE:
ai.job.<name>yai.job.<name>.<grade>(cada rango hasta el del jugador), y lo mismo para las bandas. Así,add_ace ai.job.police command.mdt allowda un comando a todos los agentes.
Panel de administración
ai-core aloja el panel del juego (F10 o /aiadmin) para sí mismo y para cada script ai-*. Sus propias secciones:
| Sección | Qué configuras |
|---|---|
| General | Nombre del servidor, subtítulo, lema y fondo; ranuras de personaje, borrado, edad mínima; el intervalo de guardado; qué scripts de inventario, llaves, alertas policiales, ropa, combustible, cerraduras, garajes, notificaciones, facturas, banco, MDT y médicos usa AI Core (Automatic elige el primero que esté en marcha); interacción por aviso o por target; PvP; comprobación de actualizaciones; rechazar jugadores mientras funciona un script innecesario; la guía de configuración. |
| Spawn points | El primer punto de aparición y los lugares entre los que pueden elegir los jugadores. |
| Character screen | La escena detrás de la pantalla de personajes: cámara, hora y clima, los puntos donde están los personajes. |
| Job and gang rules | Cuántos trabajos y bandas, el servicio al volver a entrar, el sueldo, la hora punta. |
| Jobs, Gangs | Cada trabajo y banda con sus rangos, salarios y rangos de jefe. |
| Money accounts | Los tipos de dinero y con qué empieza un personaje nuevo. |
| Keybinds | Las teclas de cada script: la tecla por defecto para todos y si el HUD la muestra como ayuda. |
| Commands | Cada comando del servidor con sus argumentos y quién puede usarlo. |
| Other panels | Pantallas de ajustes de otros scripts, abiertas desde el panel principal. |
| vRP scripts | Quién recibe los permisos, grupos y objetos que piden los scripts de vRP. |
| Logs | Consola, Discord, Fivemanage y FiveM Stats, niveles, webhooks. |
También comprueba si hay actualizaciones de cada script con repositorio en GitHub (una vez cada 6 horas por script) y recomienda en el panel principal scripts gratuitos que vale la pena instalar.
El puente (ESX, QBCore, Qbox, vRP)
ai-core hace provide de es_extended, qb-core, qbx_core y vrp, y responde a sus exports, objetos core y eventos. Los scripts escritos para esos frameworks ven a AI Core como su framework: ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer y las llamadas de vRP 1, 2 y 3 funcionan todas sobre los jugadores, el dinero y los trabajos de AI Core.
También dibuja los recursos de interfaz de los frameworks con los menús y tarjetas propios de AI Core: esx_context, esx_textui, esx_notify, esx_progressbar, esx_menu_default, esx_menu_dialog, esx_menu_list, qb-menu, qb-input y progressbar. Quita esos recursos: ai-core responde a sus nombres. Mira Compatibilidad.
Capas: un sitio para cada tipo de script
Los objetos, las llaves de vehículos, las alertas policiales, la ropa, las muertes y reanimaciones, la prisión, el combustible, las cerraduras, los garajes, la hora y el clima, las facturas, la banca, los teléfonos, el menú radial, el HUD y las notificaciones pasan todos por ai-core. Un script se lo pide a ai-core ("da este objeto"), y ai-core llama al script que uses para esa tarea. Por eso puedes cambiar casi cualquier script ai-* por uno de terceros, y por eso ai-core te avisa en la consola cuando funcionan a la vez dos scripts para la misma tarea.
Instalación
La receta de txAdmin de AI Core lo instala. A mano: pon la carpeta en resources/[ai]/ y añade ensure ai-core a server.cfg después de ensure ai-mysql y antes de cualquier otro script ai-*. Necesita OneSync y la base de datos:
add_convar_permission ai-core read mysql_connection_stringSus tablas (ai_core_users, ai_core_characters, ai_core_accounts, ai_core_transactions, ai_core_character_jobs, ai_core_character_gangs, ai_core_bills, ai_core_vrp_data) se crean en el primer inicio. No instales es_extended, qb-core ni qbx_core a su lado. Mantén set resources_useSystemChat false.
Comandos
| Comando | Argumentos | Quién | Qué hace |
|---|---|---|---|
/aiadmin | ninguno | administradores | Abre el panel de administración. |
/togglepvp | ninguno | administradores | Activa o desactiva el daño entre jugadores (guarda el ajuste del panel). |
aicore_switch | [id] | administradores | Devuelve a un jugador (por defecto: tú) a la pantalla de personajes. |
aicore_job | <job> <grade> [id] | administradores | Da un trabajo con un rango. |
aicore_duty | <job | off> [id] | administradores | Pone a un jugador de servicio en un trabajo, o fuera de servicio. |
aicore_money | <account> <amount> [id] | administradores | Suma a una cuenta (una cantidad negativa resta). |
aicore_gang | <gang> <grade> [id] | administradores | Da una banda con un rango. |
aicore_db | [slow] | administradores | Estadísticas de base de datos de cada recurso en la consola del servidor; slow lista las consultas lentas recientes. |
aicore_alert | [high] | administradores | Envía una alerta policial de prueba en tu posición a través del script de alertas activo. |
Los comandos aicore_* son herramientas de prueba: responden en la consola del servidor. Los comandos de administración conocidos de QB / ESX (setjob, givemoney...) vienen con ai-admin.
Teclas
| Tecla por defecto | Qué hace | Nombre en los ajustes de GTA |
|---|---|---|
| F10 | Abre el panel de administración (solo administradores) | Open the admin panel |
Límites conocidos
- Los jugadores necesitan una cuenta de FiveM vinculada (el identificador
fivem:); los jugadores sin ella no pueden entrar. - Un script cuyo sustituto funciona a la vez (tgiann-inventory junto a ai-inventory) deja fuera a todos mientras funcionen los dos, si Refuse players while both run está activado (por defecto). La consola indica la carpeta que hay que borrar.