AI Core
API başvurusuAI Core: server export’ları

Server export’ları

ai-core’un server export’larını Lua ve TypeScript’ten nasıl çağıracağın ve her export grubunun listesi.

ai-core framework resource’udur. Diğer resource’lar ondan bir oyuncunun karakterini, parasını, mesleklerini ve eşyalarını ister ve ona "bu oyuncuya bir anahtar ver" ya da "bir polis ihbarı gönder" gibi işler gönderir. Bunu export’lar üzerinden yaparlar: ai-core’un sunucudaki başka herhangi bir resource’tan çağrılabilir yaptığı fonksiyonlar.

Bu sayfalar ai-core’un kaydettiği her server export’unu konuya göre gruplanmış olarak listeler. Her kayıt export’un ne yaptığını, tam imzasını, her parametresini, her durumda ne döndürdüğünü ve TypeScript ile Lua’da çalışan bir örneği gösterir.

Export çağırmak

Bir export, sahibi olan resource’un adı (ai-core) ve export’un adıyla çağrılır.

import { resourceExport } from "@aicore8/lib/server";

// Dosya başına bir tipli tutamaç, en üstte. Burada güvenlidir: FiveM her export’u
// ilk kullanımda arar ve ai-core yeniden başladığında unutur.
const core = resourceExport("ai-core");

export function cashOf(source: number): number {
  return core.GetMoney(source, "cash") ?? 0;
}

Başlamadan önce bilmen gerekenler:

  • TypeScript tipleri. resourceExport("ai-core"), @aicore8/shared içindeki AiCoreServerExports’tan tiplenir, böylece editörün her adı, parametreyi ve dönüş tipini bilir. Bir fonksiyonun içinde asla resourceExport("ai-core").GetMoney(...) yazma: tek tutamacı dosyanın en üstünde tut.
  • Lua iki nokta üst üste kullanır. Nokta değil, exports['ai-core']:GetMoney(source, 'cash') yaz. null cevabı Lua’ya nil olarak, dizi bir Lua listesi olarak (ilk indeks 1), nesne bir tablo olarak gelir.
  • İki yazım. Her export ilk harfinin büyük/küçük hali değiştirilmiş adıyla da cevap verir: GetMoney ve getMoney aynı fonksiyondur.
  • Export’lar asla beklemez. Her export küçük bir değerle hemen cevap verir. Cevap veritabanına ihtiyaç duyduğunda (kayıtlı bir görünüm, bir fatura listesi) export bir Promise döndürmek yerine bir done callback’i alır, çünkü bir Promise bir resource’tan diğerine geçemez.
  • Sık çalışan yollarda değil. Bir export çağrısı argümanlarını ve cevabını kopyalar. Export’ları her karede ya da bir döngüde her oyuncu için çağırma. "Kim mesaide", bir karakterin adı ya da birçok oyuncunun meslekleri için ai-core’un event’lerini izleyen lib’in online aynasını kullan (Lib: server).
  • ai-core önce çalışmalı. fxmanifest.lua dosyana dependency 'ai-core' koy (bir ai-* resource’u onu package.json fxDependencies içinde listeler), böylece resource’un ai-core’dan sonra başlar.
  • source oyuncunun server id’sidir. FiveM’in bağlı bir oyuncuya verdiği numaradır. Karakter id’si (charId) farklı bir numaradır: veritabanındaki karakter satırının id’si.

Lib mi, export mu?

Çoğu export’un @aicore8/lib/server içinde bir sarmalayıcısı vardır (birçoğunun da Lua’nın aiLib’inde). Sarmalayıcı aynı export’u çağırır, bu yüzden davranış aynıdır; yalnızca daha güzel okunur (core.AddItem(source, "water") yerine inventory.addItem(source, "water")) ve güvenli olduğu yerlerde callback’leri Promise’e çevirir. Her kayıt sarmalayıcısını Lib satırında adlandırır. Hangisini istersen kullan; ai-lib’siz bir Lua resource’u export’u doğrudan çağırır.

Bu sayfalardaki örnekler

Örnekler eksiksiz server dosyalarıdır. TypeScript örnekleri lib’in addCommand ve onClientCallback’ini kullanır; Lua örnekleri ai-lib’in aiLib.addCommand ve aiLib.onClientCallback’ini kullanır, bunlar için fxmanifest.lua dosyanda şu satırlar gerekir:

