Panel de administración y comandos

ai-core aloja un único panel de administración para todos los scripts. La mayoría de los exports de esta página son fontanería que @aicore-fivem/lib llama por ti: un script construido con AdminPanel y addCommand de la lib nunca llama por sí mismo a RegisterAdminPanel, AdminPanelChanged ni RegisterCommands. Se documentan para que sepas qué ocurre y puedas darles soporte desde otro lenguaje. RegisterExternalPanel y GetLookupValues son útiles para cualquier script.

RegisterAdminPanelCopy Anchor Link

Anuncia que el recurso que llama tiene una sección en el panel. Entonces ai-core le pide su esquema y sus datos cada vez que un admin abre el panel.

Lado: Servidor · Espera: no · Lib: lo llama el AdminPanel de la lib cuando se inicia

RegisterAdminPanel(resource: string): void

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

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

Nada. El registro se elimina cuando el recurso se detiene.

EjemploCopy Anchor Link

Sin ejemplo: lo llama el AdminPanel de la lib. Un recurso que se registre sin la lib también debe responder a los exports a los que ai-core llama de vuelta (AdminPanelSnapshot, AdminPanelData, AdminPanelSummary, tipados como AdminPanelResourceExports en @aicore-fivem/shared), que es trabajo de la lib.

AdminPanelChangedCopy Anchor Link

Un recurso de panel avisa a ai-core de que cambió uno de sus registros. ai-core reenvía el cambio a cada admin que tiene el panel abierto, para que su pantalla se actualice sin recargar.

Lado: Servidor · Espera: no · Lib: lo llama el AdminPanel de la lib tras cada cambio guardado

AdminPanelChanged(delta: AdminDelta): void

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

ParámetrosCopy Anchor Link

Consulta AdminDelta.

DevuelveCopy Anchor Link

Nada. ai-core no comprueba el delta; lo envía tal cual.

EjemploCopy Anchor Link

Sin ejemplo: lo llama el AdminPanel de la lib después de validar y guardar un cambio.

RegisterCommandsCopy Anchor Link

Lista los comandos de un recurso en la pestaña Commands (comandos) del panel, con su ayuda, sus parámetros y quién puede usarlos.

Lado: Servidor · Espera: no · Lib: lo llama el addCommand de la lib (TypeScript y aiLib.addCommand en Lua)

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

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

ParámetrosCopy Anchor Link

Consulta CommandInfo y CommandParam.

DevuelveCopy Anchor Link

Nada. La lista se elimina cuando el recurso se detiene. Para comandos restringidos a un principal (group.admin), ai-core también concede a ese principal command.<name>, lo que necesita add_ace resource.ai-core command.add_ace allow (y command.remove_ace) en permission.cfg.

EjemploCopy Anchor Link

Sin ejemplo: usa addCommand de la lib (TypeScript) o aiLib.addCommand (Lua) y el comando aparece solo en la pestaña. Los comandos creados con un RegisterCommand a secas también se listan, marcados como simples.

GetLookupValuesCopy Anchor Link

Los valores de una lista de valores: los nombres de objetos del inventario activo, los nombres de trabajos, de bandas, etc. La validación del panel de la lib lo usa para comprobar que existe un valor que ha escrito un admin.

Lado: Servidor · Espera: no · Lib: lo usa la validación del AdminPanel de la lib

GetLookupValues(source: LookupSource): string[]

local items = exports['ai-core']:GetLookupValues('item') -- lista de nombres de objetos

ParámetrosCopy Anchor Link

Consulta LookupSource.

DevuelveCopy Anchor Link

string[]: los valores, ordenados por su etiqueta. Una lista vacía para un source desconocido, para vehicle y ped, y cuando la lista aún no se conoce (no hay ningún inventario en marcha): trata la lista vacía como "no se puede comprobar", no como "nada es válido".

EjemploCopy 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

Lista la pantalla de ajustes propia de otro script en el dashboard del panel de ai-core, para que el dueño del servidor encuentre los ajustes de todos los scripts en un solo sitio. La tarjeta abre la pantalla con un comando de chat, o muestra una página web dentro del panel.

Lado: Servidor · Espera: no · Lib: ninguna

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

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

ParámetrosCopy Anchor Link

Campos del panelCopy Anchor Link

DevuelveCopy Anchor Link

Nada. Sin un label, o sin command ni url, la tarjeta no se añade. Las tarjetas se eliminan cuando tu recurso se detiene.

EjemploCopy Anchor Link

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

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

// Una vez al iniciar.
core.RegisterExternalPanel({
  label: "My script",
  icon: "gear",
  description: "Shops, prices and rewards",
  command: "myscriptconfig",
});