vRP köprüsü

ai-core vRP script’lerini yerleşik vRP köprüsüyle çalıştırır (vrp’yi provide eder). Köprünün Lua tarafı ai-core’un TypeScript tarafına bu sayfadaki export’lar üzerinden ulaşır. Bunlar o köprü için vardır: bir vRP script’i köprünün cevapladığı vRP’nin kendi API’sini kullanır (vRP.getUData, vRP.query, vRP.hasPermission...) ve bir ai-* script’inin onlara asla ihtiyacı olmaz. Panelin vRP eşlemesi (yetkiler, gruplar, eşyalar) bu export’larla değil, admin panelinde düzenlenir.

Başvuru eksiksiz olsun diye listelenmiştir. Her biri, her ai-core export’u gibi, hemen ya da bir callback ile cevap verir.

VrpGetDataCopy Anchor Link

vRP’nin anahtar-değer deposunun tek bir değerini okur (vRP’nin getUData, getCData, getSData ve getGData’sının okuduğu). Değerler hex metin olarak taşınır, böylece her bayt Lua ile TypeScript arasındaki yolculuktan sağ çıkar.

Taraf: Server · Bekler: hayır (done ile cevap verir; önbellekteki bir anahtar için hemen) · Lib: yok (yalnızca köprü)

VrpGetData(kind: string, owner: string, key: string, done: (hex: string) => void): void

exports['ai-core']:VrpGetData('u', tostring(userId), 'myscript:data', function(hex) end)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. done değeri hex olarak alır; anahtar ayarlanmamışsa ya da bir argüman yanlışsa "" alır. Yüklü hesapların ve karakterlerin verisi önbellekte kalır, bu yüzden hemen cevap verir.

ÖrnekCopy Anchor Link

Örnek yok: vRP script’leri vRP.getUData ve benzerlerini çağırır, köprü de bunları bu export’a çevirir.

VrpSetDataCopy Anchor Link

vRP’nin anahtar-değer deposuna tek bir değer saklar. Bir saniye içinde ve karakteri kaldırıldığında veritabanına (ai_core_vrp_data) yazılır.

Taraf: Server · Bekler: hayır · Lib: yok (yalnızca köprü)

VrpSetData(kind: string, owner: string, key: string, hex: string): boolean

local ok = exports['ai-core']:VrpSetData('u', tostring(userId), 'myscript:data', hex)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: değer saklandığında true. Bir argüman yanlışsa ya da hex geçerli bir hex metin değilse (konsol uyarısıyla) false.

ÖrnekCopy Anchor Link

Örnek yok: vRP script’leri vRP.setUData ve benzerlerini çağırır.

VrpQueryCopy Anchor Link

ai-core’un veritabanı havuzunda vRP’nin veritabanı API’si (hazırlanmış ifadelerin vRP.query, vRP.execute, vRP.scalar’ı). @name yer tutucuları params tablosundan doldurulur; tek metindeki birkaç ifade tek bir transaction içinde sırayla çalışır ve sonuncusu cevap verir.

Taraf: Server · Bekler: hayır (done ile cevap verir) · Lib: yok (yalnızca köprü)

VrpQuery(
  sql: string,
  params: unknown,
  mode: "query" | "execute" | "scalar",
  done: (error: string | null, ...answer: unknown[]) => void,
): void

exports['ai-core']:VrpQuery('SELECT 1 AS n', {}, 'scalar', function(err, value) end)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. done hata yerinden sonra şunları alır: query için satırlar ve etkilenen sayı; execute için etkilenen sayı; scalar için ilk satırın ilk sütunu (ya da null). Başarısızlıkta done yalnızca hata metnini alır (boş bir sql için "empty query").

ÖrnekCopy Anchor Link

Örnek yok: vRP script’leri vRP.prepare ve vRP.query çağırır. Diğer resource’lar @aicore-fivem/mysql (ai-* script’leri) ya da ai-mysql’in oxmysql API’sini kullanır.

GetVrpConfigCopy Anchor Link

Panelin vRP eşlemesi (data/vrp.json): hangi ai-core meslek, çete, rütbe ve admin’lerinin hangi vRP yetkilerine sahip olduğu, vRP grup adlarının ne anlama geldiği ve her vRP eşya id’sinin hangi envanter eşyası olduğu.

Taraf: Server · Bekler: hayır · Lib: yok (yalnızca köprü)

GetVrpConfig(): VrpConfig

local config = exports['ai-core']:GetVrpConfig()

ParametrelerCopy Anchor Link

Yok.

Dönüş değeriCopy Anchor Link

VrpConfig: defaults (yerleşik önek kuralları), permissions (kurallar), groups (vRP grup adından meslek / çete / rütbe / admin’e) ve items (vRP eşya id’sinden eşya adına). Bkz. VrpConfig. Bir panel değişikliğinden sonra ai-core aynı şekille ai-core:vrp:config server event’ini tetikler.

ÖrnekCopy Anchor Link

Örnek yok: köprü vRP.hasPermission ve vRP.hasGroup’u cevaplamak için bunu okur.

VrpPermissionAskedCopy Anchor Link

Bir vRP script’inin istediği bir yetki metnini kaydeder, böylece panel sunucunun script’lerinin kullandığı her yetkiyi listeleyebilir ve sahibi onları eşleyebilir.

Taraf: Server · Bekler: hayır · Lib: yok (yalnızca köprü)

VrpPermissionAsked(permission: string): boolean

local new = exports['ai-core']:VrpPermissionAsked('police.armory')

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

boolean: yetki yeniyse ve artık kaydedildiyse true. Zaten biliniyorsa, geçerli bir metin değilse ya da kayıtlı liste doluysa false.

ÖrnekCopy Anchor Link

Örnek yok: köprü bunu vRP.hasPermission’dan çağırır.