Cuxial Banking no necesita importar SQL. Crea y actualiza sus tablas en cada arranque. Solo hay que añadir los ítems de inventario y, si quieres logs, una convar.

Comprueba las dependencias

Deben estar instaladas y funcionando antes de añadir el banco:

• ox_lib
• oxmysql
• cuxial_bridge, con un framework, un inventario y un target que soporte
• OneSync activado en el servidor

cuxial_interactions es opcional. Con él en marcha, un punto de banco que tenga modelo de ped pasa a ser un NPC que atiende, con su propio blip. Sin él, el mismo punto funciona como una zona de target con blip.

Quita tu banco anterior

Solo un recurso debe gestionar las cuentas bancarias. Detén y retira cualquier otro script de banco antes de arrancar este.

Copia el recurso

Coloca la carpeta cuxial_banking dentro de tu directorio resources. No le cambies el nombre.

Añade los ítems

El banco usa seis ítems de inventario: tres niveles de tarjeta, el cheque, el talonario de empresa y el recibo impreso. El archivo install/items.lua los trae listos para ox_inventory.

1. Copia las imágenes de install/images/ a ox_inventory/web/images/.
2. Pega las entradas de install/items.lua dentro de la tabla return { ... } de ox_inventory/data/items.lua.

ox_inventory/data/items.lua

['card_standard'] = {
    label = 'Standard Card',
    weight = 5,
    stack = false,
    close = true,
},

['card_premium'] = {
    label = 'Premium Card',
    weight = 5,
    stack = false,
    close = true,
},

['card_elite'] = {
    label = 'Gold Card',
    weight = 5,
    stack = false,
    close = true,
},

['bank_cheque'] = {
    label = 'Cheque',
    weight = 1,
    stack = false,
    close = true,
},

['bank_chequebook'] = {
    label = 'Business Chequebook',
    weight = 50,
    stack = false,
    close = true,
},

['printerdocument'] = {
    label = 'Bank Receipt',
    weight = 1,
    stack = false,
    close = true,
},

Mantén stack = false en los seis: cada tarjeta, cheque y recibo lleva sus propios datos. No pongas consume en el cheque, el talonario ni el recibo: no se gastan igualmente, y con consume = 0 ox_inventory no se los pasa al script y usarlos no hace nada.

El banco no reparte el talonario. Entrega bank_chequebook a los jefes que deban emitir cheques de empresa, mediante una tienda, un almacén del trabajo o tus herramientas de administración.

Decide cómo se maneja el efectivo

Por defecto el banco trata el efectivo como un ítem de inventario llamado money. Antes del primer arranque, ajústalo a tu servidor:

Pon el nombre de tu ítem de efectivo.

shared/config.lua

general = {
    -- ...
    cashItem = 'cash',
},

Tras el primer arranque, este ajuste vive en la base de datos. Cámbialo desde /bankadmin → Config → General. Consulta Configuración.

Define las convars

Todas son opcionales.

server.cfg

# Idioma (se incluyen en y es)
setr ox:locale "es"

# Webhook de Discord para los logs del banco
set cuxial_banking_webhook "https://discord.com/api/webhooks/..."

# Opcional: un webhook distinto para un tipo de log
set cuxial_banking_webhook_transfer "https://discord.com/api/webhooks/..."

# Trazas de depuración en la consola
setr cuxial_banking_debug "0"

El webhook va en server.cfg, nunca en los archivos del recurso. Sin él no se envía ningún log.

Arranca el recurso

Arranca el banco después de sus dependencias, tu framework, tu inventario y tu target:

server.cfg

ensure ox_lib
ensure oxmysql
# tu framework, inventario y target aquí
ensure cuxial_bridge
# opcional
ensure cuxial_interactions
ensure cuxial_banking

En el primer arranque la consola lista cada paso de base de datos según se aplica, se crea una cuenta de empresa por cada trabajo de tu framework y se crean las sucursales de data/banks.lua.

En los frameworks que guardan los personajes en una tabla players, el primer arranque le añade cinco columnas: pincode, cuxial_credit_score, cuxial_bank_contacts, opening_date e iban. Haz una copia de tu base de datos antes de instalar.

Comprueba que funciona

1. Entra al servidor y ve a un banco. El blip está en el mapa y la opción de target abre el banco.
2. Deposita algo de efectivo y vuelve a retirarlo. El saldo y el historial se actualizan.
3. Pide una tarjeta en el banco y úsala en un cajero con su PIN.
4. Escribe /bankadmin con una cuenta de staff. Se abre el panel.

Siguiente: aprende cómo funciona cada parte en la Guía de funciones, o ajusta el banco en Configuración.