Yalnızca Lua’ya özgü yardımcılar

aiLib fonksiyonlarının çoğu bir TypeScript fonksiyonunun Lua karşılığıdır ve onun yanında bir Lua sekmesiyle belgelenir (bkz. Tüm aiLib fonksiyonları). Bu sayfadakilerin Lua’da farklı bir adı, biçimi ya da davranışı vardır; bu yüzden burada belgelenirler.

Client: oyuncu verisiCopy Anchor Link

aiLib.playerData.getCopy Anchor Link

ai-core’un yerel oyuncunun verisinin bir anahtarı için gönderdiği son değer. Resource’un başladığından beri hiçbir şey gelmediyse ai-core’a bir kez sorar (GetPlayerData) ve cevabı tutar.

Taraf: Client · Bekler: hayır

local value = aiLib.playerData.get(key)

TypeScript: aynı veri getPlayerData(key) ile (bkz. Üyelik ve oyuncu verisi).

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Değer: character, money ({ cash = 500, bank = 5000 }), jobs, job, gangs ve metadata için bir tablo; duty ve activeGang için bir string ya da nil. Hiçbir karakter yüklü değilken ya da ai-core çalışmıyorken nil.

ÖrnekCopy Anchor Link

RegisterCommand('cash', function()
    local money = aiLib.playerData.get('money') or {}
    aiLib.notify(('Cash: $%s'):format(aiLib.numbers.groupDigits(money.cash or 0)), 'info')
end, false)

aiLib.playerData.onChangeCopy Anchor Link

ai-core yerel oyuncu için bir anahtarın yeni bir değerini her gönderdiğinde (bir meslek değişikliği, para, göreve başlamak) bir fonksiyon çalıştırır. money ve metadata için ai-core yalnızca değişen girdileri gönderir; aiLib onları birleştirir, böylece handler’ın her zaman tablonun tamamını alır.

Taraf: Client · Bekler: hayır

aiLib.playerData.onChange(key, function(value) end)

TypeScript: onPlayerData(key, handler) (bkz. Üyelik ve oyuncu verisi).

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. Handler’ı kaldırmanın bir yolu yoktur; resource’unla birlikte kaldırılır.

ÖrnekCopy Anchor Link

aiLib.playerData.onChange('duty', function(job)
    if job == 'police' then
        aiLib.notify('You are now on duty', 'success')
    end
end)

Server: online oyuncularCopy Anchor Link

aiLib.online yüklü oyuncuları ai-core’un export’ları üzerinden okur; okuma başına bir export çağrısı. Bir aksiyon olduğunda (bir komut, bir callback) yapılan aramalar içindir, her tick için değil. TypeScript online’ı daha fazla okuyucu ve farklı dönüş biçimleri olan yerel bir ayna tutar (bkz. Oyuncular).

aiLib.online.characterCopy Anchor Link

Bir oyuncunun yüklü karakteri.

Taraf: Server · Bekler: hayır

local character = aiLib.online.character(src)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Bir CharacterInfo tablosu (id, citizenid, firstname, lastname, birthdate, sex, nationality...) ya da oyuncunun yüklü karakteri yoksa nil.

ÖrnekCopy Anchor Link

aiLib.addCommand('whoami', { help = 'Shows your character id' }, function(source)
    local character = aiLib.online.character(source)
    if not character then return end
    aiLib.notify(source, ('Character #%d (%s)'):format(character.id, character.citizenid), 'info')
end)

aiLib.online.nameCopy Anchor Link

Karakterin "Ad Soyad"ı, yoksa oyuncunun FiveM adı.

Taraf: Server · Bekler: hayır

local name = aiLib.online.name(src, fallback)

TypeScript: online.name(source, { fallback }) bir boolean yerine bir seçenek tablosu alır.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

string: karakter adı, yoksa FiveM adı (ya da fallback = false ile veya oyuncu gittiyse "").

ÖrnekCopy Anchor Link

print(('%s opened the shop'):format(aiLib.online.name(source)))

aiLib.online.jobsCopy Anchor Link

Görevde olsun ya da olmasın bir oyuncunun her mesleği.

Taraf: Server · Bekler: hayır

local jobs = aiLib.online.jobs(src)

TypeScript: online.jobs(source) yalnızca meslek adlarını döndürür; Lua üyelik tablolarını döndürür.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

