API başvurusu
ai-core client export’ları
ai-core’un her client export’u - oyuncu verisi, HUD, tuş ipuçları, dünya senkronu, eşyalar, radyal, jestler, görünümler ve diyaloglar.
@aicore-fivem/shared (exports.ts) içinde AiCoreClientExports olarak tiplidir.
import { resourceExport } from "@aicore-fivem/lib/client";
const core = resourceExport("ai-core");Çoğunun kullanımı daha kolay bir lib yardımcısı var (son sütunda); Lua resource’larda aynı yardımcılar aiLib üzerinde.
Oyuncu
| Export | Ne | Lib |
|---|---|---|
GetPlayerData(): AiPlayerData | null | Yerel oyuncunun verisi: karakter, para, meslekler, mesai, meslek, çeteler, aktif çete, metadata. | getPlayerData, onPlayerData |
IsPlayerLoaded(): boolean | Bir karakter yüklü mü. | |
IsDead(): boolean | Yerel oyuncu, hangi ölüm script’i çalışıyorsa onda yerde. | medical.isDead |
GetDefinitions(file: "jobs" | "gangs"): Record<string, unknown> | null | Panel dosyasındaki haliyle meslek ya da çete tanımları. |
local data = exports['ai-core']:GetPlayerData()
if data and data.duty == 'police' then
-- on duty
endHUD
| Export | Ne | Lib |
|---|---|---|
HideHud(reason: string): void | Herhangi bir sebep sürdükçe bütün HUD’ları gizler (duran bir resource’un sebepleri onunla gider). | hud.hide |
ShowHud(reason: string): void | Bir sebebi kaldırır. | hud.show |
IsHudVisible(): boolean | HUD’lar şu an görünüyor mu. | hud.visible |
OpenHudSettings(): boolean | Çalışan HUD’un kendi ayarlarını açar; yoksa false. | |
HasHudSettings(): boolean | Çalışan HUD’un ayarları var mı. |
core.HideHud("photo-mode");
// ...
core.ShowHud("photo-mode");exports['ai-core']:HideHud('photo-mode')
exports['ai-core']:ShowHud('photo-mode')Tuşlar ve tuş ipuçları
| Export | Ne | Lib |
|---|---|---|
GetKeybindKey(name: string): string | null | Bir lib Keybind’ının kaydedildiği tuş; kaydedilene kadar null. | Keybind.currentKey |
ShowKeyHint(id: string, hint: KeyHintRequest): void | Gizlenene kadar bir tuş ipucu gösterir (label, keybind?, key?, icon?). | keyHints.show |
HideKeyHint(id: string): void | Gizler. | keyHints.hide |
GetKeyHints(): KeyHintView[] | HUD’ların şu an gösterdiği ipuçları (id, key, label, icon?). | |
OpenKeyboard(): void | Tuşlar ekranını açar: eylemi olan her tuş. |
exports['ai-core']:ShowKeyHint('noclip_speed', { label = 'Speed', key = 'SHIFT', icon = 'gauge' })Hava ve saat senkronu
| Export | Ne | Lib |
|---|---|---|
PauseWorldSync(reason: string): void | Herhangi bir sebep sürdükçe hava ve saat senkronunu duraklatır (iç mekânlar, sahneler). | world.pauseSync |
ResumeWorldSync(reason: string): void | Bir sebebi kaldırır. | world.resumeSync |
IsWorldSyncPaused(): boolean | Senkron şu an duraklatılmış mı. |
Eşyalar
| Export | Ne | Lib |
|---|---|---|
OpenInventory(): void | Oyuncunun kendi envanter ekranını açar. | inventory.openInventory |
HasItem(item: string, count?: number): boolean | Oyuncuda eşya var mı. | inventory.hasItem |
GetCurrentWeapon(): HeldWeapon | null | Eldeki silah eşyası (name, label, image?). | inventory.currentWeapon |
OpenItemPicker(requestId: number, request: ItemPickerRequest): void | Admin araçları: aranabilir eşya ızgarası; sonuç MENU_EVENTS.menuResult olarak gelir. | itemPicker |
Radyal menü
Öğeler hangi radyal menü çalışıyorsa ona ulaşır; ekleyen resource durunca ai-core onları kaldırır.
| Export | Ne | Lib |
|---|---|---|
AddRadialItem(item: RadialItem): void | Bir öğe ekler ya da değiştirir (id, label, icon?, parent?, items?, canShow?, onPressed?, keepOpen?, whileDead?). | radial.add |
RemoveRadialItem(id: string): void | Bir öğeyi kaldırır. | radial.remove |
RefreshRadial(): void | Açık bir çarkın her canShow’unu yeniden okur. | radial.refresh |
exports['ai-core']:AddRadialItem({
id = 'myscript_engine', label = 'Engine', icon = 'power-off', parent = 'vehicle',
canShow = function() return IsPedInAnyVehicle(PlayerPedId(), false) end,
onPressed = function() ExecuteCommand('engine') end,
})Jestler
| Export | Ne | Lib |
|---|---|---|
GetGestureProvider(): string | null | Eller yukarı ve işaret etmeyi cevaplayan emote script’i. | gestures.provider |
IsHandsUp(): boolean | Yerel oyuncunun elleri yukarıda. | gestures.isHandsUp |
IsPointing(): boolean | Yerel oyuncu işaret ediyor. | gestures.isPointing |
Görünüm
| Export | Ne | Lib |
|---|---|---|
ApplyAppearance(ped: number, look: CharacterAppearance): boolean | GetCharacterAppearance’tan gelen görünümü, aktif kıyafet script’iyle aynı modeldeki bir ped’e giydirir. | appearance.apply |
GetPedAppearance(ped: number): CharacterAppearance | null | Bir ped’in şu an giydiği görünüm. | appearance.read |
Menüler, giriş diyalogları, bildirimler, istemler, ilerleme çubuğu ve mini oyunlar ai-core’un değil ai-lib’in: bkz. Script export’ları.