Agency-Banking: Um banco completo para FiveM, com ou sem framework

Um banco completo para sua cidade

Agency-Banking transforma cada agência bancária e caixa eletrônico em um app bancário completo. Os jogadores veem o saldo bancário e o dinheiro em mãos lado a lado, enviam dinheiro e gerenciam cartões, depósitos a prazo e investimentos em um só lugar. Funciona com QBCore, Qbox ou ESX e, em um servidor sem framework, mantém as próprias contas. O único recurso obrigatório é oxmysql.

Tudo no menu

• Carteira: saldo bancário e dinheiro em mãos, depósitos e saques.
• Transferências: por ID do servidor ou para um jogador que esteja por perto.
• Cartões: cartões bancários em quatro temas.
• PIN do caixa eletrônico: bloqueia por 60 segundos após cinco tentativas erradas.
• Depósitos a prazo: 7, 14 ou 30 dias por padrão, com taxas definidas pela configuração do servidor, nunca pelo jogador.
• Mercados: negociação de ações e criptomoedas.
• Registro de atividades: histórico completo da conta.

Framework detectado ou standalone

Deixe a configuração do framework em auto e o banco detectará QBCore, Qbox ou ESX automaticamente, mesmo que um deles inicie mais tarde. A cada inicialização, o console do servidor informa qual framework foi detectado ou se o banco está rodando em standalone. standalone só é escolhido quando nenhum deles está instalado.

No modo standalone, os jogadores são identificados pela licença Rockstar e os administradores são definidos por ACE ou por uma lista de licenças na configuração. O saldo e o dinheiro em mãos são mantidos pelo próprio banco. Com Agency-Phone instalado, o celular e o banco compartilham o mesmo saldo, e servidores com sistema próprio de dinheiro podem conectá-lo por meio de alguns hooks na configuração.

O sistema de dinheiro para seus outros scripts

Os exports do servidor funcionam da mesma forma em todos os frameworks. Em um servidor standalone, eles são o sistema de dinheiro: uma loja, um emprego ou uma garagem paga os jogadores e cobra deles pelo banco, e um banco aberto mostra o novo saldo na hora.

-- pay a player into their bank account
exports['Agency-Banking']:AddBankMoney(source, 500, 'Paycheck')

-- charge a player: returns false and takes nothing if the balance is too low
if not exports['Agency-Banking']:RemoveBankMoney(source, 150, 'Garage fee') then
    -- not enough money
end

O mesmo par existe para dinheiro em mãos com AddCashMoney e RemoveCashMoney, junto de GetBankBalance, GetCashBalance, AddTransaction para o registro de atividades e GetFramework. No QBCore e no ESX, um banco aberto acompanha automaticamente as alterações de dinheiro do framework. Depois de qualquer outra alteração, acione agency_banking:client:MoneyChanged para aquele jogador.

Verificado no servidor

Pagamentos, taxas de juros, depósitos a prazo, cartões e transações são verificados no servidor, para que um cliente modificado não possa criar dinheiro nem acessar os cartões de outros jogadores. O pareamento com o Companion não concede direitos bancários próprios: toda ação com dinheiro feita pelo app é validada novamente no servidor.

Dois designs e um controle de tamanho

O menu segue o design da Agency: painel escuro sólido, detalhes dourados, botões em formato de pílula e um destaque dourado que desliza pela barra lateral. Servidores que preferem o visual azul clássico podem mudar a configuração de design para v1 e manter todos os recursos.

Cada jogador pode ajustar o tamanho do banco de 60 a 150 por cento, em incrementos de 1 por cento, em Settings, e cada um mantém seu próprio tamanho. O banco oferece suporte a 13 idiomas e abre em marcadores ou pelo qb-target ou ox_target.

Instalação e atualizações

Não é necessário importar SQL: todas as tabelas, colunas e índices são criados na primeira inicialização, tanto no MariaDB quanto no MySQL 8. O recurso incluído agency_banking.sql serve apenas para servidores cujo usuário do banco de dados não pode criar tabelas. Por padrão, /openbank é apenas para admins, e uma opção de configuração permite disponibilizá-lo para todos os jogadores.

As atualizações são gratuitas para todos que já possuem Agency-Banking. Contas, cartões, transações, depósitos a prazo e pareamentos com o Companion são mantidos após a atualização. Use o novo config.lua em vez de sobrescrevê-lo com o antigo e execute refresh antes de reiniciar o resource quando o manifest tiver sido alterado.

Banco no celular Real

Agency-Banking se conecta ao app gratuito Agency Companion para iOS e Android, de forma independente do Agency-Phone: saldo, transferências, cartões, depósitos a prazo e PIN do caixa eletrônico em qualquer lugar. Os jogadores fazem o pareamento com /abconnect, códigos curtos /abcou usando o código QR no menu do banco.

Adquira Agency-Banking

Agency-Banking está disponível no loja da Agency Scripts, e na documentação aborda configuração, exports e events.