ai-death für Entwickler

Lib-Funktionen (empfohlen)Copy Anchor Link

medical.reviveCopy Anchor Link

Bringt einen Spieler am Boden dort wieder auf die Beine, wo er liegt.

Seite: Server · Wartet: nein

medical.revive(source: number): boolean

local ok = exports['ai-core']:RevivePlayer(source)

Es gibt kein aiLib.medical in Lua: Rufe den Export von ai-core wie oben auf.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

true, wenn der Spieler am Boden war und jetzt steht. false, wenn er nicht am Boden war oder kein Todesskript läuft.

BeispielCopy Anchor Link

import { addCommand, medical, notify } from "@aicore-fivem/lib/server";

// /revive <id> für Admins von ai-core.
addCommand(
  "revive",
  { help: "Revive a player", restricted: true, params: [{ name: "id", type: "playerId" }] as const },
  (source, { id }) => {
    if (!medical.revive(id) && source > 0) notify(source, "That player is not down", "error");
  },
);

medical.healCopy Anchor Link

Volle Gesundheit für einen Spieler, der nicht am Boden ist.

Seite: Server · Wartet: nein

medical.heal(source: number): boolean

local ok = exports['ai-core']:HealPlayer(source)

RückgabewertCopy Anchor Link

true, wenn ein Todesskript den Aufruf angenommen hat. false, wenn kein Todesskript läuft.

medical.isDeadCopy Anchor Link

Ob ein Spieler am Boden ist.

Seite: Server · Wartet: nein

medical.isDead(source: number): boolean

local down = exports['ai-core']:IsPlayerDead(source)

RückgabewertCopy Anchor Link

true, solange der Spieler am Boden ist. false, wenn er steht oder kein Todesskript läuft.

medical.providerCopy Anchor Link

Das Todesskript, das der Medizin-Layer nutzt.

Seite: Server · Wartet: nein

medical.provider(): string | null

local name = exports['ai-core']:GetMedicalSystem() -- 'ai-death', 'qbx_medical'... oder nil

RückgabewertCopy Anchor Link

Der Ressourcenname oder null / nil, wenn kein unterstütztes Todesskript läuft.

medical.isDead (Client)Copy Anchor Link

Der Zustand am Boden des lokalen Spielers, auf dem Client, egal welches Todesskript läuft. Todesskripte halten einen Ped am Boden am Leben, um ihn zu animieren, daher reicht IsEntityDead allein nicht.

Seite: Client · Wartet: nein

medical.isDead(): boolean
medical.onChange(fn: (dead: boolean) => void): void

local down = exports['ai-core']:IsDead()

BeispielCopy Anchor Link

import { medical, notify } from "@aicore-fivem/lib/client";

RegisterCommand("emote", () => {
  if (medical.isDead()) return notify("Not while down", "error");
  // ... das Emote abspielen
}, false);

medical.onChange((dead) => {
  if (dead) SendNUIMessage({ action: "close" }); // deinen Bildschirm schließen, wenn der Spieler zu Boden geht
});

Server-ExportsCopy Anchor Link

Der Medizin-Layer ruft diese auf, solange ai-death läuft. Typisiert als AiDeathServerExports in @aicore-fivem/shared, sodass resourceExport("ai-death") sie kennt. Revive und IsDead antworten auch als exports.qbx_medical:Revive / IsDead. Jeder Export antwortet auch unter seinem kleingeschriebenen Gegenstück (revive).

ReviveCopy Anchor Link

Revive(source: number): boolean

local ok = exports['ai-death']:Revive(source)

Bringt einen Spieler am Boden dort wieder auf die Beine, wo er liegt. true, wenn er am Boden war, sonst false.

IsDeadCopy Anchor Link

IsDead(source: number): boolean

local down = exports['ai-death']:IsDead(source)

true, solange der Spieler am Boden ist.

HealCopy Anchor Link

Heal(source: number): void

exports['ai-death']:Heal(source)

Volle Gesundheit für einen Spieler, der nicht am Boden ist. Gibt nichts zurück. Bei einem Spieler am Boden bringt es den Ped auf die Beine, aber der Zustand am Boden bleibt: Rufe zuerst Revive auf.

State Bag deadCopy Anchor Link

true im State Bag des Spielers, solange ai-death ihn am Boden hält; der Server schreibt ihn. Der Schlüssel ist PLAYER_BAGS.dead in @aicore-fivem/shared.

local down = Player(source).state.dead == true   -- Server
local down = LocalPlayer.state.dead == true      -- Client, der lokale Spieler

import { PlayerState, stateBoolean } from "@aicore-fivem/lib/server";
import { PLAYER_BAGS } from "@aicore-fivem/shared";

const dead = new PlayerState(PLAYER_BAGS.dead, stateBoolean);
const down = dead.get(source) === true;

Lies ihn nur, wenn du weißt, dass ai-death läuft; medical.isDead funktioniert mit jedem Todesskript.

Charakter-Metadaten isdeadCopy Anchor Link

true, solange am Boden, am Charakter gespeichert (der Schlüssel von QBCore), sodass ein Spieler, der sich am Boden neu verbindet, am Boden zurückkommt. Schreibe ihn nicht: ai-death setzt ihn, wenn der Spieler zu Boden geht, und löscht ihn, wenn er aufsteht.

Client-Event hospital:client:ReviveCopy Anchor Link

Das Wiederbelebungs-Event von QBCore. Wenn der Server es an einen Spieler sendet, belebt ai-death ihn dort wieder, wo er steht (QB-Skripte und Admin-Menüs nutzen es).

Seite: Server -> Client · Argumente: keine

emitNet("hospital:client:Revive", target);

Private Events und CallbacksCopy Anchor Link

Der eigene Vertrag des Skripts (resource/common/death.ts). Sie können sich zwischen Versionen ändern: Löse sie nicht aus anderen Ressourcen aus und höre nicht darauf.