ai-death pour les développeurs

Fonctions de la lib (recommandé)Copy Anchor Link

medical.reviveCopy Anchor Link

Relève un joueur à terre là où il se trouve.

Côté : serveur · Attend : non

medical.revive(source: number): boolean

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

Il n’y a pas de aiLib.medical en Lua : appelez l’export d’ai-core comme ci-dessus.

ParamètresCopy Anchor Link

RetourCopy Anchor Link

true quand le joueur était à terre et est maintenant debout. false quand il n’était pas à terre ou qu’aucun script de mort ne tourne.

ExempleCopy Anchor Link

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

// /revive <id> pour les administrateurs d’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

Santé au maximum pour un joueur qui n’est pas à terre.

Côté : serveur · Attend : non

medical.heal(source: number): boolean

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

RetourCopy Anchor Link

true quand un script de mort a pris l’appel. false quand aucun script de mort ne tourne.

medical.isDeadCopy Anchor Link

Indique si un joueur est à terre.

Côté : serveur · Attend : non

medical.isDead(source: number): boolean

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

RetourCopy Anchor Link

true tant que le joueur est à terre. false quand il est debout ou qu’aucun script de mort ne tourne.

medical.providerCopy Anchor Link

Le script de mort qu’utilise la couche médicale.

Côté : serveur · Attend : non

medical.provider(): string | null

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

RetourCopy Anchor Link

Le nom de la ressource, ou null / nil quand aucun script de mort pris en charge ne tourne.

medical.isDead (client)Copy Anchor Link

L’état à terre du joueur local, côté client, quel que soit le script de mort qui tourne. Les scripts de mort gardent en vie un ped à terre pour l’animer, donc IsEntityDead seul ne suffit pas.

Côté : client · Attend : non

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

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

ExempleCopy Anchor Link

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

RegisterCommand("emote", () => {
  if (medical.isDead()) return notify("Not while down", "error");
  // ... jouer l’emote
}, false);

medical.onChange((dead) => {
  if (dead) SendNUIMessage({ action: "close" }); // fermer votre écran quand le joueur tombe à terre
});

Exports serveurCopy Anchor Link

La couche médicale les appelle tant qu’ai-death tourne. Typés AiDeathServerExports dans @aicore-fivem/shared, donc resourceExport("ai-death") les connaît. Revive et IsDead répondent aussi en tant que exports.qbx_medical:Revive / IsDead. Chaque export répond aussi sous son jumeau en minuscules (revive).

ReviveCopy Anchor Link

Revive(source: number): boolean

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

Relève un joueur à terre là où il se trouve. true quand il était à terre, false sinon.

IsDeadCopy Anchor Link

IsDead(source: number): boolean

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

true tant que le joueur est à terre.

HealCopy Anchor Link

Heal(source: number): void

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

Santé au maximum pour un joueur qui n’est pas à terre. Ne renvoie rien. Sur un joueur à terre, relève le ped mais l’état à terre reste : appelez d’abord Revive.

State bag deadCopy Anchor Link

true sur le state bag du joueur tant qu’ai-death le garde à terre ; le serveur l’écrit. La clé est PLAYER_BAGS.dead dans @aicore-fivem/shared.

local down = Player(source).state.dead == true   -- serveur
local down = LocalPlayer.state.dead == true      -- client, le joueur local

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;

Ne le lisez que si vous savez qu’ai-death tourne ; medical.isDead fonctionne avec chaque script de mort.

Métadonnée de personnage isdeadCopy Anchor Link

true tant que le joueur est à terre, stockée sur le personnage (la clé de QBCore), donc un joueur qui se reconnecte à terre revient à terre. Ne l’écrivez pas : ai-death la règle quand le joueur tombe à terre et l’efface quand il se relève.

Event client hospital:client:ReviveCopy Anchor Link

L’event de réanimation de QBCore. Quand le serveur l’envoie à un joueur, ai-death le réanime là où il se trouve (les scripts QB et les menus d’administration l’utilisent).

Côté : serveur -> client · Arguments : aucun

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

Events et callbacks privésCopy Anchor Link

Le contrat propre du script (resource/common/death.ts). Ils peuvent changer d’une version à l’autre : ne les déclenchez pas et ne les écoutez pas depuis d’autres ressources.