JobMembership tablolarından bir liste ({ job = 'police', grade = 2 }). Oyuncunun mesleği ya da karakteri yoksa boş bir liste.

ÖrnekCopy Anchor Link

for _, membership in ipairs(aiLib.online.jobs(source)) do
    print(membership.job, membership.grade)
end

aiLib.online.gangsCopy Anchor Link

Bir oyuncunun her çetesi.

Taraf: Server · Bekler: hayır

local gangs = aiLib.online.gangs(src)

TypeScript: online.gangs(source) yalnızca çete adlarını döndürür.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

GangMembership tablolarından bir liste ({ gang = 'ballas', grade = 0 }) ya da boş bir liste.

ÖrnekCopy Anchor Link

local inAGang = #aiLib.online.gangs(source) > 0

aiLib.online.jobGradeCopy Anchor Link

Bir oyuncunun bir meslekteki rütbesi.

Taraf: Server · Bekler: hayır

local grade = aiLib.online.jobGrade(src, job)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

integer (0 = en düşük rütbe) ya da oyuncu o meslekte değilse nil.

ÖrnekCopy Anchor Link

local grade = aiLib.online.jobGrade(source, 'police')
if not grade or grade < 2 then return aiLib.fail('NOT_ALLOWED') end

aiLib.online.gangGradeCopy Anchor Link

Bir oyuncunun bir çetedeki rütbesi.

Taraf: Server · Bekler: hayır

local grade = aiLib.online.gangGrade(src, gang)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

integer ya da oyuncu o çetede değilse nil.

ÖrnekCopy Anchor Link

local isBoss = (aiLib.online.gangGrade(source, 'ballas') or -1) >= 3

aiLib.online.dutyJobCopy Anchor Link

Bir oyuncunun görevde olduğu meslek.

Taraf: Server · Bekler: hayır

local job = aiLib.online.dutyJob(src)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Meslek adı ya da görevde değilse nil.

ÖrnekCopy Anchor Link

if aiLib.online.dutyJob(source) ~= 'police' then return aiLib.fail('NOT_ON_DUTY') end

aiLib.online.sourcesCopy Anchor Link

Yüklü karakteri olan her oyuncunun server id’si.

Taraf: Server · Bekler: hayır

local players = aiLib.online.sources()

Dönüş değeriCopy Anchor Link

Bir server id listesi (kimse yüklü değilse ya da ai-core çalışmıyorsa boş).

ÖrnekCopy Anchor Link

for _, src in ipairs(aiLib.online.sources()) do
    if aiLib.online.dutyJob(src) == 'police' then
        aiLib.notify(src, 'Robbery in progress', 'warning')
    end
end

Server: yetkilerCopy Anchor Link

aiLib.isAdminCopy Anchor Link

Bir oyuncunun ai-core admin’i (ACE ai.admin) olup olmadığı ya da belirttiğin ACE’ye sahip olup olmadığı.

Taraf: Server · Bekler: hayır

local allowed = aiLib.isAdmin(src, ace)

TypeScript: isAdmin(ace?) bunun yerine onClientCallback / onClientEvent için bir korumadır (bkz. Client girdisi). Lua’da bir callback’i ace seçeneğiyle kısıtla ya da aiLib.isAdmin’i kendin çağır.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Oyuncunun ACE’si varsa true, yoksa false.

ÖrnekCopy Anchor Link

RegisterCommand('fixall', function(source)
    if not aiLib.isAdmin(source) then return end
    -- yalnızca admin’e özel iş burada
end, false)

Client: menü tablosuCopy Anchor Link

aiLib.menuCopy Anchor Link

Pencereler tek bir tabloda durur. Üst seviyedeki adlar, kısa çağrılar için tutulan aynı fonksiyonlardır:

İstek biçimleri MenuRequest, InputRequest, ItemPickerRequest ve SkillDifficulty’dir. Her seçenek ve dinleyici, TypeScript karşılıklarıyla birlikte Ortak arayüz sayfasında belgelenir.

RegisterCommand('fine', function()
    local values = aiLib.input({
        title = 'Write a fine',
        confirm = 'Send',
        fields = {
            { name = 'amount', label = 'Amount', type = 'number', min = 1, max = 10000 },
            { name = 'reason', label = 'Reason', type = 'text', maxLength = 80 },
        },
    })
    if values then aiLib.callAction('mypolice:fine', { values.amount, values.reason }, { fallback = 'FINE_FAILED' }) end
end, false)