Event ve state

Server kancaları

fx-pocketbook'un server'da çağırdığı, config dosyalarındaki fonksiyonlar; böylece bir fatura değiştiğinde, kimlik kartı oluştuğunda ya da takvim ödemeleri listelediğinde kendi kodun çalışır.

FX Pocketbook'ta diğer resource'lar için server event'i yoktur. Kendi kodunun çalışmasına izin verdiği yerlerde, bir config dosyasına yazdığın fonksiyonu çağırır. Fonksiyonlar server'da çalışır. İçlerindeki bir hata yakalanır ve defteri bozmaz.

#Fatura kancaları

apps/billing/config.lua > Config.Billing.Hooks:

luaHooks = {
    Sent = function(src, id) end,
    Paid = function(src, id, amount) end,
    Cancelled = function(src, id) end,
}
Kanca Argümanlar Ne zaman
Sent src, id Uygulamada ya da CreateInvoice ile bir fatura kesildi. src faturayı kesen oyuncudur.
Paid src, id, amount Bir ödeme kaydedildi. amount dolar cinsindendir. Kısmi ödemede (taksit) de çalışır.
Cancelled src, id Bir fatura, kesen tarafından iptal edildi.
  • id fatura id'sidir. [GetInvoice](/phone/docs/pocketbook/exports/server/bills) ile okuyabilirsin.
  • Parayı gecikmiş tahsilat alırsa (Config.Billing.Collection) ve oyuncu çevrimdışıysa Paid, src = 0 ile çalışır.
  • Aynı nonce ile tekrarlanan bir istek kancayı iki kez çalıştırmaz.
luaPaid = function(src, id, amount)
    TriggerEvent('my-saloon:billPaid', id, amount)
end,

apps/billing/config.lua paylaşılan bir dosyadır: client da onu yükler. Yalnızca server'da çalışacak kodu fonksiyonun içinde tut.

#Kartlarim kimlik kartı

apps/kartlarim/config_server.lua > PocketServerConfig.Apps.kartlarim.Identity. Kartlarim otomatik kimlik kartını (Config.Kartlarim.AutoIdentity) oluştururken çalışır ve kart için ek satırlar döndürür.

lua---@param src integer
---@param char table { id, name, job, grade, framework }
---@return table { birth?, class?, terms? }
Identity = function(src, char)
    return { birth = '12 May 1870', class = 'Citizen' }
end,
Alan Nedir
birth Doğum tarihi yazısı, en fazla 40 karakter, koşullar yazısının başına eklenir
class Adın altındaki satır
terms Koşullar yazısı

Gelen dosya doğum tarihini RSG'de charinfo.birthdate değerinden, VORP'ta yaştan okur.

#Takvim ödeme günleri

apps/takvim/config_server.lua > PocketServerConfig.Apps.takvim.PaymentDays. Oyuncunun ödemesi gereken şeyleri (fatura, vergi, kira) takvimde salt okunur olarak listeler. Takvim hiçbir ödeme yapmaz.

lua---@param src integer
---@param char table { id, name, job, grade, framework }
---@return table list up to 20 rows { title, place?, note?, at }
PaymentDays = function(src, char)
    local rows = MySQL.query.await("SELECT description,sender_label,UNIX_TIMESTAMP(due_at) AS due FROM fx_pocketbook_invoices WHERE recipient_account=? AND state='open' ORDER BY due_at LIMIT 20", { 'person:' .. char.id })
    local list = {}
    for _, row in ipairs(rows or {}) do list[#list + 1] = { title = row.description, place = row.sender_label, at = row.due } end
    return list
end,

at bir unix zamanıdır. Fonksiyon hata verirse liste boş sayılır. Varsayılan değer nil'dir (liste yok).