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. |
idfatura id'sidir. [GetInvoice](/phone/docs/pocketbook/exports/server/bills) ile okuyabilirsin.- Parayı gecikmiş tahsilat alırsa (
Config.Billing.Collection) ve oyuncu çevrimdışıysaPaid,src = 0ile ç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).