Dostęp, blipy i NPC miejsc

Większość miejsc, które dodaje skrypt (sklep, schowek, garaż, ratusz), ma te same trzy części panelu: kto może z niego korzystać, jego blip na mapie i NPC, który tam stoi. Każda część przychodzi jako trójka: specyfikacja danych do twojego schema.ts, gotowe pola panelu z etykietami samego ai-core i czytnik zapisanej wartości. Używaj ich, żeby panel każdego skryptu wyglądał i działał tak samo.

import { readAccess, isPublic, decideAccess, ACCESS_FIELDS, accessFields, readBlipStyle, BLIP_STYLE_FIELDS, PLACE_PED_SPEC, placePedFields, readPlacePed } from "@aicore-fivem/lib/shared";

Lua: żadna z nich nie ma odpowiednika w Lua (panel administratora jest tylko dla TypeScript).

DostępCopy Anchor Link

Reguła to AccessRule: jedna z wymienionych prac (od minimalnego stopnia, na służbie, gdy ustawiono onDuty) albo jeden z wymienionych gangów (od minimalnego stopnia). Obie listy puste oznaczają wszystkich. Sprawdzenie na kliencie (allows(rule), zobacz Członkostwo i dane gracza) i na serwerze (online.allows(source, rule), zobacz Gracze i postacie) używają tej samej decyzji, więc to, co widzi gracz, zgadza się z tym, na co pozwala serwer.

readAccessCopy Anchor Link

Czyta regułę dostępu z własnych pól rekordu (jobs, gangs, grades, onDuty). Brakujące pola oznaczają, że może z niego korzystać każdy.

Strona: Klient, serwer i NUI · Czeka: nie

readAccess(value: unknown): AccessRule

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

AccessRule. Nazwy, które nie są stringami, są usuwane; stopnie, które nie są liczbami całkowitymi od 0 w górę, są usuwane.

PrzykładCopy Anchor Link

import { readAccess } from "@aicore-fivem/lib/shared";

readAccess({ label: "Armoury", jobs: ["police"], grades: { police: 2 }, onDuty: true });
// { jobs: ["police"], gangs: [], grades: { police: 2 }, onDuty: true }

isPublicCopy Anchor Link

Czy reguła wpuszcza wszystkich (żadne prace ani gangi nie są wymienione). Używaj jej, żeby pominąć sprawdzenia i pokazać miejsce wszystkim.

Strona: Klient, serwer i NUI · Czeka: nie

isPublic(rule: AccessRule): boolean

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

true, gdy zarówno jobs, jak i gangs są puste.

PrzykładCopy Anchor Link

import { isPublic, readAccess } from "@aicore-fivem/lib/shared";

isPublic(readAccess({})); // true

decideAccessCopy Anchor Link

Decyzja reguły na podstawie członkostw gracza. allows klienta i online.allows serwera wywołują ją za ciebie; wywołuj ją sam tylko wtedy, gdy masz członkostwa w inny sposób (strona NUI, test).

Strona: Klient, serwer i NUI · Czeka: nie

decideAccess(
  rule: AccessRule,
  jobs: ReadonlyArray<{ job: string; grade: number }>,
  gangs: ReadonlyArray<{ gang: string; grade: number }>,
  dutyJob: string | null,
): boolean

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

true, gdy reguła jest publiczna, gdy wymieniony gang pasuje od minimalnego stopnia albo gdy wymieniona praca pasuje od minimalnego stopnia (a gracz jest w niej na służbie, gdy ustawiono onDuty).

PrzykładCopy Anchor Link

import { decideAccess, readAccess } from "@aicore-fivem/lib/shared";

const rule = readAccess({ jobs: ["police"], grades: { police: 2 }, onDuty: true });
decideAccess(rule, [{ job: "police", grade: 3 }], [], "police"); // true
decideAccess(rule, [{ job: "police", grade: 3 }], [], null);     // false: poza służbą

ACCESS_FIELDSCopy Anchor Link

Specyfikacja danych pól dostępu, do rozwinięcia w sections pliku rekordów w twoim schema.ts.

Strona: Klient, serwer i NUI · Czeka: nie

const ACCESS_FIELDS: Record<string, DataSpec>
// { jobs: nazwy z wyszukiwaniem prac, opcjonalne; gangs: nazwy z wyszukiwaniem gangów, opcjonalne; onDuty: bool, opcjonalne }

PrzykładCopy Anchor Link

import { ACCESS_FIELDS } from "@aicore-fivem/lib/shared";

const stashSections = {
  label: { type: "text", min: 1, max: 48 },
  coords: { type: "vec3" },
  ...ACCESS_FIELDS,
};

accessFieldsCopy Anchor Link

Pola panelu reguły dostępu (tagi prac, tagi gangów, przełącznik służby) z już ustawionymi etykietami i podpowiedziami panelu samego ai-core.

Strona: Klient, serwer i NUI · Czeka: nie

accessFields(): WidgetSpec[]

Zwracana wartośćCopy Anchor Link

WidgetSpec[]: trzy pola pod ścieżkami jobs, gangs i onDuty. Rozwiń je w fields karty w tabs twojego panelu.

