Events der Framework-Brücke

ai-core gibt sich als es_extended, qb-core, qbx_core und vrp aus, sodass für diese Frameworks geschriebene Skripte ohne Änderungen laufen. Dazu gehört, die eigenen Events des Frameworks auszulösen, wenn sich in ai-core etwas ändert: Ein Charakter lädt, Geld bewegt sich, ein Job ändert sich. Diese Seite listet jedes Framework-Event, das die Brücke auslöst, mit den Argumenten, wie die Brücke sie sendet, und die Framework-Events, die sie beantwortet.

Neuer Code sollte diese nicht nutzen. Schreibe gegen die eigenen Events von ai-core (Server, Client) und die Lib: Sie tragen mehr (mehrere Jobs, Gangs, Dienst) und hängen nicht von der Form eines Frameworks ab. Diese Seite ist dafür da, bestehende ESX- / QB- / vRP-Skripte zu betreiben und zu reparieren.

QBCore und Qbox: ServerCopy Anchor Link

Die Brücke löst diese auf dem Server mit TriggerEvent aus. Qbox-Skripte hören auf dieselben QBCore-Namen; die Brücke löst kein reines Qbox-Event aus.

QBCore:Server:PlayerLoadedCopy Anchor Link

Ein Charakter wurde geladen (aus ai-core:playerLoaded).

Seite: Server

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

Ein Charakter wurde losgelassen: Der Spieler ist gegangen oder zum Charakterbildschirm zurückgekehrt (aus ai-core:playerUnloaded).

Seite: Server

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

QBCore:Server:OnMoneyChangeCopy Anchor Link

Ein Kontostand hat sich geändert (aus ai-core:moneyChanged).

Seite: Server

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

Der Framework-Job des Spielers hat sich geändert: ein Job hinzugefügt oder entfernt, eine Rangänderung, in den Dienst oder außer Dienst gehen oder eine Panel-Bearbeitung dieses Jobs (aus ai-core:jobsChanged, ai-core:dutyChanged, ai-core:definitionsChanged).

Seite: Server

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

Die Framework-Gang des Spielers hat sich geändert: die aktive Gang, die Gang-Liste oder eine Panel-Bearbeitung dieser Gang (aus ai-core:gangsChanged, ai-core:activeGangChanged, ai-core:definitionsChanged).

Seite: Server

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

QBCore und Qbox: ClientCopy Anchor Link

Werden im eigenen Client des Spielers mit TriggerEvent ausgelöst.

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: ServerCopy Anchor Link

esx:playerLoadedCopy Anchor Link

Ein Charakter wurde geladen (aus ai-core:playerLoaded).

Seite: Server

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

esx:playerDroppedCopy Anchor Link

Der Spieler hat den Server verlassen (aus ai-core:playerUnloaded mit dem Grund dropped).

Seite: Server

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

esx:playerLogoutCopy Anchor Link

Der Spieler ist zum Charakterbildschirm zurückgekehrt und bleibt verbunden (aus ai-core:playerUnloaded mit dem Grund switch).

Seite: Server

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

esx:setJobCopy Anchor Link

Der Framework-Job des Spielers hat sich geändert (zu denselben Zeitpunkten wie QBCore:Server:OnJobUpdate).

Seite: Server

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

ESX: ClientCopy Anchor Link

Werden im eigenen Client des Spielers mit TriggerEvent ausgelöst.

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

vRPCopy Anchor Link

Die vRP-Brücke von ai-core löst die Server-Events von vRP aus. Die vRP-user_id ist die Charakter-ID von ai-core.

vRP:playerJoinCopy Anchor Link

Ein Charakter wurde geladen. (vRP löst es beim Verbinden aus; ai-core kennt die ID erst, wenn ein Charakter geladen ist.)

Seite: Server

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

vRP:playerSpawnCopy Anchor Link

Der Charakter wurde in die Welt gesetzt. Wird 2 Sekunden nach dem Spawn durch ai-core ausgelöst, wie bei vRP. Nur beim Spawn eines geladenen Charakters: Respawns nach dem Tod kommen vom Tod-Skript und lösen es nicht aus.

Seite: Server

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

vRP:playerLeaveCopy Anchor Link

Ein Charakter wurde losgelassen: Der Spieler ist gegangen oder hat den Charakter gewechselt.

Seite: Server

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

vRP:playerJoinGroup and vRP:playerLeaveGroupCopy Anchor Link

Der Charakter hat eine vRP-Gruppe bekommen oder verloren. Gruppen sind die Jobs von ai-core, die aktive Gang, die Gruppennamen, die der Serverbesitzer im Panel zugeordnet hat (Tab "vRP scripts", vRP-Skripte), und zusätzliche Gruppen, die vRP-Skripte hinzufügen. Wird bei jeder Änderung ausgelöst, auch bei Änderungen, die ai-core oder ein anderes Skript ohne vRP vornimmt.

Seite: Server

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

Framework-Events, die ai-core beantwortetCopy Anchor Link

Für ein Framework geschriebene Skripte senden diese Events und erwarten, dass das Framework antwortet. ai-core beantwortet sie stattdessen.