ai-death para desarrolladores

Funciones de la lib (recomendado)Copy Anchor Link

medical.reviveCopy Anchor Link

Levanta a un jugador abatido donde está tumbado.

Lado: Servidor · Espera: no

medical.revive(source: number): boolean

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

No hay aiLib.medical en Lua: llama al export de ai-core como arriba.

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

true cuando el jugador estaba abatido y ahora está en pie. false cuando no estaba abatido o no hay script de muerte en marcha.

EjemploCopy Anchor Link

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

// /revive <id> para los administradores de 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

Salud completa para un jugador que no está abatido.

Lado: Servidor · Espera: no

medical.heal(source: number): boolean

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

DevuelveCopy Anchor Link

true cuando un script de muerte aceptó la llamada. false cuando no hay script de muerte en marcha.

medical.isDeadCopy Anchor Link

Si un jugador está abatido.

Lado: Servidor · Espera: no

medical.isDead(source: number): boolean

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

DevuelveCopy Anchor Link

true mientras el jugador está abatido. false cuando está en pie o no hay script de muerte en marcha.

medical.providerCopy Anchor Link

El script de muerte que usa la capa médica.

Lado: Servidor · Espera: no

medical.provider(): string | null

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

DevuelveCopy Anchor Link

El nombre del recurso, o null / nil cuando no hay ningún script de muerte soportado en marcha.

medical.isDead (client)Copy Anchor Link

El estado de abatido del jugador local, en el cliente, sea cual sea el script de muerte en uso. Los scripts de muerte mantienen vivo a un ped abatido para animarlo, así que IsEntityDead solo no basta.

Lado: Cliente · Espera: no

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

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

EjemploCopy Anchor Link

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

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

medical.onChange((dead) => {
  if (dead) SendNUIMessage({ action: "close" }); // cierra tu pantalla cuando el jugador cae
});

Exports de servidorCopy Anchor Link

La capa médica los llama mientras ai-death está en marcha. Tipados como AiDeathServerExports en @aicore-fivem/shared, así que resourceExport("ai-death") los conoce. Revive e IsDead también responden como exports.qbx_medical:Revive / IsDead. Cada export también responde bajo su gemelo en minúsculas (revive).

ReviveCopy Anchor Link

Revive(source: number): boolean

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

Levanta a un jugador abatido donde está tumbado. true cuando estaba abatido, false en otro caso.

IsDeadCopy Anchor Link

IsDead(source: number): boolean

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

true mientras el jugador está abatido.

HealCopy Anchor Link

Heal(source: number): void

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

Salud completa para un jugador que no está abatido. No devuelve nada. En un jugador abatido levanta al ped pero el estado de abatido se queda: llama antes a Revive.

State bag deadCopy Anchor Link

true en el state bag del jugador mientras ai-death lo mantiene abatido; el servidor lo escribe. La clave es PLAYER_BAGS.dead en @aicore-fivem/shared.

local down = Player(source).state.dead == true   -- servidor
local down = LocalPlayer.state.dead == true      -- cliente, el jugador 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;

Léelo solo cuando sepas que ai-death está en marcha; medical.isDead funciona con cualquier script de muerte.

Metadata del personaje isdeadCopy Anchor Link

true mientras está abatido, guardado en el personaje (la clave de QBCore), así que un jugador que se reconecta abatido vuelve abatido. No lo escribas: ai-death lo fija cuando el jugador cae y lo borra cuando se levanta.

Evento de cliente hospital:client:ReviveCopy Anchor Link

El evento de reanimación de QBCore. Cuando el servidor se lo envía a un jugador, ai-death lo reanima donde está (lo usan scripts de QB y menús de administración).

Lado: Servidor -> cliente · Argumentos: ninguno

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

Eventos y callbacks privadosCopy Anchor Link

El contrato propio del script (resource/common/death.ts). Pueden cambiar entre versiones: no los dispares ni los escuches desde otros recursos.