Strefy

Strefa to obszar, który uruchamia kod, gdy gracz do niego wchodzi albo go opuszcza: wjazd do dzielnicy, obszar z ograniczeniem prędkości, marker rysowany tylko w pobliżu. Gdy gracz ma w tym miejscu coś zrobić (nacisnąć klawisz, wybrać opcję targetu), użyj zamiast tego punktu: to strefa z już podłączonym promptem, targetem, pedem i blipem.

W TypeScript każdą strefę sprawdza jeden mechanizm ai-lib za wszystkie zasoby (strefy leżą w siatce 64 m, więc milion stref kosztuje tyle samo co kilka). Twój zasób sprawdza własne strefy tylko wtedy, gdy ai-lib nie działa. W Lua każdy zasób uruchamia jedno zadanie harmonogramu dla swoich stref.

new ZonesCopy Anchor Link

Tworzy grupę stref. Zrób jedną grupę na funkcję na górze pliku.

Strona: Klient · Czeka: nie

new Zones()

local zones = aiLib.Zones.new()

Zwracana wartośćCopy Anchor Link

Grupa Zones z metodami poniżej.

PrzykładCopy Anchor Link

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

const zones = new Zones();

zones.addCopy Anchor Link

Dodaje strefę albo zastępuje strefę o tym samym id. Gdy gracz był wewnątrz zastępowanej strefy, najpierw działa jej onExit.

Strona: Klient · Czeka: nie

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

zones:add(id, options)

ParametryCopy Anchor Link

ZoneOptionsCopy Anchor Link

ZoneShapeCopy Anchor Link

ZoneShape to jeden z trzech obiektów, wybierany przez type:

W Lua center może być vector3, a punkty tabelami { x = ..., y = ... }.

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy 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

Usuwa jedną strefę. Gdy gracz był w środku, działa onExit. Nieznane id nic nie robi.

Strona: Klient · Czeka: nie

zones.remove(id: string): void

zones:remove(id)

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy Anchor Link

zones.remove("safezone");

zones.clearCopy Anchor Link

Usuwa każdą strefę grupy; onExit działa dla tych, w których jest gracz.

Strona: Klient · Czeka: nie

zones.clear(): void

zones:clear()

Zwracana wartośćCopy Anchor Link

void.

PrzykładCopy Anchor Link

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

zones.isInsideCopy Anchor Link

Czy gracz jest w strefie, według jej ostatniego sprawdzenia.

Strona: Klient · Czeka: nie

zones.isInside(id: string): boolean

local inside = zones:isInside(id)

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

boolean: true, dopóki jest w środku; false na zewnątrz albo dla nieznanego id. Odzwierciedla ostatnie sprawdzenie, więc może być stare do interval ms.

PrzykładCopy Anchor Link

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

zones.sizeCopy Anchor Link

Ile stref ma grupa.

Strona: Klient · Czeka: nie

zones.size: number // właściwość tylko do odczytu

Brak odpowiednika w Lua.

Zwracana wartośćCopy Anchor Link

number: liczba stref w tej grupie.

PrzykładCopy Anchor Link

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