ai-death для разработчиков

Функции lib (рекомендуется)Copy Anchor Link

medical.reviveCopy Anchor Link

Поднимает лежащего без сознания игрока там, где он лежит.

Сторона: сервер · Ожидание: нет

medical.revive(source: number): boolean

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

В Lua нет aiLib.medical: вызывайте экспорт ai-core, как выше.

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

true, если игрок лежал без сознания и теперь поднялся. false, если он не был без сознания или ни один скрипт смерти не запущен.

ПримерCopy Anchor Link

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

// /revive <id> для администраторов 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

Полное здоровье для игрока, который не лежит без сознания.

Сторона: сервер · Ожидание: нет

medical.heal(source: number): boolean

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

ВозвращаетCopy Anchor Link

true, если скрипт смерти принял вызов. false, если ни один скрипт смерти не запущен.

medical.isDeadCopy Anchor Link

Лежит ли игрок без сознания.

Сторона: сервер · Ожидание: нет

medical.isDead(source: number): boolean

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

ВозвращаетCopy Anchor Link

true, пока игрок без сознания. false, если он на ногах или ни один скрипт смерти не запущен.

medical.providerCopy Anchor Link

Скрипт смерти, который использует медицинский слой.

Сторона: сервер · Ожидание: нет

medical.provider(): string | null

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

ВозвращаетCopy Anchor Link

Имя ресурса или null / nil, если ни один поддерживаемый скрипт смерти не запущен.

medical.isDead (client)Copy Anchor Link

Состояние без сознания локального игрока на клиенте, какой бы скрипт смерти ни был запущен. Скрипты смерти держат лежащего педа живым, чтобы анимировать его, поэтому одного IsEntityDead недостаточно.

Сторона: клиент · Ожидание: нет

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

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

ПримерCopy Anchor Link

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

RegisterCommand("emote", () => {
  if (medical.isDead()) return notify("Not while down", "error");
  // ... проиграть эмоцию
}, false);

medical.onChange((dead) => {
  if (dead) SendNUIMessage({ action: "close" }); // закрыть ваш экран, когда игрок теряет сознание
});

Серверные экспортыCopy Anchor Link

Медицинский слой вызывает их, пока запущен ai-death. Типизированы как AiDeathServerExports в @aicore-fivem/shared, поэтому resourceExport("ai-death") их знает. Revive и IsDead также отвечают как exports.qbx_medical:Revive / IsDead. Каждый экспорт также отвечает под своим двойником в нижнем регистре (revive).

ReviveCopy Anchor Link

Revive(source: number): boolean

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

Поднимает лежащего без сознания игрока там, где он лежит. true, если он был без сознания, иначе false.

IsDeadCopy Anchor Link

IsDead(source: number): boolean

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

true, пока игрок без сознания.

HealCopy Anchor Link

Heal(source: number): void

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

Полное здоровье для игрока, который не лежит без сознания. Ничего не возвращает. Лежащего без сознания игрока поднимает, но состояние без сознания остаётся: сначала вызовите Revive.

State bag deadCopy Anchor Link

true в state bag игрока, пока ai-death держит его без сознания; пишет его сервер. Ключ PLAYER_BAGS.dead в @aicore-fivem/shared.

local down = Player(source).state.dead == true   -- сервер
local down = LocalPlayer.state.dead == true      -- клиент, локальный игрок

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;

Читайте его, только если знаете, что запущен ai-death; medical.isDead работает с любым скриптом смерти.

Метаданные персонажа isdeadCopy Anchor Link

true, пока игрок без сознания, хранится в персонаже (ключ QBCore), поэтому игрок, который переподключился без сознания, возвращается без сознания. Не пишите в него: ai-death выставляет его, когда игрок теряет сознание, и очищает, когда тот поднимается.

Клиентское событие hospital:client:ReviveCopy Anchor Link

Событие реанимации QBCore. Когда сервер отправляет его игроку, ai-death реанимирует его там, где он стоит (его используют скрипты QB и админ-меню).

Сторона: сервер -> клиент · Аргументы: нет

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

Приватные события и колбэкиCopy Anchor Link

Собственный контракт скрипта (resource/common/death.ts). Они могут меняться между версиями: не вызывайте и не слушайте их из других ресурсов.