ai-death dla deweloperów

Funkcje biblioteki (zalecane)Copy Anchor Link

medical.reviveCopy Anchor Link

Stawia powalonego gracza na nogi tam, gdzie leży.

Strona: serwer · Czeka: nie

medical.revive(source: number): boolean

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

W Lua nie ma aiLib.medical: wywołaj eksport ai-core jak wyżej.

ParametryCopy Anchor Link

ZwracaCopy Anchor Link

true, gdy gracz był powalony i teraz wstał. false, gdy nie był powalony albo nie działa żaden skrypt śmierci.

PrzykładCopy Anchor Link

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

// /revive <id> dla administratorów 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

Pełne zdrowie dla gracza, który nie jest powalony.

Strona: serwer · Czeka: nie

medical.heal(source: number): boolean

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

ZwracaCopy Anchor Link

true, gdy skrypt śmierci przyjął wywołanie. false, gdy nie działa żaden skrypt śmierci.

medical.isDeadCopy Anchor Link

Czy gracz jest powalony.

Strona: serwer · Czeka: nie

medical.isDead(source: number): boolean

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

ZwracaCopy Anchor Link

true, dopóki gracz jest powalony. false, gdy stoi albo nie działa żaden skrypt śmierci.

medical.providerCopy Anchor Link

Skrypt śmierci, którego używa warstwa medyczna.

Strona: serwer · Czeka: nie

medical.provider(): string | null

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

ZwracaCopy Anchor Link

Nazwa zasobu albo null / nil, gdy nie działa żaden obsługiwany skrypt śmierci.

medical.isDead (client)Copy Anchor Link

Stan powalenia lokalnego gracza, po stronie klienta, bez względu na działający skrypt śmierci. Skrypty śmierci utrzymują powalonego peda przy życiu, aby go animować, więc samo IsEntityDead nie wystarcza.

Strona: klient · Czeka: nie

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

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

PrzykładCopy Anchor Link

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

RegisterCommand("emote", () => {
  if (medical.isDead()) return notify("Not while down", "error");
  // ... odtwórz emotkę
}, false);

medical.onChange((dead) => {
  if (dead) SendNUIMessage({ action: "close" }); // zamknij swój ekran, gdy gracz zostanie powalony
});

Eksporty serweraCopy Anchor Link

Warstwa medyczna wywołuje je, gdy działa ai-death. Typowane jako AiDeathServerExports w @aicore-fivem/shared, więc resourceExport("ai-death") je zna. Revive i IsDead odpowiadają też jako exports.qbx_medical:Revive / IsDead. Każdy eksport odpowiada też pod swoim odpowiednikiem pisanym małą literą (revive).

ReviveCopy Anchor Link

Revive(source: number): boolean

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

Stawia powalonego gracza na nogi tam, gdzie leży. true, gdy był powalony, w przeciwnym razie false.

IsDeadCopy Anchor Link

IsDead(source: number): boolean

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

true, dopóki gracz jest powalony.

HealCopy Anchor Link

Heal(source: number): void

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

Pełne zdrowie dla gracza, który nie jest powalony. Nic nie zwraca. Na powalonym graczu stawia peda na nogi, ale stan powalenia zostaje: najpierw wywołaj Revive.

State bag deadCopy Anchor Link

true w state bagu gracza, dopóki ai-death trzyma go powalonego; zapisuje go serwer. Klucz to PLAYER_BAGS.dead w @aicore-fivem/shared.

local down = Player(source).state.dead == true   -- serwer
local down = LocalPlayer.state.dead == true      -- klient, lokalny gracz

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;

Czytaj go tylko wtedy, gdy wiesz, że działa ai-death; medical.isDead działa z każdym skryptem śmierci.

Metadane postaci isdeadCopy Anchor Link

true podczas powalenia, zapisywane w postaci (klucz QBCore), więc gracz, który połączy się ponownie, będąc powalonym, wraca powalony. Nie zapisuj go: ai-death ustawia go, gdy gracz zostaje powalony, i czyści, gdy wstaje.

Zdarzenie klienta hospital:client:ReviveCopy Anchor Link

Zdarzenie reanimacji QBCore. Gdy serwer wyśle je do gracza, ai-death reanimuje go tam, gdzie stoi (używają go skrypty QB i menu administratora).

Strona: serwer -> klient · Argumenty: brak

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

Prywatne zdarzenia i callbackiCopy Anchor Link

Własny kontrakt skryptu (resource/common/death.ts). Mogą się zmieniać między wersjami: nie wywołuj ich ani nie nasłuchuj ich z innych zasobów.