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
falsedöndürür: tablolar yoksa,characterIdbozuksa ya da 96 karakterden uzunsa,centstam sayı değilse,0ise 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
characterIden fazla 96 karakterlik bir string değilsenildöndürür. - Kapatılmış hesaplar dahil edilmez. En fazla 30 hesap döner.
- Ana hesabın bakiyesi dahil değildir.