Panel administratora i komendy

ai-core udostępnia jeden panel administratora dla każdego skryptu. Większość eksportów na tej stronie to instalacja, którą @aicore-fivem/lib wywołuje za ciebie: skrypt zbudowany z AdminPanel i addCommand z liba nigdy sam nie wywołuje RegisterAdminPanel, AdminPanelChanged ani RegisterCommands. Są opisane, abyś wiedział, co się dzieje, i mógł je obsłużyć z innego języka. RegisterExternalPanel i GetLookupValues przydają się każdemu skryptowi.

RegisterAdminPanelCopy Anchor Link

Ogłasza, że wywołujący zasób ma sekcję w panelu. ai-core pyta go wtedy o schemat i dane za każdym razem, gdy administrator otwiera panel.

Strona: Serwer · Czeka: nie · Lib: wywoływany przez AdminPanel z liba przy jego starcie

RegisterAdminPanel(resource: string): void

exports['ai-core']:RegisterAdminPanel(GetCurrentResourceName())

ParametryCopy Anchor Link

ZwracaCopy Anchor Link

Nic. Rejestracja jest usuwana, gdy zasób się zatrzymuje.

PrzykładCopy Anchor Link

Bez przykładu: wywołuje to AdminPanel z liba. Zasób, który rejestruje się bez liba, musi też odpowiadać na eksporty, które ai-core wywołuje zwrotnie (AdminPanelSnapshot, AdminPanelData, AdminPanelSummary, typowane AdminPanelResourceExports w @aicore-fivem/shared), co jest zadaniem liba.

AdminPanelChangedCopy Anchor Link

Zasób panelu mówi ai-core, że jeden z jego rekordów się zmienił. ai-core przekazuje zmianę każdemu administratorowi, który ma otwarty panel, więc jego ekran aktualizuje się bez przeładowania.

Strona: Serwer · Czeka: nie · Lib: wywoływany przez AdminPanel z liba po każdej zapisanej zmianie

AdminPanelChanged(delta: AdminDelta): void

exports['ai-core']:AdminPanelChanged({ resource = GetCurrentResourceName(), file = 'shops', key = 'shop_1', value = record })

ParametryCopy Anchor Link

Zobacz AdminDelta.

ZwracaCopy Anchor Link

Nic. ai-core nie sprawdza delty; wysyła ją tak, jak została podana.

PrzykładCopy Anchor Link

Bez przykładu: AdminPanel z liba wywołuje to po sprawdzeniu i zapisaniu zmiany.

RegisterCommandsCopy Anchor Link

Wyświetla komendy zasobu w karcie Commands panelu, z ich pomocą, parametrami i tym, kto może ich używać.

Strona: Serwer · Czeka: nie · Lib: wywoływany przez addCommand z liba (TypeScript i aiLib.addCommand w Lua)

RegisterCommands(resource: string, commands: CommandInfo[]): void

exports['ai-core']:RegisterCommands(GetCurrentResourceName(), commands)

ParametryCopy Anchor Link

Zobacz CommandInfo i CommandParam.

ZwracaCopy Anchor Link

Nic. Lista jest usuwana, gdy zasób się zatrzymuje. Dla komend ograniczonych do principala (group.admin) ai-core nadaje temu principalowi także command.<name>, co wymaga add_ace resource.ai-core command.add_ace allow (i command.remove_ace) w permission.cfg.

PrzykładCopy Anchor Link

Bez przykładu: użyj addCommand z liba (TypeScript) lub aiLib.addCommand (Lua), a komenda sama pojawi się w karcie. Komendy utworzone gołym RegisterCommand też są wyświetlane, oznaczone jako zwykłe.

GetLookupValuesCopy Anchor Link

Wartości jednej listy wyszukiwania: nazwy przedmiotów aktywnego ekwipunku, nazwy prac, nazwy gangów i tak dalej. Walidacja panelu w libie używa tego, aby sprawdzić, czy wartość wpisana przez administratora istnieje.

Strona: Serwer · Czeka: nie · Lib: używany przez walidację AdminPanel z liba

GetLookupValues(source: LookupSource): string[]

local items = exports['ai-core']:GetLookupValues('item') -- lista nazw przedmiotów

ParametryCopy Anchor Link

Zobacz LookupSource.

ZwracaCopy Anchor Link

string[]: wartości posortowane według etykiety. Pusta lista dla nieznanego source, dla vehicle i ped oraz gdy lista nie jest jeszcze znana (nie działa żaden ekwipunek): traktuj pustą listę jako "nie da się sprawdzić", nie jako "nic nie jest poprawne".

PrzykładCopy Anchor Link

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

const core = resourceExport("ai-core");

/** Checks a reward item from your config; unknown is fine while no inventory runs. */
export function isKnownItem(name: string): boolean {
  const items = core.GetLookupValues("item");
  return items.length === 0 || items.includes(name);
}

RegisterExternalPanelCopy Anchor Link

Wyświetla własny ekran ustawień innego skryptu na dashboardzie panelu ai-core, więc właściciel serwera znajduje ustawienia każdego skryptu w jednym miejscu. Karta otwiera ekran komendą czatu albo pokazuje stronę internetową wewnątrz panelu.

Strona: Serwer · Czeka: nie · Lib: brak

RegisterExternalPanel(panel: {
  id?: string;
  label: string;
  icon?: string;
  description?: string;
  command?: string;
  url?: string;
}): void

exports['ai-core']:RegisterExternalPanel({ label = 'My script', command = 'myscriptconfig' })

ParametryCopy Anchor Link

Pola paneluCopy Anchor Link

ZwracaCopy Anchor Link

Nic. Bez label albo bez obu command i url karta nie jest dodawana. Karty są usuwane, gdy twój zasób się zatrzymuje.

PrzykładCopy Anchor Link

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

const core = resourceExport("ai-core");

// Raz przy starcie.
core.RegisterExternalPanel({
  label: "My script",
  icon: "gear",
  description: "Shops, prices and rewards",
  command: "myscriptconfig",
});