PrzykładCopy Anchor Link

import { accessFields } from "@aicore-fivem/lib/shared";

import type { CardSpec } from "@aicore-fivem/shared";

const accessCard: CardSpec = { icon: "lock", title: "ADMIN_CARD_ACCESS", fields: [...accessFields()] };

BlipyCopy Anchor Link

readBlipStyleCopy Anchor Link

Czyta styl blipa z danych panelu. Każda brakująca albo zła część pochodzi z wartości zastępczej; wartości są trzymane w zakresie (sprite 0-1000, kolor 0-100, skala 0.3-2).

Strona: Klient, serwer i NUI · Czeka: nie

readBlipStyle(value: unknown, fallback: BlipStyle): BlipStyle

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

BlipStyle.

PrzykładCopy Anchor Link

import { readBlipStyle } from "@aicore-fivem/lib/shared";

readBlipStyle({ sprite: 52, color: 500 }, { sprite: 52, color: 2, scale: 0.8 });
// { sprite: 52, color: 100, scale: 0.8 }: kolor ograniczony, skala z wartości zastępczej

BLIP_STYLE_FIELDSCopy Anchor Link

Specyfikacja danych pól stylu blipa, do { type: "object", fields: BLIP_STYLE_FIELDS } w twoim schema.ts. Panel pokazuje ją swoim widżetem blip.

Strona: Klient, serwer i NUI · Czeka: nie

const BLIP_STYLE_FIELDS: Record<string, DataSpec>
// sprite: liczba całkowita 0-1000, color: liczba całkowita 0-100, scale: liczba 0.3-2

PrzykładCopy Anchor Link

import { BLIP_STYLE_FIELDS } from "@aicore-fivem/lib/shared";

const sections = {
  blip: { type: "bool" },
  blipStyle: { type: "object", optional: true, fields: BLIP_STYLE_FIELDS },
};

NPC miejscCopy Anchor Link

PLACE_PED_SPECCopy Anchor Link

Specyfikacja danych sekcji ped miejsca: model, scenariusz bezczynności i pozycja, wszystko opcjonalne. Miejsce bez modelu nie ma NPC.

Strona: Klient, serwer i NUI · Czeka: nie

const PLACE_PED_SPEC: DataSpec
// { type: "object", optional: true, fields: { model: tekst do 64 znaków, scenario: jeden z oferowanych scenariuszy, coords: vec4 } }

Scenariusze oferowane przez panel: brak (stoi nieruchomo), WORLD_HUMAN_STAND_IMPATIENT, WORLD_HUMAN_CLIPBOARD, WORLD_HUMAN_STAND_MOBILE, WORLD_HUMAN_AA_COFFEE, WORLD_HUMAN_SMOKING, WORLD_HUMAN_GUARD_STAND, WORLD_HUMAN_COP_IDLES, WORLD_HUMAN_HANG_OUT_STREET.

PrzykładCopy Anchor Link

import { PLACE_PED_SPEC } from "@aicore-fivem/lib/shared";

const sections = { ped: PLACE_PED_SPEC, label: { type: "text", min: 1, max: 48 } };

placePedFieldsCopy Anchor Link

Pola panelu NPC miejsca: wybierak modelu peda, lista scenariuszy i narzędzie punktu z kierunkiem, które przyciąga do ziemi. Etykiety pochodzą z samego ai-core.

Strona: Klient, serwer i NUI · Czeka: nie

placePedFields(path?: string): WidgetSpec[]

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

WidgetSpec[]: trzy pola pod <path>.model, <path>.scenario i <path>.coords.

PrzykładCopy Anchor Link

import { placePedFields } from "@aicore-fivem/lib/shared";

import type { CardSpec } from "@aicore-fivem/shared";

const npcCard: CardSpec = { icon: "user", title: "ADMIN_CARD_NPC", fields: [...placePedFields()] };

readPlacePedCopy Anchor Link

Czyta NPC miejsca z danych panelu.

Strona: Klient, serwer i NUI · Czeka: nie

readPlacePed(value: unknown): PlacePed | null

ParametryCopy Anchor Link

Zwracana wartośćCopy Anchor Link

PlacePed albo null, gdy nie ma modelu (miejsce nie ma NPC). coords jest pomijane, chyba że wszystkie x, y, z i heading są liczbami; pusty scenariusz jest pomijany.

PrzykładCopy Anchor Link

import { readPlacePed, readBlipStyle, readAccess, str, type PlacePed, type BlipStyle, type AccessRule } from "@aicore-fivem/lib/shared";

export interface Shop {
  label: string;
  ped: PlacePed | null;
  blipStyle: BlipStyle;
  access: AccessRule;
}

export function readShop(id: string, v: Record<string, unknown>): Shop {
  return {
    label: str(v.label, id, 48),
    ped: readPlacePed(v.ped),
    blipStyle: readBlipStyle(v.blipStyle, { sprite: 52, color: 2, scale: 0.8 }),
    access: readAccess(v),
  };
}

Na kliencie podaj shop.ped ?? undefined jako opcję ped punktu Points: punkt spawnuje NPC i dodaje do niego swoją opcję targetu.