Uyumluluk
Banka adaptörleri
Banka uygulamasının vorp_banking, rsg-banking ya da kendi dahili bankasına nasıl bağlandığı, adaptörün nasıl seçildiği ve başka bir banka script'i için nasıl yazılacağı.
Banka uygulaması (ve ödemeler için Katalog) karakterin ana bakiyesini kendisi tutmaz. framework/frameworks.lua içindeki bir adaptöre (FXBank) sorar. Dosya açıktır: değiştirebilirsin.
#Desteklenen bankalar
| Mod | Banka script'i | Nasıl ulaşılır |
|---|---|---|
vorp |
vorp_banking 1.9 | bank_users tablosu, şube başına bir satır. vorp_banking'in server export'u yoktur, bu yüzden adaptör satırı doğrudan okur ve değiştirir. |
rsg |
rsg-banking 3.x | rsg-banking'in server export'ları: GetHomeBranch, HasAccount, GetBranchBalance, AddBranchMoney, RemoveBranchMoney. Bu export'ları olmayan eski bir rsg-banking'de oyuncunun RSG bank parasına düşer (yalnızca çevrimiçi oyuncular). |
internal |
yok | Defterin kendi fx_pocketbook_bank tablosu |
custom |
senin | Doldurduğun boş adaptör (aşağıda) |
#Mod nasıl seçilir
apps/bank/config.lua:
luaMode = 'auto', -- auto | vorp | rsg | internal | custom
'auto' şunu seçer:
- framework VORP ise ve
vorp_bankingbaşlamışsavorp, - framework RSG ise ve
rsg-bankingbaşlamışsarsg, - aksi halde
internal.
Başka her değer o adaptörü doğrudan kullanır. Adaptör kullanılamadığını söylerse Banka uygulaması nedeni gösterir ve para taşımaz.
#Ayarlar
| Anahtar | Varsayılan | Ne yapar |
|---|---|---|
Mode |
'auto' |
Yukarıya bak |
Internal.Name |
'Defter Bankasi' |
Dahili bankada gösterilen banka adı |
Vorp.Branch |
'Valentine' |
Defterin kullandığı vorp_banking şubesi (vorp_banking'in Config.banks içindeki anahtar, bank_users tablosunun name sütunu) |
Vorp.Label |
nil |
Gösterilen banka adı; boş: '<Branch> Bankasi' |
Vorp.CreateAccount |
true |
İlk yatırmada o şubede vorp_banking'in varsayılanlarıyla hesap açar. false: oyuncu bankada hesap açmalıdır. |
Rsg.Branch |
'home' |
'home' oyuncunun rsg-banking'de seçtiği ana şubedir; ya da 'valentine' gibi sabit bir şube adı |
Rsg.Labels |
şube adları | Şube başına gösterilen banka adı |
rsg-banking'de hesaplar gişede açılır. Defter hesap açmaz.
#Adaptör sözleşmesi
Her adaptör, FXBank.Adapters içinde şu fonksiyonları olan bir tablodur:
| Fonksiyon | Döndürür | Ne zaman çağrılır |
|---|---|---|
Available() |
true ya da false, reason |
Her banka işleminden önce |
Label(src, char) |
banka adı | Bankanın adını göstermek için |
HasAccount(src, char) |
true ya da false |
Oyuncunun hesabı olup olmadığını göstermek için |
OpenAccount(src, char) |
true ya da false, reason |
Yatırmadan önce |
Balance(src, char) |
sent ya da nil, reason |
Bakiyeyi göstermek için |
Credit(ctx, cents) |
true, false ya da nil |
Bu karakterin bankasına para girişi |
Debit(ctx, cents) |
true, false ya da nil |
Bankadan para çıkışı; yeterli para yoksa reddetmelidir |
TargetAccount(targetCharacterId) |
true ya da false, reason |
Havalenin alıcısını kontrol eder |
CreditCharacter(targetId, cents, ctx) |
true, false ya da nil |
Havalenin alıcısına öder; alıcı çevrimdışı olabilir |
charşudur:{ id, framework, name, job, grade }.char.id'vorp:...'ya da'rsg:...'olur.FXFramework.CharacterKey(char, 'vorp')iki noktadan sonraki kısmı döndürür.ctxşudur:{ src, char, queries }.queriesdefterin kendi hesap kaydı (ledger) sorgularıdır. SQL tabanlı bir adaptör bunları bakiye değişikliğiyle aynıMySQL.transactioniçinde çalıştırmalıdır. Export tabanlı bir adaptör bunları yok sayabilir; defter onları sonra yazar.- Tutarlar tam sayı sent'tir.
FXFramework.ToCents(dollars)çevirir.
Para fonksiyonunun sonucu şu anlama gelir:
| Sonuç | Anlamı |
|---|---|
true |
Yapıldı ve kontrol edildi |
false |
Kesinlikle yapılmadı; hiçbir şey değişmedi |
nil |
Bilinmiyor: olmuş da olabilir olmamış da. Defter işlemi bir yönetici için bekletir ve yeniden denemez. |
#Özel adaptör yazmak
apps/bank/config.lua içinde Mode = 'custom' yap ve framework/frameworks.lua içindeki custom adaptörünü doldur. Dosya bu şablonla gelir; yorumlar export tabanlı bir bankanın nerede çağrıldığını gösterir:
lualocal custom = {}
FXBank.Adapters.custom = custom
function custom.Available()
-- return GetResourceState('my_bank') == 'started'
return false, 'Ozel banka baglantisi yapilmamis.'
end
function custom.Label() return 'Banka' end
function custom.HasAccount(src, char) return false end
function custom.OpenAccount(src, char) return false, 'Ozel banka baglantisi yapilmamis.' end
function custom.Balance(src, char)
-- local dollars = exports.my_bank:GetBalance(char.id); return FXFramework.ToCents(dollars)
return nil, 'Ozel banka baglantisi yapilmamis.'
end
function custom.Credit(ctx, cents)
-- return exports.my_bank:AddMoney(ctx.char.id, cents / 100) == true
return false
end
function custom.Debit(ctx, cents)
-- return exports.my_bank:RemoveMoney(ctx.char.id, cents / 100) == true -- must refuse if not enough
return false
end
function custom.TargetAccount(targetId) return false, 'Ozel banka baglantisi yapilmamis.' end
function custom.CreditCharacter(targetId, cents, ctx) return false end
Export'ları olan bir banka script'i için doldurulmuş hâli şöyle olabilir (my_bank ve export'ları senin script'in yerine geçer):
luafunction custom.Available()
if GetResourceState('my_bank') ~= 'started' then return false, 'my_bank is not running.' end
return true
end
function custom.Label() return 'Frontier Bank' end
function custom.HasAccount(src, char) return true end
function custom.OpenAccount(src, char) return true end
function custom.Balance(src, char)
local ok, dollars = pcall(function() return exports.my_bank:GetBalance(char.id) end)
if not ok then return nil, 'Balance could not be read.' end
return FXFramework.ToCents(dollars) or 0
end
function custom.Credit(ctx, cents)
local ok, done = pcall(function() return exports.my_bank:AddMoney(ctx.char.id, cents / 100) end)
if not ok then return nil end -- failed half way: unknown
return done == true
end
function custom.Debit(ctx, cents)
local ok, done = pcall(function() return exports.my_bank:RemoveMoney(ctx.char.id, cents / 100) end)
if not ok then return nil end
return done == true
end
nil'i yalnızca paranın gerçekten taşınıp taşınmadığını bilemediğinde döndür. Hiçbir şeyin değişmediğini biliyorsan false döndür.