Événements du pont de framework

ai-core se présente comme es_extended, qb-core, qbx_core et vrp, si bien que les scripts écrits pour ces frameworks tournent sans modification. Cela passe notamment par le déclenchement des propres événements du framework quand quelque chose change dans ai-core : un personnage se charge, de l’argent bouge, un métier change. Cette page liste chaque événement de framework que déclenche le pont, avec les arguments tels que le pont les envoie, et les événements de framework auxquels il répond.

Le nouveau code ne doit pas les utiliser. Écrivez avec les propres événements d’ai-core (serveur, client) et la lib : ils transportent davantage (plusieurs métiers, gangs, service) et ne dépendent pas de la forme d’un framework. Cette page sert à faire tourner et à corriger des scripts ESX / QB / vRP existants.

QBCore et Qbox : serveurCopy Anchor Link

Le pont les déclenche sur le serveur avec TriggerEvent. Les scripts Qbox écoutent les mêmes noms QBCore ; le pont ne déclenche aucun événement propre à Qbox.

QBCore:Server:PlayerLoadedCopy Anchor Link

Un personnage a été chargé (depuis ai-core:playerLoaded).

Côté : Serveur

on("QBCore:Server:PlayerLoaded", (player: { PlayerData: { source: number; citizenid: string } }) => {
  console.log(`${player.PlayerData.citizenid} loaded (src ${player.PlayerData.source})`);
});

QBCore:Server:OnPlayerUnloadCopy Anchor Link

Un personnage a été libéré : le joueur est parti ou revenu à l’écran des personnages (depuis ai-core:playerUnloaded).

Côté : Serveur

on("QBCore:Server:OnPlayerUnload", (source: number) => console.log(`${source} unloaded`));

QBCore:Server:OnMoneyChangeCopy Anchor Link

Le solde d’un compte a changé (depuis ai-core:moneyChanged).

Côté : Serveur

on("QBCore:Server:OnMoneyChange", (source: number, account: string, amount: number, action: "add" | "remove", reason: string) => {
  console.log(`${source} ${action} ${amount} ${account} (${reason})`);
});

QBCore:Server:OnJobUpdateCopy Anchor Link

Le métier de framework du joueur a changé : un métier ajouté ou retiré, un changement de grade, une prise ou fin de service, ou une modification de ce métier dans le panneau (depuis ai-core:jobsChanged, ai-core:dutyChanged, ai-core:definitionsChanged).

Côté : Serveur

on("QBCore:Server:OnJobUpdate", (source: number, job: { name: string; onduty: boolean; grade: { level: number } }) => {
  console.log(`${source}: ${job.name} grade ${job.grade.level}, on duty ${job.onduty}`);
});

QBCore:Server:OnGangUpdateCopy Anchor Link

Le gang de framework du joueur a changé : le gang actif, la liste des gangs, ou une modification de ce gang dans le panneau (depuis ai-core:gangsChanged, ai-core:activeGangChanged, ai-core:definitionsChanged).

Côté : Serveur

on("QBCore:Server:OnGangUpdate", (source: number, gang: { name: string }) => console.log(`${source}: gang ${gang.name}`));

QBCore et Qbox : clientCopy Anchor Link

Déclenchés sur le propre client du joueur avec TriggerEvent.

on("QBCore:Client:OnPlayerLoaded", () => console.log("loaded"));
on("QBCore:Client:OnJobUpdate", (job: { name: string }) => console.log(`job: ${job.name}`));
on("QBCore:Client:SetDuty", (onDuty: boolean) => console.log(`on duty: ${onDuty}`));

ESX : serveurCopy Anchor Link

esx:playerLoadedCopy Anchor Link

Un personnage a été chargé (depuis ai-core:playerLoaded).

Côté : Serveur

on("esx:playerLoaded", (source: number, xPlayer: { identifier: string }) => {
  console.log(`${xPlayer.identifier} loaded (src ${source})`);
});

esx:playerDroppedCopy Anchor Link

Le joueur a quitté le serveur (depuis ai-core:playerUnloaded avec la raison dropped).

Côté : Serveur

on("esx:playerDropped", (source: number) => console.log(`${source} left`));

esx:playerLogoutCopy Anchor Link

Le joueur est revenu à l’écran des personnages et reste connecté (depuis ai-core:playerUnloaded avec la raison switch).

Côté : Serveur

on("esx:playerLogout", (source: number) => console.log(`${source} switched character`));

esx:setJobCopy Anchor Link

Le métier de framework du joueur a changé (aux mêmes moments que QBCore:Server:OnJobUpdate).

Côté : Serveur

on("esx:setJob", (source: number, job: { name: string; grade: number }) => {
  console.log(`${source}: ${job.name} grade ${job.grade}`);
});

ESX : clientCopy Anchor Link

Déclenchés sur le propre client du joueur avec TriggerEvent.

on("esx:playerLoaded", () => console.log("loaded"));
on("esx:setAccountMoney", (account: { name: string; money: number }) => console.log(`${account.name}: ${account.money}`));

vRPCopy Anchor Link

Le pont vRP d’ai-core déclenche les événements serveur de vRP. Le user_id de vRP est l’id de personnage d’ai-core.

vRP:playerJoinCopy Anchor Link

Un personnage a été chargé. (vRP le déclenche à la connexion ; ai-core ne connaît l’id qu’une fois un personnage chargé.)

Côté : Serveur

on("vRP:playerJoin", (userId: number, source: number, name: string) => console.log(`${name} joined as user ${userId} (src ${source})`));

vRP:playerSpawnCopy Anchor Link

Le personnage a été placé dans le monde. Se déclenche 2 secondes après qu’ai-core l’a fait apparaître, comme vRP. Uniquement pour l’apparition d’un chargement de personnage : les réapparitions après la mort viennent du script de mort et ne le déclenchent pas.

Côté : Serveur

on("vRP:playerSpawn", (userId: number, source: number, firstSpawn: boolean) => {
  if (firstSpawn) console.log(`user ${userId} spawned (src ${source})`);
});

vRP:playerLeaveCopy Anchor Link

Un personnage a été libéré : le joueur est parti ou a changé de personnage.

Côté : Serveur

on("vRP:playerLeave", (userId: number, source: number) => console.log(`user ${userId} left (src ${source})`));

vRP:playerJoinGroup et vRP:playerLeaveGroupCopy Anchor Link

Le personnage a obtenu ou perdu un groupe vRP. Les groupes sont les métiers d’ai-core, le gang actif, les noms de groupes que le propriétaire du serveur a associés dans le panneau (onglet "vRP scripts"), et les groupes supplémentaires qu’ajoutent les scripts vRP. Se déclenche à chaque changement, y compris ceux qu’ai-core ou un autre script fait sans vRP.

Côté : Serveur

on("vRP:playerJoinGroup", (userId: number, group: string, gtype?: string) => console.log(`user ${userId} joined ${group} (${gtype ?? "group"})`));
on("vRP:playerLeaveGroup", (userId: number, group: string) => console.log(`user ${userId} left ${group}`));

Événements de framework auxquels ai-core répondCopy Anchor Link

Les scripts écrits pour un framework envoient ces événements en attendant que le framework réponde. ai-core y répond à sa place.