События моста фреймворков

ai-core представляется как es_extended, qb-core, qbx_core и vrp, поэтому скрипты, написанные под эти фреймворки, работают без изменений. Частью этого является отправка собственных событий фреймворка, когда в ai-core что-то меняется: загружается персонаж, перемещаются деньги, меняется работа. На этой странице перечислены все события фреймворков, которые отправляет мост, с аргументами в том виде, в каком их отправляет мост, и события фреймворков, на которые он отвечает.

Новый код не должен их использовать. Пишите под собственные события ai-core (серверные, клиентские) и библиотеку: они несут больше (несколько работ, банды, дежурство) и не зависят от формы фреймворка. Эта страница нужна для запуска и исправления существующих скриптов ESX / QB / vRP.

QBCore и Qbox: серверCopy Anchor Link

Мост отправляет их на сервере через TriggerEvent. Скрипты Qbox слушают те же имена QBCore; мост не отправляет событий, существующих только в Qbox.

QBCore:Server:PlayerLoadedCopy Anchor Link

Персонаж загружен (из ai-core:playerLoaded).

Сторона: сервер

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

Персонаж отпущен: игрок ушёл или вернулся на экран персонажей (из ai-core:playerUnloaded).

Сторона: сервер

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

QBCore:Server:OnMoneyChangeCopy Anchor Link

Изменился баланс счёта (из ai-core:moneyChanged).

Сторона: сервер

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

Изменилась работа игрока во фреймворке: работа добавлена или удалена, изменился ранг, заступление на дежурство или уход с него, или правка этой работы в панели (из ai-core:jobsChanged, ai-core:dutyChanged, ai-core:definitionsChanged).

Сторона: сервер

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

Изменилась банда игрока во фреймворке: активная банда, список банд или правка этой банды в панели (из ai-core:gangsChanged, ai-core:activeGangChanged, ai-core:definitionsChanged).

Сторона: сервер

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

QBCore и Qbox: клиентCopy Anchor Link

Отправляются на клиенте самого игрока через 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: серверCopy Anchor Link

esx:playerLoadedCopy Anchor Link

Персонаж загружен (из ai-core:playerLoaded).

Сторона: сервер

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

esx:playerDroppedCopy Anchor Link

Игрок покинул сервер (из ai-core:playerUnloaded с причиной dropped).

Сторона: сервер

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

esx:playerLogoutCopy Anchor Link

Игрок вернулся на экран персонажей и остаётся подключённым (из ai-core:playerUnloaded с причиной switch).

Сторона: сервер

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

esx:setJobCopy Anchor Link

Изменилась работа игрока во фреймворке (в те же моменты, что и QBCore:Server:OnJobUpdate).

Сторона: сервер

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

ESX: клиентCopy Anchor Link

Отправляются на клиенте самого игрока через TriggerEvent.

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

vRPCopy Anchor Link

Мост vRP в ai-core отправляет серверные события vRP. user_id в vRP - это id персонажа в ai-core.

vRP:playerJoinCopy Anchor Link

Персонаж загружен. (vRP отправляет его при подключении; ai-core узнаёт id только после загрузки персонажа.)

Сторона: сервер

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

vRP:playerSpawnCopy Anchor Link

Персонаж помещён в мир. Срабатывает через 2 секунды после того, как ai-core его заспавнил, как в vRP. Только для спавна при загрузке персонажа: возрождения после смерти идут от скрипта смерти и его не вызывают.

Сторона: сервер

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

vRP:playerLeaveCopy Anchor Link

Персонаж отпущен: игрок ушёл или сменил персонажа.

Сторона: сервер

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

vRP:playerJoinGroup and vRP:playerLeaveGroupCopy Anchor Link

Персонаж получил или потерял группу vRP. Группы - это работы ai-core, активная банда, имена групп, которые владелец сервера сопоставил в панели (вкладка «vRP scripts»), и дополнительные группы, которые добавляют скрипты vRP. Срабатывает при каждом изменении, в том числе при изменениях, которые ai-core или другой скрипт делает без vRP.

Сторона: сервер

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

События фреймворков, на которые отвечает ai-coreCopy Anchor Link

Скрипты, написанные под фреймворк, отправляют эти события, ожидая ответа от фреймворка. Вместо него отвечает ai-core.