Server exportları

Banka

Bir karakterin banka geçmişine satır yazan ve karakterin hesap numarasını ve ek hesaplarını okuyan server export'ları.

Bu export'lar Banka uygulamasına aittir (apps/bank/server/accounts.lua). Her resource çağırabilir.

sql/install.sql içindeki ek hesap tablolarına ihtiyaç duyarlar (fx_pocketbook_bank_accounts, _bank_members, _bank_entries, _bank_requests). Bu tablolar yokken iki export da false / nil döndürür ve server konsolu açılışta bunu yazar.

Karakterin ana hesabının bakiyesi senin banka script'ine aittir (vorp_banking, rsg-banking ya da dahili banka). Bkz. Banka adaptörleri.

#BankAddTransaction

Bir karakterin banka geçmişine satır yazar: maaş, kira, ceza. Para taşımaz. Önce kendi script'inde bakiyeyi değiştir, sonra oyuncu nedenini görsün diye bunu çağır.

lua---@param characterId string 'vorp:<charidentifier>' or 'rsg:<citizenid>'
---@param cents integer above 0 = money in, below 0 = money out; not 0
---@param title string up to 60 characters
---@param counterparty? string who paid or was paid, up to 120 characters
---@param channel? string how, up to 60 characters
---@return boolean ok
exports['fx-pocketbook']:BankAddTransaction(characterId, cents, title, counterparty, channel)
luaexports['fx-pocketbook']:BankAddTransaction('vorp:12', 4500, 'Weekly wage', 'Valentine Sheriff', 'Payroll')
  • Şu durumlarda false döndürür: tablolar yoksa, characterId bozuksa ya da 96 karakterden uzunsa, cents tam sayı değilse, 0 ise ya da 1e12'yi aşıyorsa, bir yazı boşsa (yalnızca başlık) ya da fazla uzunsa.
  • Satır, karakterin ana hesap geçmişine yazılır. Çağıran resource'un adı da onunla saklanır.
  • Sahibinin Banka sayfası açıksa sayfa yenilenir.

#GetBankData

Bir karakterin hesap numarasını ve sahibi ya da üyesi olduğu ek hesapları (birikim ve ortak) döndürür.

lua---@param characterId string 'vorp:<charidentifier>' or 'rsg:<citizenid>'
---@return table|nil data
exports['fx-pocketbook']:GetBankData(characterId)
lualocal data = exports['fx-pocketbook']:GetBankData('rsg:ABC12345')
if data then
    for _, account in ipairs(data.accounts) do
        print(account.no, account.name, account.balance / 100)
    end
end
lua{
    no = '1042',            -- account number of the main account; nil if the character never opened the Bank app
    accounts = {
        { id = 7, kind = 'savings', name = 'Savings', no = '0007', balance = 125000, role = 'owner' },
        { id = 9, kind = 'shared', name = 'Ranch', no = '0009', balance = 30000, role = 'member' },
    },
}
Alan Nedir
no Ana hesabın dört haneli hesap numarası
accounts[].id Hesap id'si
accounts[].kind 'savings' (birikim) ya da 'shared' (ortak)
accounts[].name Hesap adı
accounts[].no Dört haneli hesap numarası
accounts[].balance Sent cinsinden bakiye
accounts[].role 'owner' ya da 'member'
  • Tablolar yoksa ya da characterId en fazla 96 karakterlik bir string değilse nil döndürür.
  • Kapatılmış hesaplar dahil edilmez. En fazla 30 hesap döner.
  • Ana hesabın bakiyesi dahil değildir.