Admin paneli ve komutlar

ai-core her script için tek bir admin paneli barındırır. Bu sayfadaki export’ların çoğu @aicore-fivem/lib’in senin yerine çağırdığı altyapıdır: lib’in AdminPanel’i ve addCommand’ı ile yapılmış bir script RegisterAdminPanel, AdminPanelChanged ya da RegisterCommands’ı asla kendisi çağırmaz. Ne olduğunu bilmen ve başka bir dilden destekleyebilmen için belgelenmiştir. RegisterExternalPanel ve GetLookupValues her script için işe yarar.

RegisterAdminPanelCopy Anchor Link

Çağıran resource’un bir panel bölümü olduğunu bildirir. Bundan sonra ai-core, bir admin paneli her açtığında ondan şemasını ve verisini ister.

Taraf: Server · Bekler: hayır · Lib: lib’in AdminPanel’i başlarken çağırır

RegisterAdminPanel(resource: string): void

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

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. Resource durduğunda kayıt silinir.

ÖrnekCopy Anchor Link

Örnek yok: lib’in AdminPanel’i bunu çağırır. Lib olmadan kayıt yapan bir resource, ai-core’un geri çağırdığı export’ları da cevaplamalıdır (AdminPanelSnapshot, AdminPanelData, AdminPanelSummary, @aicore-fivem/shared içinde AdminPanelResourceExports olarak tiplenmiş); bu lib’in işidir.

AdminPanelChangedCopy Anchor Link

Bir panel resource’u ai-core’a kayıtlarından birinin değiştiğini söyler. ai-core değişikliği paneli açık olan her admin’e iletir, böylece ekranları yeniden yüklemeden güncellenir.

Taraf: Server · Bekler: hayır · Lib: lib’in AdminPanel’i kaydedilen her değişiklikten sonra çağırır

AdminPanelChanged(delta: AdminDelta): void

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

ParametrelerCopy Anchor Link

Bkz. AdminDelta.

Dönüş değeriCopy Anchor Link

Hiçbir şey. ai-core delta’yı kontrol etmez; verildiği gibi gönderir.

ÖrnekCopy Anchor Link

Örnek yok: lib’in AdminPanel’i bunu bir değişiklik doğrulanıp kaydedildikten sonra çağırır.

RegisterCommandsCopy Anchor Link

Bir resource’un komutlarını panelin Commands sekmesinde, yardım metinleri, parametreleri ve kimlerin kullanabileceğiyle listeler.

Taraf: Server · Bekler: hayır · Lib: lib’in addCommand’ı çağırır (TypeScript ve Lua aiLib.addCommand)

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

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

ParametrelerCopy Anchor Link

Bkz. CommandInfo ve CommandParam.

Dönüş değeriCopy Anchor Link

Hiçbir şey. Resource durduğunda liste silinir. Bir principal’a (group.admin) kısıtlı komutlar için ai-core o principal’a command.<name> da verir; bunun için permission.cfg içinde add_ace resource.ai-core command.add_ace allow (ve command.remove_ace) gerekir.

ÖrnekCopy Anchor Link

Örnek yok: lib’in addCommand’ını (TypeScript) ya da aiLib.addCommand’ı (Lua) kullan, komut sekmede kendiliğinden görünür. Çıplak RegisterCommand ile yapılmış komutlar da listelenir, düz olarak işaretlenir.

GetLookupValuesCopy Anchor Link

Tek bir lookup listesinin değerleri: aktif envanterin eşya adları, meslek adları, çete adları vb. Lib’in panel doğrulaması bir admin’in yazdığı değerin var olup olmadığını kontrol etmek için bunu kullanır.

Taraf: Server · Bekler: hayır · Lib: lib’in AdminPanel doğrulaması kullanır

GetLookupValues(source: LookupSource): string[]

local items = exports['ai-core']:GetLookupValues('item') -- eşya adları listesi

ParametrelerCopy Anchor Link

Bkz. LookupSource.

Dönüş değeriCopy Anchor Link

string[]: değerler, etiketlerine göre sıralı. Bilinmeyen bir source için, vehicle ve ped için ve liste henüz bilinmiyorken (envanter çalışmıyor) boş liste: boşu "hiçbir şey geçerli değil" olarak değil, "kontrol edilemiyor" olarak ele al.

ÖrnekCopy Anchor Link

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

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

/** Config’indeki bir ödül eşyasını kontrol eder; envanter çalışmıyorken bilinmemesi sorun değil. */
export function isKnownItem(name: string): boolean {
  const items = core.GetLookupValues("item");
  return items.length === 0 || items.includes(name);
}

RegisterExternalPanelCopy Anchor Link

Başka bir script’in kendi ayar ekranını ai-core’un panel gösterge paneline ekler, böylece sunucu sahibi her script’in ayarlarını tek yerde bulur. Kart ekranı bir sohbet komutuyla açar ya da panelin içinde bir web sayfası gösterir.

Taraf: Server · Bekler: hayır · Lib: yok

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

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

ParametrelerCopy Anchor Link

Panel alanlarıCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. label olmadan ya da hem command hem url olmadan kart eklenmez. Resource’un durduğunda kartlar silinir.

ÖrnekCopy Anchor Link

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

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

// Açılışta bir kez.
core.RegisterExternalPanel({
  label: "My script",
  icon: "gear",
  description: "Shops, prices and rewards",
  command: "myscriptconfig",
});