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:

  1. framework VORP ise ve vorp_banking başlamışsa vorp,
  2. framework RSG ise ve rsg-banking başlamışsa rsg,
  3. 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 }. queries defterin kendi hesap kaydı (ledger) sorgularıdır. SQL tabanlı bir adaptör bunları bakiye değişikliğiyle aynı MySQL.transaction iç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.