ai-exitsleeping para desenvolvedores

O ai-exitsleeping tem um export do servidor, três exports do cliente e quatro eventos de hook locais (os hooks editáveis do script original). Nenhum é tipado em @aicore-fivem/shared: em TypeScript chame-os com callExport.

Exports do servidorCopy Anchor Link

AddCreateCheckCopy Anchor Link

Adiciona uma verificação que roda quando um jogador sai do jogo. Retorne false para não deixar corpo dormindo (um apartamento, uma zona de evento, uma prisão). Use quando seu script conhece lugares onde um corpo não deve ficar.

Lado: Servidor · Espera: não

AddCreateCheck(id: string, check: (source: number, charId: number, coords: { x: number; y: number; z: number; heading: number }) => boolean): void

exports['ai-exitsleeping']:AddCreateCheck(id, function(source, charId, coords) return true end)

ParâmetrosCopy Anchor Link

RetornoCopy Anchor Link

Nada. A verificação é removida sozinha quando seu recurso para.

ExemploCopy Anchor Link

import { callExport } from "@aicore-fivem/lib/server";

// Sem corpos dormindo dentro da arena do evento (200 m ao redor do centro dela).
const ARENA = { x: -324.0, y: -1968.0, z: 21.6 };
callExport("ai-exitsleeping", "AddCreateCheck", "arena",
  (_source: number, _charId: number, c: { x: number; y: number; z: number }) =>
    Math.hypot(c.x - ARENA.x, c.y - ARENA.y) > 200,
);

Exports do clienteCopy Anchor Link

PlayerLoadedCopy Anchor Link

Acorda o corpo do jogador local e começa a mostrar os corpos ao redor. Chame-o a partir de um script de spawn depois do spawn final dele, e só quando o Wake up on do painel for PlayerLoaded export (spawn script).

Lado: Cliente · Espera: não

PlayerLoaded(): void

exports['ai-exitsleeping']:PlayerLoaded()

RetornoCopy Anchor Link

Nada. Uma segunda chamada antes da próxima troca de personagem não faz nada.

SetHiddenCopy Anchor Link

Esconde todos os corpos dormindo neste cliente enquanto houver algum motivo ativo. Use enquanto o jogador está em um lugar onde os corpos ficariam estranhos (um interior shell, uma cutscene).

Lado: Cliente · Espera: não

SetHidden(reason: string, hidden: boolean): void

exports['ai-exitsleeping']:SetHidden('myshell', true)

ParâmetrosCopy Anchor Link

RetornoCopy Anchor Link

Nada. Seus motivos são removidos quando seu recurso para.

ExemploCopy Anchor Link

import { callExport } from "@aicore-fivem/lib/client";

export function enterShell(): void {
  callExport("ai-exitsleeping", "SetHidden", "shell", true);
}
export function leaveShell(): void {
  callExport("ai-exitsleeping", "SetHidden", "shell", false);
}

SetCarryBlockedCopy Anchor Link

Esconde a opção de carregar neste cliente enquanto houver algum motivo ativo (suas próprias regras: um minigame, uma prisão).

Lado: Cliente · Espera: não

SetCarryBlocked(reason: string, blocked: boolean): void

exports['ai-exitsleeping']:SetCarryBlocked('minigame', true)

RetornoCopy Anchor Link

Nada. Mesmas regras de motivos que SetHidden. Carregar já é bloqueado em um veículo, enquanto caído e enquanto algemado.

Eventos de hookCopy Anchor Link

Eventos locais (não enviados pela rede) que você pode escutar.

ai-exitsleeping:createdCopy Anchor Link

Um corpo dormindo foi criado para um personagem que saiu do jogo. Lado: Servidor.

ai-exitsleeping:removedCopy Anchor Link

Um corpo dormindo sumiu (acordou, expirou, foi desligado). Lado: Servidor. Argumento: charId: number.

ai-exitsleeping:positionChangedCopy Anchor Link

A posição de um corpo mudou (carregado, levado em um veículo, colocado no chão). Lado: Servidor. Argumentos: charId: number, coords: { x, y, z, heading }.

ai-exitsleeping:client:pedSpawnedCopy Anchor Link

Um ped dormindo foi criado neste cliente. Lado: Cliente. Argumentos: ped: number (um ped local, não em rede), view: SleeperView.

// Servidor: registra no log todo corpo que aparece e desaparece.
on("ai-exitsleeping:created", (charId: number, view: { x: number; y: number; z: number }) => {
  console.log(`character ${charId} fell asleep at ${view.x}, ${view.y}, ${view.z}`);
});
on("ai-exitsleeping:removed", (charId: number) => {
  console.log(`character ${charId} woke up`);
});

SleeperViewCopy Anchor Link

Eventos internosCopy Anchor Link

ai-exitsleeping:wake, area, client:area, look, startCarry, stopCarry, putInVehicle, takeOut ficam entre o cliente e o servidor dele; não os chame.