Bölgeler

Bölge (zone), oyuncu içine girdiğinde ya da çıktığında kod çalıştıran bir alandır: bir semte girmek, bir hız sınırı alanı, yalnızca yakındayken çizilen bir marker. Oyuncunun o yerde bir şey yapması gerekiyorsa (bir tuşa basmak, bir target seçeneği seçmek) bunun yerine bir nokta kullan: prompt’u, target’ı, ped’i ve blip’i zaten bağlanmış bir bölgedir.

TypeScript’te her bölge, tüm resource’lar için ai-lib’in tek denetleyicisi tarafından kontrol edilir (bölgeler 64 m’lik bir ızgarada durur; bu yüzden bir milyon bölge birkaç bölgeyle aynı maliyettedir). Resource’un kendi bölgelerini yalnızca ai-lib çalışmıyorken kendisi kontrol eder. Lua’da her resource bölgeleri için tek bir zamanlayıcı görevi çalıştırır.

new ZonesCopy Anchor Link

Bir bölge grubu oluşturur. Dosyanın en üstünde, özellik başına bir grup oluştur.

Taraf: Client · Bekler: hayır

new Zones()

local zones = aiLib.Zones.new()

Dönüş değeriCopy Anchor Link

Aşağıdaki metotlara sahip bir Zones grubu.

ÖrnekCopy Anchor Link

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

const zones = new Zones();

zones.addCopy Anchor Link

Bir bölge ekler ya da aynı id’ye sahip bölgenin yerine geçer. Yerine geçilen bölgenin içinde oyuncu varsa önce onun onExit’i çalışır.

Taraf: Client · Bekler: hayır

zones.add(id: string, options: ZoneOptions): void

zones:add(id, options)

ParametrelerCopy Anchor Link

ZoneOptionsCopy Anchor Link

ZoneShapeCopy Anchor Link

ZoneShape, type’a göre seçilen üç nesneden biridir:

Lua’da center bir vector3, noktalar da { x = ..., y = ... } tabloları olabilir.

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

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

const Locale = createLocale<typeof import("../../locales/en.json")>();
const zones = new Zones();

zones.add("safezone", {
  shape: { type: "cylinder", center: { x: 298.6, y: -584.5, z: 43.3 }, radius: 60, height: 30 },
  onEnter: () => notify(Locale("SAFEZONE_IN"), "info"),
  onExit: () => notify(Locale("SAFEZONE_OUT"), "info"),
});

zones.add("yard", {
  shape: {
    type: "poly",
    points: [
      { x: 1700.1, y: 2560.4 },
      { x: 1780.6, y: 2560.4 },
      { x: 1780.6, y: 2620.2 },
      { x: 1700.1, y: 2620.2 },
    ],
    minZ: 40,
    maxZ: 60,
  },
  interval: 1000,
  onEnter: () => SetPedMoveRateOverride(PlayerPedId(), 0.8),
});

zones.removeCopy Anchor Link

Tek bir bölgeyi kaldırır. Oyuncu içerideyse onExit çalışır. Bilinmeyen bir id hiçbir şey yapmaz.

Taraf: Client · Bekler: hayır

zones.remove(id: string): void

zones:remove(id)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

zones.remove("safezone");

zones.clearCopy Anchor Link

Grubun tüm bölgelerini kaldırır; oyuncunun içinde olduğu bölgeler için onExit çalışır.

Taraf: Client · Bekler: hayır

zones.clear(): void

zones:clear()

Dönüş değeriCopy Anchor Link

void.

ÖrnekCopy Anchor Link

onServerEvent("myscript:eventOver", () => zones.clear());

zones.isInsideCopy Anchor Link

Son kontrole göre oyuncunun bir bölgenin içinde olup olmadığı.

Taraf: Client · Bekler: hayır

zones.isInside(id: string): boolean

local inside = zones:isInside(id)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: içerideyken true; dışarıdayken ya da bilinmeyen bir id için false. Son kontrolü yansıtır; bu yüzden en fazla interval ms eski olabilir.

ÖrnekCopy Anchor Link

if (zones.isInside("safezone")) return notify(Locale("NO_WEAPONS_HERE"), "error");

zones.sizeCopy Anchor Link

Grubun kaç bölge tuttuğu.

Taraf: Client · Bekler: hayır

zones.size: number // salt okunur özellik

Lua karşılığı yok.

Dönüş değeriCopy Anchor Link

number: bu gruptaki bölge sayısı.

ÖrnekCopy Anchor Link

console.log(`${zones.size} zones loaded`);