Eventos da ponte de frameworks

O ai-core se apresenta como es_extended, qb-core, qbx_core e vrp, então scripts escritos para esses frameworks rodam sem alterações. Parte disso é disparar os eventos próprios do framework quando algo muda no ai-core: um personagem carrega, o dinheiro se move, um emprego muda. Esta página lista cada evento de framework que a ponte dispara, com os argumentos como a ponte os envia, e os eventos de framework que ela responde.

Código novo não deve usar estes eventos. Escreva com base nos eventos próprios do ai-core (servidor, cliente) e na lib: eles trazem mais (vários empregos, gangues, serviço) e não dependem do formato de um framework. Esta página é para rodar e corrigir scripts existentes de ESX / QB / vRP.

QBCore e Qbox: servidorCopy Anchor Link

A ponte dispara estes no servidor com TriggerEvent. Os scripts de Qbox escutam os mesmos nomes do QBCore; a ponte não dispara nenhum evento exclusivo do Qbox.

QBCore:Server:PlayerLoadedCopy Anchor Link

Um personagem foi carregado (a partir de ai-core:playerLoaded).

Lado: Servidor

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

Um personagem foi liberado: o jogador saiu ou voltou para a tela de personagens (a partir de ai-core:playerUnloaded).

Lado: Servidor

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

QBCore:Server:OnMoneyChangeCopy Anchor Link

O saldo de uma conta mudou (a partir de ai-core:moneyChanged).

Lado: Servidor

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

O emprego de framework do jogador mudou: um emprego adicionado ou removido, uma mudança de cargo, entrar ou sair de serviço, ou uma edição desse emprego no painel (a partir de ai-core:jobsChanged, ai-core:dutyChanged, ai-core:definitionsChanged).

Lado: Servidor

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

A gangue de framework do jogador mudou: a gangue ativa, a lista de gangues ou uma edição dessa gangue no painel (a partir de ai-core:gangsChanged, ai-core:activeGangChanged, ai-core:definitionsChanged).

Lado: Servidor

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

QBCore e Qbox: clienteCopy Anchor Link

Disparados no próprio cliente do jogador com 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: servidorCopy Anchor Link

esx:playerLoadedCopy Anchor Link

Um personagem foi carregado (a partir de ai-core:playerLoaded).

Lado: Servidor

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

esx:playerDroppedCopy Anchor Link

O jogador saiu do servidor (a partir de ai-core:playerUnloaded com o motivo dropped).

Lado: Servidor

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

esx:playerLogoutCopy Anchor Link

O jogador voltou para a tela de personagens e continua conectado (a partir de ai-core:playerUnloaded com o motivo switch).

Lado: Servidor

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

esx:setJobCopy Anchor Link

O emprego de framework do jogador mudou (nos mesmos momentos que QBCore:Server:OnJobUpdate).

Lado: Servidor

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

ESX: clienteCopy Anchor Link

Disparados no próprio cliente do jogador com TriggerEvent.

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

vRPCopy Anchor Link

A ponte vRP do ai-core dispara os eventos de servidor do vRP. O user_id do vRP é o id do personagem no ai-core.

vRP:playerJoinCopy Anchor Link

Um personagem foi carregado. (O vRP o dispara ao conectar; o ai-core só conhece o id depois que um personagem é carregado.)

Lado: Servidor

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

vRP:playerSpawnCopy Anchor Link

O personagem foi colocado no mundo. Dispara 2 segundos depois que o ai-core o fez aparecer, como no vRP. Só para o spawn de um carregamento de personagem: os respawns depois da morte vêm do script de morte e não o disparam.

Lado: Servidor

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

vRP:playerLeaveCopy Anchor Link

Um personagem foi liberado: o jogador saiu ou trocou de personagem.

Lado: Servidor

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

vRP:playerJoinGroup and vRP:playerLeaveGroupCopy Anchor Link

O personagem ganhou ou perdeu um grupo do vRP. Os grupos são os empregos do ai-core, a gangue ativa, os nomes de grupos que o dono do servidor mapeou no painel (aba "vRP scripts") e grupos extras que scripts de vRP adicionam. Dispara a cada mudança, também em mudanças que o ai-core ou outro script faz sem o vRP.

Lado: Servidor

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}`));

Eventos de framework que o ai-core respondeCopy Anchor Link

Scripts escritos para um framework enviam estes eventos esperando que o framework responda. O ai-core responde no lugar dele.