fxmanifest.lua
shared_script '@ai-lib/init.lua'
dependency 'ai-lib'
dependency 'ai-core'

Bekleyen Lua çağrıları (aiLib.progressFor, Wait) yalnızca bir thread içinde çalışır; komut ve callback handler’ları zaten bir thread içinde çalışır.

Tipler

Birkaç sayfada görünen tipler (CharacterInfo, InventoryRef, DispatchAlert...) her alanıyla Tipler sayfasında bir kez belgelenir ve onları kullanan her kayıttan bağlantı verilir.

Export grupları

Karakterler ve oyuncular

Oyuncu verisi, karakterler, server id aramaları, karakter değiştirme, çevrimdışı konumlar, kapsamdaki oyuncular.

Kayıtlı karakterler

Yüklü olsun olmasın her karakter: bul, oku, parası, meslekleri, çeteleri, metadata, ad, oynama süresi, kaydet, sil.

Para ve hesaplar

Bakiyeler, para ekleme ve çıkarma, meslek ve çete hesapları, transferler, hesap tipleri.

Meslekler ve çeteler

Üyelikler, mesai, rütbeler, mesaideki sayıları, prime time, meslek ve çete tanımları.

Metadata ve ayarlar

Bir karakterin metadata çantası, sunucunun markası, güncel olmayan script’ler.

Eşyalar

Eşya ekleme, çıkarma, sayma ve kontrol etme, stash’ler, script dükkanları, kullanılabilir eşyalar, eşya tanımları.

Araç anahtarları

Hangi anahtar script’i çalışıyorsa onun üzerinden araç anahtarı ver, al ve kontrol et.

Yakıt

Hangi yakıt script’i çalışıyorsa onun üzerinden bir aracın yakıtını oku ve ayarla.

Kapı kilitleri

Hangi kapı kilidi script’i çalışıyorsa onun üzerinden kapıları kilitle, aç ve oku.

Garajlar

Araç çekme, park etme, garaj menüsü açma, bir oyuncunun garajdaki araçlarını listeleme.

Sağlık

Canlandır, iyileştir ve bir oyuncunun yerde olup olmadığını kontrol et.

EMS

Kaç sağlıkçının boş olduğu, yardım çağrıları.

Görünüm

Hangi kıyafet script’i çalışıyorsa ondan bir karakterin kayıtlı görünümü.

Telefon

Telefon numaraları, mailler, mesajlar ve telefon bildirimleri.

İhbar

Hangi ihbar sistemi çalışıyorsa onun üzerinden polis ve meslek ihbarları.

MDT

Polis MDT’sindeki cezalar, arama kararları, tutuklamalar ve hapis kayıtları.

Hapishane

Hapse atma, serbest bırakma ve kalan süre.

Banka

Banka ekranı açma, bir mesleğin şirket bakiyesi.

Faturalar

Fatura gönderme, bir oyuncunun açık faturalarını listeleme ve ödeme.

Stres ve ihtiyaçlar

Stres ekleme ya da azaltma, açlık ve susuzluğu doldurma.

Saat ve hava

Hava, oyun saati, karartma ve dondurulmuş zaman.

Routing bucket’lar

Ayrı bir dünya için boş bir routing bucket alma ve geri verme.

Loglar

Discord’a, Fivemanage’e, FiveM Stats’e ve konsola log gönderme.

Bağlantı kontrolleri

Bağlanan her oyuncunun geçtiği kontroller, başkalarının yerine geçen script’ler.

Admin paneli ve komutlar

Panel kaydı, Commands sekmesi, lookup listeleri, harici ayar ekranları.

vRP köprüsü

ai-core’un yerleşik vRP köprüsünün kullandığı export’lar.

İlgili sayfalar

  • Client export’ları: ai-core’un oyuncunun kendi oyununda cevapladıkları.
  • Event’ler ve durum: ai-core’un tetiklediği event’ler (ai-core:playerLoaded, ai-core:moneyChanged...); resource’unun tekrar sormak yerine değişiklikleri izlemesini sağlar.
  • Lib: server: her kayıtta adı geçen sarmalayıcılar.

Bu sayfada