Comandos#
Banking Creator registra un solo comando. Todo lo demás que hace un jugador se encuentra en el mundo — mostradores, cajeros, cajeros automáticos, el portátil del jefe y las puertas de las sucursales.
Comando / tecla | Dónde | Descripción |
|---|---|---|
| En el juego | Abre el creador de bancos. Se renombra con |
| Mostrador, cajero, cajero automático | Abre el banco o el cajero, cuando |
| Portátil del jefe | Abre Manage para el propietario, el personal y los administradores del creador. |
| Puerta de sucursal | La bloquea o desbloquea, para el propietario y los rangos con el permiso |
Exports de servidor#
Cómo otro recurso controla el banco — un trabajo que paga salarios, un atraco que vacía una empresa, una app del teléfono que lee una hipoteca. identifier es el id de personaje del framework: el identifier de ESX o el citizenid de QBCore.
AddTransaction — escribir una línea en el historial de un jugador
Añade una entrada al historial de la pestaña Overview sin mover dinero. El icono es una clase de Font Awesome; un icono piggy-bank se interpreta como entrada de dinero, money-check o wallet como salida de dinero, exchange como transferencia. El primer número del texto se muestra como importe.
exports['qs-banking']:AddTransaction(identifier, 'Paycheck', 'fa-solid fa-piggy-bank', 'Weekly pay: 2500')Cuentas de empresa — GetSocietyMoney, AddSocietyMoney, RemoveSocietyMoney
Lee y mueve la cuenta compartida de un trabajo. La cuenta se abre en el primer uso cuando Config.Society.autoCreate está activado. Cada movimiento se escribe en el registro de la cuenta con el motivo. RemoveSocietyMoney devuelve false y no retira nada cuando el saldo no alcanza.
local balance = exports['qs-banking']:GetSocietyMoney('police')
exports['qs-banking']:AddSocietyMoney('mechanic', 1500, 'Repair invoice #204')
if exports['qs-banking']:RemoveSocietyMoney('police', 5000, 'Weekly wages') then
-- paid
end
local account = exports['qs-banking']:GetSocietyAccount('police', 'job')
-- { id, name, label, type, balance, roles, created }Cada uno acepta un último argumento opcional, 'job' (por defecto) o 'gang'. Para scripts escritos para qb-management, las mismas funciones también responden a GetAccountBalance, AddMoney y RemoveMoney.
Cuentas de bandas — AddGangMoney, RemoveGangMoney, GetGangAccount
exports['qs-banking']:AddGangMoney('ballas', 20000, 'Drug run')
exports['qs-banking']:RemoveGangMoney('ballas', 5000, 'Weapons')
local gang = exports['qs-banking']:GetGangAccount('ballas')Las cuentas de bandas aparecen en la pestaña Company en QBCore con Config.Society.gangs activado.
GetPlayerLoans y GetHousingMortgages — crédito
GetPlayerLoans devuelve el crédito bancario pendiente, activo y en impago del jugador, dividido en préstamos e hipotecas. Cada entrada incluye id, bankId, status, amount, total, paid, remaining, instalment, missed, nextPayment y su garantía.
local credit = exports['qs-banking']:GetPlayerLoans(identifier)
-- credit.loans, credit.mortgages
local housing = exports['qs-banking']:GetHousingMortgages(identifier)
-- { { house, remaining, instalment, instalmentsLeft }, ... } — qs-housing's own creditGetHeldAmount — revisión de depósitos
Cuánto del saldo del jugador está congelado en este momento. Réstalo antes de dejar que otro script gaste de la cuenta bancaria, o el jugador podría pagar con dinero que el banco aún retiene.
local held = exports['qs-banking']:GetHeldAmount(identifier)
local spendable = bankBalance - heldGetBanks y GetAtms — ubicaciones
Cada sucursal y cada cajero colocado con el creador, tal como se cargan de la base de datos. Una sucursal incluye id, name, label, displayName, coords (con w como orientación), blip, ped, owner, ownerName, forSale, price, fee, treasury, employees y upgrades.
for _, bank in ipairs(exports['qs-banking']:GetBanks()) do
print(bank.id, bank.displayName or bank.label, bank.owner)
end
local atms = exports['qs-banking']:GetAtms()IsRealEstateReady y GetHouseBuyers — banca inmobiliaria
if exports['qs-banking']:IsRealEstateReady() then
local buyers = exports['qs-banking']:GetHouseBuyers()
-- { { id, label, ownerName, treasury }, ... } owned branches with the Real Estate licence
endExports de cliente#
CreateCard — usar un ítem de tarjeta desde el cliente
Pensado para el client.export de ox_inventory y para origen_inventory. Lee los metadatos de la tarjeta, comprueba que el jugador está junto a un cajero y abre el teclado de PIN.
client = { export = 'qs-banking.CreateCard' }Eventos y callbacks#
-- Client → server: same as AddTransaction, for the calling player
TriggerServerEvent('banking:server:addTransaction', 'Paycheck', 'fa-solid fa-piggy-bank', 'Weekly pay: 2500')
-- Client → server: offer one of the player's houses to a branch (qs-housing)
TriggerServerEvent('qs-banking:server:offerHouseToBank', house, bankId, price)
-- ox_lib callback: branches that buy houses
local buyers = lib.callback.await('qs-banking:getHouseBuyers', false)
-- Client: fired on every player whenever a branch or ATM changes
RegisterNetEvent('banking:client:syncLocations', function(payload)
-- payload.banks, payload.atms
end)Sobre las respuestas#
Cada acción que puede rechazarse responde { ok = false, reason = '...' }, y la interfaz convierte el motivo en un mensaje traducido. El servidor vuelve a comprobar la propiedad y los permisos de rango en cada una de ellas, así que nada enviado desde un cliente modificado consigue pasar. Errores comunes explica qué significa cada motivo.