Geliştiriciler için ai-exitsleeping

ai-exitsleeping’in bir server export’u, üç client export’u ve dört yerel hook event’i vardır (orijinal script’in düzenlenebilir hook’ları). Hiçbiri @aicore-fivem/shared içinde tiplenmemiştir: TypeScript’te onları callExport ile çağır.

Server export’larıCopy Anchor Link

AddCreateCheckCopy Anchor Link

Bir oyuncu çıkış yaptığında çalışan bir kontrol ekler. Uyuyan beden bırakmamak için false döndür (bir daire, bir etkinlik bölgesi, bir hapishane). Script’in bir bedenin kalmaması gereken yerleri biliyorsa kullan.

Taraf: Server · Bekler: hayır

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)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. Resource’un durduğunda kontrol kendiliğinden kaldırılır.

ÖrnekCopy Anchor Link

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

// Etkinlik arenasının içinde uyuyan beden yok (merkezinin 200 m çevresi).
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,
);

Client export’larıCopy Anchor Link

PlayerLoadedCopy Anchor Link

Yerel oyuncunun bedenini uyandırır ve etraftaki bedenleri göstermeye başlar. Bir doğuş script’inden, onun kendi son doğuşundan sonra ve sadece paneldeki Wake up on değeri PlayerLoaded export (spawn script) olduğunda çağır.

Taraf: Client · Bekler: hayır

PlayerLoaded(): void

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

Dönüş değeriCopy Anchor Link

Hiçbir şey. Bir sonraki karakter değişiminden önceki ikinci çağrı hiçbir şey yapmaz.

SetHiddenCopy Anchor Link

Herhangi bir sebep geçerli olduğu sürece bu client’taki her uyuyan bedeni gizler. Oyuncu bedenlerin yanlış görüneceği bir yerdeyken (bir shell iç mekân, bir ara sahne) kullan.

Taraf: Client · Bekler: hayır

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

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

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. Resource’un durduğunda sebeplerin kaldırılır.

ÖrnekCopy 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

Herhangi bir sebep geçerli olduğu sürece bu client’ta taşıma seçeneğini gizler (kendi kuralların: bir mini oyun, bir hapishane).

Taraf: Client · Bekler: hayır

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

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

Dönüş değeriCopy Anchor Link

Hiçbir şey. Sebep kuralları SetHidden ile aynıdır. Taşıma araçtayken, yere düşmüşken ve kelepçeliyken zaten engellidir.

Hook event’leriCopy Anchor Link

Dinleyebileceğin yerel event’ler (ağ üzerinden gönderilmez).

ai-exitsleeping:createdCopy Anchor Link

Çıkış yapan bir karakter için uyuyan bir beden oluşturuldu. Taraf: Server.

ai-exitsleeping:removedCopy Anchor Link

Uyuyan bir beden gitti (uyandı, süresi doldu, kapatıldı). Taraf: Server. Argüman: charId: number.

ai-exitsleeping:positionChangedCopy Anchor Link

Bir bedenin konumu değişti (taşındı, araçla götürüldü, yere bırakıldı). Taraf: Server. Argümanlar: charId: number, coords: { x, y, z, heading }.

ai-exitsleeping:client:pedSpawnedCopy Anchor Link

Bu client’ta uyuyan bir ped oluşturuldu. Taraf: Client. Argümanlar: ped: number (yerel, ağa bağlı olmayan bir ped), view: SleeperView.

// Server: beliren ve kaybolan her bedeni logla.
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

Dahili event’lerCopy Anchor Link

ai-exitsleeping:wake, area, client:area, look, startCarry, stopCarry, putInVehicle, takeOut kendi client’ı ile server’ı arasındadır; bunları çağırma.