Los problemas más habituales tras instalar Cuxial Banking, con la causa y la solución de cada uno.

El recurso no arranca

Causa. Falta una dependencia o arranca después del banco. Cuxial Banking necesita OneSync, ox_lib, oxmysql y cuxial_bridge.

Solución. Activa OneSync y arranca antes las dependencias:

server.cfg

ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_banking

Todas las operaciones fallan y la consola muestra un paso de base de datos en rojo

Causa. Un paso de base de datos falló al arrancar. El banco deja de aplicar el resto para no dejar las tablas a medias, y rechaza las operaciones hasta que la base de datos esté lista.

Solución. Lee las líneas en rojo de la consola del servidor: indican el paso y el motivo que da la base de datos. Una causa habitual es un usuario de base de datos sin permiso para crear o modificar tablas. Corrige la causa y reinicia el recurso; continúa desde el paso que falló.

He editado un archivo de data/ y no ha cambiado nada

Causa. Tras el primer arranque, las secciones general, cuentas, tarjetas, préstamos, ahorros, cheques, recompensas, puntuación de crédito, cajeros, admin y logs se leen de la base de datos, no de los archivos.

Solución. Cambia el valor en /bankadmin → Config. Para volver a cargar el archivo, reinicia el recurso y pulsa el botón de restablecer de esa sección en el panel. Consulta Dónde viven los ajustes.

El efectivo sale a 0, o fallan los depósitos y los retiros

Causa. El banco está contando el efectivo como un ítem de inventario llamado money, y tu servidor usa otro ítem o guarda el efectivo en el framework.

Solución. En /bankadmin → Config → General, pon como ítem de efectivo el que use tu inventario, o desactiva el efectivo como ítem. Antes del primer arranque, hazlo en los archivos como se indica en Instalación.

No hay blips de banco ni opción de target en las sucursales

Causa. Una de estas:

• No hay en marcha ningún target soportado por cuxial_bridge.
• Las sucursales no llegaron a crearse, porque la tabla de puntos ya tenía filas o BankLocations estaba vacío en el primer arranque.
• ShowBankBlips está desactivado, lo que oculta solo los blips.

Solución. Arranca tu target antes que el banco. Después abre /bankadmin → Puntos y revisa la lista; crea ahí las sucursales si está vacía.

He cambiado BankLocations y las sucursales no se han movido

Causa. data/banks.lua solo se lee en el primer arranque, para rellenar una tabla de puntos vacía.

Solución. Mueve, añade o elimina sucursales desde /bankadmin → Puntos.

El NPC de la sucursal no aparece

Causa. Los NPC los muestra cuxial_interactions. Sin él, o cuando el punto no tiene modelo de ped, la sucursal es una zona de target.

Solución. Arranca cuxial_interactions y ponle un modelo de ped al punto en /bankadmin → Puntos. El banco recoge el cambio cuando ese recurso arranca o se detiene; no hace falta reiniciar.

El cajero dice que no tengo tarjeta

Causa. Un cajero solo se abre a un jugador que lleve una tarjeta activa. También puede que falten los ítems de tarjeta en el inventario, de modo que el banco no pudo entregar ninguna.

Solución. Pide una tarjeta en una sucursal. Si el pedido falla, comprueba que card_standard, card_premium y card_elite existen en tu inventario con stack = false, y que el item de cada nivel en los ajustes coincide con esos nombres.

Usar el cheque, el talonario o el recibo no hace nada

Causa. Los ítems no están registrados en el inventario, o sus nombres no coinciden con los de los ajustes.

Solución. Añade las entradas de install/items.lua a tu inventario, quita cualquier línea consume de los tres y reinicia el servidor. El talonario solo se abre a un jefe de un trabajo.

Al emitir un cheque dice que necesitas el talonario, pero lo tienes

Causa. Las versiones anteriores a la 2.0.3 perdían el ajuste del talonario si los ajustes de cheques se habían guardado con una versión anterior.

Solución. Actualiza a la 2.0.3 o posterior y reinicia el recurso. No hace falta nada más: las opciones que faltan conservan ahora su valor por defecto.

El talonario dice que hace falta ser jefe

Causa. Los cheques de empresa salen de la cuenta de empresa, que solo pueden usar los jefes del trabajo.

Solución. Dale al jugador un rango de jefe en su trabajo.

Un trabajo no tiene cuenta de empresa

Causa. Las cuentas de empresa se crean al arrancar a partir de la lista de trabajos de tu framework. El trabajo aún no existía, o el framework no estuvo listo durante el primer minuto.

Solución. Asegúrate de que el framework arranca antes que el banco y reinicia cuxial_banking. Los trabajos nuevos reciben su cuenta en el siguiente arranque.

Los jugadores nunca reciben nóminas en el banco

Causa. El banco no genera sueldos. Solo guarda las nóminas que le envían otros recursos.

Solución. Llama a AddPaycheck desde el recurso que paga los sueldos.

Las compras hechas en otros recursos no salen en el historial

Causa. Una de estas:

• LogExternalBankChanges está desactivado.
• El servidor usa ESX. Este registro requiere QBox o QBCore.
• El otro recurso usó AddMoney o RemoveMoney del banco, que no anotan historial.

Solución. Activa la opción en /bankadmin → Config → General, o anota tú el apunte con AddTransaction.

/bankadmin dice que no tengo permiso

Causa. Tu personaje no tiene en tu framework el permiso fijado en admin.permission, 'admin' por defecto.

Solución. Concédete ese permiso en el framework. En ESX el grupo debe ser admin o superadmin. Consulta Comandos y permisos.

No llega ningún log a Discord

Causa. La convar está vacía, o ese tipo de log está desactivado.

Solución. Añade el webhook a server.cfg con set, no en los archivos del recurso:

server.cfg

set cuxial_banking_webhook "https://discord.com/api/webhooks/..."

Después comprueba en /bankadmin → Config → Logs que los logs y ese tipo de log están activados.

La opción de target no abre nada, o la pantalla se queda vacía

Causa. La interfaz no carga. La carpeta web/build falta o está incompleta, normalmente por una subida parcial.

Solución. Comprueba que web/build/index.html y la carpeta web/build/assets existen dentro del recurso. Si no, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.