Agency-Banking: un banco completo para FiveM, con o sin framework

Un banco completo para tu ciudad

Agency-Banking convierte cada sucursal bancaria y cajero automático en una app bancaria completa. Los jugadores ven el saldo bancario y el efectivo uno al lado del otro, envían dinero y gestionan tarjetas, depósitos a plazo e inversiones en un solo lugar. Funciona con QBCore, Qbox o ESX, y en un servidor sin framework mantiene sus propias cuentas. El único recurso obligatorio es oxmysql.

Todo en el menú

• Cartera: saldo bancario y efectivo, depósitos y retiros.
• Transferencias: por ID del servidor o a un jugador que esté cerca.
• Tarjetas: tarjetas bancarias en cuatro temas.
• PIN del cajero: se bloquea durante 60 segundos tras cinco intentos incorrectos.
• Depósitos a plazo: 7, 14 o 30 días de forma predeterminada, con tasas definidas por la configuración del servidor y nunca por el jugador.
• Mercados: trading de acciones y criptomonedas.
• Registro de actividad: un historial completo de la cuenta.

Framework detectado o standalone

Deja la configuración del framework en automático y el banco detectará QBCore, Qbox o ESX por sí solo, incluso si se inicia tarde. Cada vez que se inicia, la consola del servidor indica qué framework detectó o que el banco funciona en modo standalone. Standalone solo se selecciona cuando ninguno está instalado.

En modo standalone, los jugadores se identifican mediante su licencia de Rockstar y los administradores se obtienen de ACE o de una lista de licencias en la configuración. El propio banco gestiona el saldo y el efectivo. Con Agency-Phone instalado, el teléfono y el banco comparten el mismo saldo, y los servidores con su propio sistema de dinero lo conectan mediante unos pocos hooks en la configuración.

El sistema de dinero para tus otros scripts

Las funciones exportadas del servidor funcionan igual en todos los frameworks. En un servidor standalone, son el sistema de dinero: una tienda, un trabajo o un garaje paga y cobra a los jugadores a través del banco, y al abrir el banco se muestra el nuevo saldo de inmediato.

-- 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

El mismo par está disponible para el efectivo con AddCashMoney y RemoveCashMoney, junto a GetBankBalance, GetCashBalance, AddTransaction para el registro de actividad y GetFramework . En QBCore y ESX, el banco abierto detecta por sí solo los cambios de dinero del framework. Después de cualquier otro cambio, ejecuta agency_banking:client:MoneyChanged para ese jugador.

Verificado en el servidor

Los pagos, las tasas de interés, los depósitos a plazo fijo, las tarjetas y las transacciones se verifican en el servidor, así que un cliente modificado no puede crear dinero ni acceder a las tarjetas de otros jugadores. La vinculación con Companion no concede permisos bancarios: todas las acciones con dinero desde la aplicación se vuelven a validar en el servidor.

Dos diseños y un control de tamaño

El menú sigue el diseño de Agency: un panel oscuro sólido, detalles dorados, botones tipo píldora y un resaltado dorado que se desliza por la barra lateral. Los servidores que prefieran el estilo azul clásico pueden cambiar el ajuste de diseño a v1 y conservar todas las funciones.

Cada jugador puede ajustar el tamaño del banco del 60 al 150 por ciento en incrementos del 1 por ciento desde Ajustes, y cada jugador conserva su propio tamaño. El banco está disponible en 13 idiomas y se abre en marcadores o mediante qb-target u ox_target.

Instalación y actualizaciones

No hace falta importar SQL: todas las tablas, columnas e índices se crean en el primer inicio, tanto en MariaDB como en MySQL 8. El archivo agency_banking.sql incluido solo es necesario para servidores cuyo usuario de base de datos no pueda crear tablas. De forma predeterminada, /openbank solo está disponible para los administradores, pero una opción de configuración permite abrirlo para todos los jugadores.

Las actualizaciones son gratuitas para todos los que ya tienen Agency-Banking. Las cuentas, tarjetas, transacciones, depósitos a plazo fijo y vinculaciones con Companion se conservan al actualizar. Usa el nuevo config.lua en lugar de copiar encima el anterior, y ejecuta refresh antes de reiniciar el recurso si ha cambiado el manifest.

Banca en el teléfono real

Agency-Banking se vincula con la aplicación gratuita Agency Companion en iOS y Android, de forma independiente de Agency-Phone: saldo, transferencias, tarjetas, depósitos a plazo fijo y PIN del cajero automático, estés donde estés. Los jugadores se vinculan con /abconnect, de forma breve /abco mediante el código QR del menú del banco.

Consigue Agency-Banking

Agency-Banking está disponible en el tienda de Agency Scripts, y la documentación incluye la configuración, las funciones exportadas y los eventos.