ai-exitsleeping pour les développeurs

ai-exitsleeping a un export serveur, trois exports client et quatre events de hook locaux (les hooks modifiables du script d’origine). Aucun n’est typé dans @aicore-fivem/shared : en TypeScript, appelez-les avec callExport.

Exports serveurCopy Anchor Link

AddCreateCheckCopy Anchor Link

Ajoute une vérification qui s’exécute quand un joueur se déconnecte. Renvoyez false pour ne laisser aucun corps endormi (un appartement, une zone d’événement, une prison). Utilisez-la quand votre script connaît des endroits où un corps ne doit pas rester.

Côté : serveur · Attend : non

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)

ParamètresCopy Anchor Link

RetourCopy Anchor Link

Rien. La vérification est retirée d’elle-même quand votre ressource s’arrête.

ExempleCopy Anchor Link

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

// Pas de corps endormis dans l’arène d’événement (200 m autour de son centre).
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 clientCopy Anchor Link

PlayerLoadedCopy Anchor Link

Réveille le corps du joueur local et commence à afficher les corps alentour. Appelez-le depuis un script d’apparition après sa propre apparition finale, et uniquement quand le Wake up on du panneau vaut PlayerLoaded export (spawn script).

Côté : client · Attend : non

PlayerLoaded(): void

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

RetourCopy Anchor Link

Rien. Un second appel avant le prochain changement de personnage ne fait rien.

SetHiddenCopy Anchor Link

Masque chaque corps endormi sur ce client tant qu’au moins une raison est active. Utilisez-le pendant que le joueur est dans un endroit où les corps auraient l’air déplacés (un intérieur shell, une cinématique).

Côté : client · Attend : non

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

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

ParamètresCopy Anchor Link

RetourCopy Anchor Link

Rien. Vos raisons sont retirées quand votre ressource s’arrête.

ExempleCopy 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

Masque l’option de port sur ce client tant qu’au moins une raison est active (vos propres règles : un mini-jeu, une prison).

Côté : client · Attend : non

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

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

RetourCopy Anchor Link

Rien. Mêmes règles de raisons que SetHidden. Le port est déjà bloqué dans un véhicule, à terre et menotté.

Events de hookCopy Anchor Link

Des events locaux (non envoyés sur le réseau) que vous pouvez écouter.

ai-exitsleeping:createdCopy Anchor Link

Un corps endormi a été créé pour un personnage qui s’est déconnecté. Côté : serveur.

ai-exitsleeping:removedCopy Anchor Link

Un corps endormi a disparu (réveillé, expiré, désactivé). Côté : serveur. Argument : charId: number.

ai-exitsleeping:positionChangedCopy Anchor Link

La position d’un corps a changé (porté, transporté en véhicule, posé). Côté : serveur. Arguments : charId: number, coords: { x, y, z, heading }.

ai-exitsleeping:client:pedSpawnedCopy Anchor Link

Un ped endormi a été créé sur ce client. Côté : client. Arguments : ped: number (un ped local, non réseau), view: SleeperView.

// Serveur : journaliser chaque corps qui apparaît et disparaît.
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

Events internesCopy Anchor Link

ai-exitsleeping:wake, area, client:area, look, startCarry, stopCarry, putInVehicle, takeOut circulent entre son propre client et son serveur ; ne les appelez pas.