ai-core pour les développeurs
Où sont documentés les exports, events, state bags et le pont d’ai-core.
L’API d’ai-core est vaste, elle a donc ses propres pages de référence. Cette page renvoie vers elles.
Références
Exports serveur
Personnages et joueurs, argent, métiers et gangs, objets, clés, alertes, logs et tous les autres exports serveur, avec types et exemples.
Exports client
Données du joueur, le HUD, les aides de touches, le menu radial, l’apparence, la synchronisation du monde et les autres exports client.
Events
playerLoaded, moneyChanged, jobsChanged, dutyChanged et les autres events, avec leurs arguments et des exemples d’écoute.
La lib
@aicore-fivem/lib et aiLib : les utilitaires qui appellent ai-core pour vous.
Comment l’appeler
import { resourceExport } from "@aicore-fivem/lib/server";
// Typé AiCoreServerExports dans @aicore-fivem/shared.
const core = resourceExport("ai-core");
const character = core.GetCharacter(source);La plupart du temps, vous n’appelez pas vous-même les exports d’ai-core : les utilitaires de la lib (money, inventory, online, onCharacter, vehicleKeys, dispatch...) les enveloppent.
Ponts de framework
Les scripts écrits pour ESX, QBCore, Qbox ou vRP n’ont pas besoin de l’API propre à ai-core : ai-core répond à la leur (ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer, le Proxy et le Tunnel de vRP). Ce à quoi répond chaque pont et ses limites se trouvent sur la page Compatibilité.
State bags et GlobalState
| Clé | Où | Valeur |
|---|---|---|
ai:duty:<job> | GlobalState | Nombre de membres en service de ce métier. |
ai:pvp | GlobalState | Indique si les joueurs peuvent se blesser entre eux. |
ai:inventory, ai:vehicleKeys, ai:appearance, ai:medical, ai:fuel, ai:garages, ai:mdt, ai:notify | GlobalState | Le nom de ressource du script qu’ai-core utilise pour cette tâche. |
La liste complète avec leurs formes se trouve dans les références des exports serveur et des events.