Antes de empezar#
Antes de instalar Banking Creator, asegúrate de que tu servidor cumple los requisitos mínimos. Tres cosas son obligatorias; todo lo demás es opcional y las funciones que dependen de ello simplemente no aparecen cuando falta.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos. El recurso carga |
| Obligatorio | Utilidades compartidas, la carga de modelos del creador y las notificaciones de respaldo. |
Framework | Obligatorio |
|
Inventario con metadatos | Opcional | Tarjetas bancarias como ítems físicos y cajeros automáticos que piden una tarjeta y su PIN. |
| Opcional | Targeting en lugar del texto de ayuda |
| Opcional | Hipotecas, el mostrador de propiedades y una casa como garantía de préstamo. |
| Opcional | Notificaciones en el teléfono sobre dinero, crédito y pagos programados. |
| Opcional | Notificaciones de Quasar y texto de ayuda 3D. Sin ellos, se usan las notificaciones de ox_lib y una etiqueta dibujada. |
Todo lo específico del framework o de terceros está detrás de un pequeño adaptador, y el recurso elige el correcto según lo que ya esté en ejecución:
Capa | Detección |
|---|---|
Framework |
|
Inventario |
|
Targeting | Se establece a mano en |
Viviendas / Teléfono | El recurso indicado en |
Cada integración opcional se desactiva en silencio. Si falta un recurso, esa función desaparece de la interfaz — no se produce ningún error. Integraciones tiene los detalles y cómo fijar una a mano.
github.comReleases · overextended/oxmysqlMySQL resource for FXServer.github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.Descargar Banking Creator#
Después de comprar Banking Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Inicia sesión en CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Banking Creator.
Después de extraer la descarga, deberías tener la siguiente carpeta:
qs-banking/
├── config.lua -- every setting, commented line by line
├── client/custom/ -- framework and target bridges (editable)
├── server/custom/ -- framework, inventory, logs and quests (editable)
├── locales/ -- 41 languages
├── sql/ -- esx.sql · qb.sql
├── web/ -- the interface and the blip pictures
└── fxmanifest.luaLa carpeta debe llamarse
qs-banking. El recurso comprueba su propio nombre al iniciarse y, si se renombró, muestraYou have renamed the script!y detiene el hilo del servidor. Además, todos los exports se llaman a través deexports['qs-banking'].
Instalar el recurso#
Mueve la carpeta qs-banking al directorio resources de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-banking/Una vez copiada, abre tu server.cfg y asegúrate de que todas las dependencias — y todo lo que debe detectar — se inician antes que Banking Creator:
ensure oxmysql
ensure ox_lib
# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core
# Inventory, target, housing, phone
ensure ox_inventory
ensure ox_target
ensure qs-housing
ensure qs-smartphone
ensure qs-bankingEl orden de carga importa. El framework y el inventario se detectan una sola vez, cuando se inicia el recurso, así que uno que se inicie después de Banking Creator no se encuentra. qs-housing y qs-smartphone se comprueban en vivo, pero iniciarlos antes evita un intervalo en el que sus funciones no están disponibles.
Importar la base de datos#
Abre tu gestor de base de datos (HeidiSQL, phpMyAdmin, DBeaver…), selecciona la base de datos de tu servidor y ejecuta un archivo — el que corresponde a tu framework:
Framework | Archivo |
|---|---|
ESX |
|
QBCore / Qbox |
|
Ese único archivo es toda la instalación: todas las tablas, más los ocho bancos que ya existen en el mapa de GTA — siete sucursales de Fleeca y el Pacific Standard —, cada uno con su ped cajero, su blip y la emisión de tarjetas activada.
Tablas | Contienen |
|---|---|
| Sucursales (ubicación, blip, ped, portátil, puertas, propietario, personal, rangos, licencias, condiciones de préstamo) y cajeros colocados con el creador. |
| Tarjetas emitidas, el historial de transacciones de cada jugador y las cantidades detrás de los gráficos. |
| El libro contable de cada sucursal y su ficha de clientes. |
| Préstamos e hipotecas, depósitos congelados y transferencias recurrentes. |
| Cuentas de empresas y bandas, y cada movimiento en ellas. |
| Casas ofrecidas a una sucursal y las casas que posee una sucursal. |
Las actualizaciones nunca necesitan una importación. Las tablas añadidas por versiones nuevas se crean al iniciarse el recurso, y las columnas que faltan se añaden con
ALTER TABLE. Si el usuario de la base de datos no tiene permiso para modificar una tabla, la consola muestra la sentencia exacta que debes ejecutar a mano.
Añadir el ítem de tarjeta#
Omite este paso si no quieres tarjetas físicas. Si no, añade el ítem a tu inventario. El nombre es fijo — creditcard — y debe ser único y llevar metadatos, porque cada tarjeta guarda su propio número, titular, nivel y PIN.
En ox_inventory/data/items.lua:
['creditcard'] = {
label = 'Credit Card',
weight = 10,
stack = false,
close = true,
description = 'A bank card',
},En qb-core/shared/items.lua o qs-inventory/shared/items.lua:
['creditcard'] = {
name = 'creditcard',
label = 'Credit Card',
weight = 10,
type = 'item',
image = 'creditcard.png',
unique = true,
useable = true,
shouldClose = true,
description = 'A bank card',
},Para un inventario de ESX que lee la tabla items:
INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`)
VALUES ('creditcard', 'Credit Card', 1, 0, 1);Con el ítem añadido, mantén Config.Metadata = true. Ponlo en false en un servidor sin inventario con metadatos: los cajeros se abren entonces directamente, sin tarjeta ni PIN.
Conceder acceso al creador#
Las sucursales y los cajeros son datos, no configuración: se colocan y editan en el juego con /bankcreator. Cualquiera de estas vías lo abre:
La vía habitual. Concede el ace banking.creator en server.cfg:
add_ace group.admin banking.creator allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.adminSe acepta cualquier ace indicado en Config.Creator.aces — por defecto group.admin, group.superadmin y banking.creator.
Automático mientras Config.Creator.allowAdmins = true: ESX admin y superadmin, QBCore god y admin, y cualquiera con el ace command en QBCore.
Permite que un trabajo — un gerente de banco, un urbanista — coloque sucursales sin ser administrador:
Config.Creator = {
command = 'bankcreator',
keybind = '', -- e.g. 'F7'; '' = no key
allowAdmins = true,
jobs = {
{ job = 'banker', grade = { 3, 4 } }, -- grade = false: any grade
},
aces = { 'group.admin', 'group.superadmin', 'banking.creator' },
}Cualquiera con acceso al creador también puede abrir el panel Manage de cualquier sucursal; establece Config.Ownable.adminOverride = false para que allí solo tengan acceso de lectura y dejar las decisiones al propietario y al personal.
Activar las puertas dinámicas#
Solo es necesario si piensas bloquear puertas de sucursales que no forman parte de la lista de puertas del propio juego — la mayoría de las puertas de MLO. Añade esto a server.cfg:
setr game_enableDynamicDoorCreation "true"Sin esto, esas puertas se pueden seleccionar en el creador, pero nunca bloquear.
Configurar el recurso#
Todo lo ajustable está en config.lua, comentado opción por opción. Los cambios ahí requieren reiniciar el recurso; las sucursales y los cajeros no, porque están en la base de datos.
Bloque | Qué controla |
|---|---|
| El idioma de todo lo que lee un jugador y el formato del dinero. |
| ox_target, qb-target o el texto de ayuda |
| Cuánto dinero puede moverse por los cajeros por hora. |
| Tarjetas físicas, cuántas puede tener un jugador, intentos de PIN incorrecto y los cinco niveles de tarjeta. |
| Retenciones de depósitos grandes. |
| Sucursales comprables, comisiones, el fondo de tesorería, reembolsos y las licencias que compra un propietario. |
| Valores predeterminados de préstamos, cuotas, recargos por demora y el modelo de puntuación crediticia. |
| Cuentas de empresas y bandas, y pagos recurrentes. |
| Integración con qs-housing y qs-smartphone. |
| Puertas de sucursales, el portátil del jefe, peds cajeros y blips. |
| Qué props del mundo funcionan como cajeros en todo el mapa. |
| Lo que ofrece el creador para cajeros, portátiles del jefe y animaciones de cajeros. |
Los valores que conviene revisar primero:
Config.Language = GetConvar('qs:locale', 'en') -- or setr qs:locale "es" in server.cfg
Config.UseTarget = 'none' -- 'ox_target', 'qb-target' or 'none'
Config.Metadata = true -- physical cards; needs a metadata inventory
Config.AtmLimit = 2500 -- most that can move through ATMs per hour
Config.Intl = {
locales = 'en-US',
options = { style = 'currency', currency = 'USD', minimumFractionDigits = 0 },
}
Config.Debug = false -- verbose console output and visible target zonesVerificar la instalación#
Reinicia tu servidor y lee la consola. Un inicio limpio muestra la comprobación de versión y ninguna línea roja [ERROR] de qs-banking:
You are using the latest version of qs-banking!
[WARNING]: Missing webhooks: deposit, withdraw, transfer, create_card. Please enable them in server/custom/misc/*.lua.El aviso del webhook es inofensivo — solo significa que el registro en Discord está desactivado. Rellena las URL en server/custom/misc/webhooks.lua y la línea pasa a ser qs-banking initiated successfully.
Después, entra en tu servidor y recorre el primer ciclo:
Visita una sucursal
El Fleeca de Legion Square está en el mapa con un blip y un cajero. Acércate al mostrador y pulsa
E(o usa tu target): la interfaz se abre en tu cuenta.Mueve dinero e imprime una tarjeta
Deposita algo de efectivo, luego abre Cards y emite una tarjeta Classic. Llega a tu inventario; úsala junto a cualquier cajero e introduce el PIN.
Abre el creador
/bankcreatormuestra las ocho sucursales. A partir de ahí, Uso explica cómo colocar tu propia sucursal y ponerla a la venta.
A partir de aquí nada requiere reiniciar. Cada cambio de sucursal, cajero, ped, blip, puerta, licencia y propietario se envía a todos los jugadores en cuanto se guarda.