ai-core para desenvolvedores
Onde os exports, eventos, state bags e a ponte do ai-core estão documentados.
A API do ai-core é grande, então ela tem suas próprias páginas de referência. Esta página aponta para elas.
Referências
Exports do servidor
Personagens e jogadores, dinheiro, empregos e gangues, itens, chaves, alertas, logs e todos os outros exports do servidor, com tipos e exemplos.
Exports do cliente
Dados do jogador, o HUD, dicas de teclas, o menu radial, aparência, sincronização do mundo e os outros exports do cliente.
Eventos
playerLoaded, moneyChanged, jobsChanged, dutyChanged e os outros eventos, com seus argumentos e exemplos de listener.
A lib
@aicore-fivem/lib e aiLib: os helpers que chamam o ai-core por você.
Como chamá-lo
import { resourceExport } from "@aicore-fivem/lib/server";
// Tipado como AiCoreServerExports em @aicore-fivem/shared.
const core = resourceExport("ai-core");
const character = core.GetCharacter(source);Na maior parte do tempo você não chama os exports do ai-core por conta própria: os helpers da lib (money, inventory, online, onCharacter, vehicleKeys, dispatch...) os envolvem.
Pontes de frameworks
Scripts escritos para ESX, QBCore, Qbox ou vRP não precisam da API própria do ai-core: o ai-core responde às deles (ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer, o Proxy e o Tunnel do vRP). O que cada ponte responde e os limites dela estão em Compatibilidade.
State bags e GlobalState
| Chave | Onde | Valor |
|---|---|---|
ai:duty:<job> | GlobalState | Número de membros em serviço daquele emprego. |
ai:pvp | GlobalState | Se os jogadores podem machucar uns aos outros. |
ai:inventory, ai:vehicleKeys, ai:appearance, ai:medical, ai:fuel, ai:garages, ai:mdt, ai:notify | GlobalState | O nome do recurso do script que o ai-core usa para aquela tarefa. |
A lista completa com os formatos está nas referências de exports do servidor e de eventos.