API başvurusu
API’ye genel bakış
Başka bir script’ten AI Core nasıl çağrılır - export’lar, event’ler ve lib, TypeScript ve Lua ile.
Başka bir script’in çağırabileceği her şey: ai-core’un export’ları, tetiklediği event’ler ve @aicore8/lib yardımcıları (her ai-* script’inin kendi export’ları Script’ler altındaki kendi sayfasındadır). Bu sayfalardaki her imza kaynaktan alındı (@aicore8/shared exports.ts, lib’in JSDoc’u, her script’in export çağrıları).
Doğru kapıyı seç
| Yazdığın | Kullan |
|---|---|
| Bir ai-* script’i ya da herhangi bir TypeScript resource’u | @aicore8/lib: inventory, vehicleKeys, online, medical... Lib senin yerine ai-core’u çağırır. |
| Bir Lua resource’u | ai-lib’den aiLib (shared_script '@ai-lib/init.lua') ya da doğrudan ai-core’un export’ları. |
| Bir ESX / QB / Qbox / vRP script’i | Yeni bir şey yok: köprü framework’ün kendi API’sini cevaplar. Bkz. Katmanlar ve köprü. |
Eşyalar, araç anahtarları, ihbarlar, telefon, hava, hapis, kıyafet ve ölümler her zaman ai-core üzerinden gider, hiçbir zaman belirli bir script’in export’larıyla değil: ai-core, sunucunun o iş için çalıştırdığı script’e iletir.
Export çağırmak
import { resourceExport } from "@aicore8/lib/server";
// Her resource için bir tipli tutamaç, dosyanın en üstünde.
const core = resourceExport("ai-core");
const cash = core.GetMoney(source, "cash");local cash = exports['ai-core']:GetMoney(source, 'cash')- Tipler:
resourceExportonları@aicore8/sharediçindekiCitizenExports’tan okur. Çalışmıyor olabilecek bir resource içinoptionalExport("x")kullanılır (durmuşken null). - İsimler: her export ilk harfinin büyük/küçük hali değiştirilmiş adıyla da cevap verir (
GetMoneyvegetMoney). - Export’lar senkrondur ve küçük değerler döndürür. Zaman isteyen bir değerde (kayıtlı bir görünüm) export bir callback alır: resource sınırından hiçbir promise geçmez.
- Sık çalışan kod döngüde export çağırmak yerine ai-core’un event’lerini izler (lib’in
onlineaynası bunu yapar).
Sayfalar
| Sayfa | Orada ne bulursun |
|---|---|
| ai-core server export’ları | ai-core’un her server export’u, alan başına bir sayfa: karakterler, para, meslekler ve çeteler, eşyalar, anahtarlar, sağlık, telefon, ihbar, hapis, dünya, banka, faturalar, loglar, admin paneli. |
| ai-core client export’ları | Her client export’u: oyuncu verisi, HUD, tuş ipuçları, dünya senkronu, eşyalar, radyal menü, hareketler, görünüm, emniyet kemeri. |
| Event’ler ve durum | ai-core’un tetiklediği her event ve argümanları, state bag’ler ve köprünün tetiklediği ESX / QB / Qbox / vRP event’leri. |
| Lib: server | @aicore8/lib/server ve aiLib’in server tarafı. |
| Lib: client | @aicore8/lib/client ve aiLib’in client tarafı. |
| Lib: shared ve fivem | @aicore8/lib/shared ve /fivem: export’lar, zamanlama, state bag’ler, girdi okuyucular, metin ve sayılar. |
| Lua için lib | Bir Lua resource’unun aiLib’i nasıl kullandığı ve yalnızca Lua’da olan fonksiyonlar. |
| Tipler | İmzaların kullandığı her ortak tip (Vec3, ActionResult, InventoryRef...), alan alan. |
| Script sayfaları | Her ai-* script’inin kendi export’ları ve event’leri onun Developer sayfasındadır (örneğin ai-inventory, cevapladığı ox_inventory ve qb-inventory API’leri dahil). |