Lo que falla con más frecuencia, lo que realmente significa y qué hacer al respecto. La mayoría son un ajuste, no un bug: activa Config.Debug = true primero: así la consola explica cada paso y las zonas del target se vuelven visibles.
Instalación y acceso#
"You have renamed the script!" y el servidor se queda colgado
La carpeta debe llamarse exactamente qs-banking. Vuelve a ponerle ese nombre y reinicia el servidor.
Errores de tablas al iniciar, o "No banks in bank_locations"
La base de datos nunca se importó. Ejecuta sql/esx.sql o sql/qb.sql: las ocho sucursales del mapa están dentro de esos archivos, las llame como las llame el aviso. Si la consola muestra una sentencia ALTER TABLE, el usuario de la base de datos no puede modificar tablas: ejecuta esa sentencia a mano.
Nada funciona y la consola muestra errores de funciones nil
No se cargó ningún adaptador de framework. Tu framework debe iniciarse antes que qs-banking en server.cfg. En Qbox, configura Config.Framework = 'qb'; consulta Integraciones.
/bankcreator dice que no tengo permiso
No coincidió ninguna de las tres vías: un ace de Config.Creator.aces (añade add_ace group.admin banking.creator allow y asegúrate de que tu identificador esté en group.admin), un grupo de administración del framework con allowAdmins activado, o un trabajo y rango en Config.Creator.jobs. Los aces requieren reiniciar el servidor para aplicarse.
El banco no se abre o no aparece el texto de ayuda
La sucursal aún no tiene posición: ábrela en /bankcreator y coloca el punto del banco. Si usas un target, comprueba que Config.UseTarget indique el recurso que realmente ejecutas; con un valor incorrecto no hay ni zona ni aviso.
Los textos muestran "Translation [xx][key] does not exist"
Falta el archivo del idioma elegido o no es un JSON válido; la consola indica cuál al iniciar. Corrige el archivo, o el código de idioma en Config.Language / qs:locale. Un archivo válido al que le faltan claves recurre al inglés por sí solo.
Cajeros y tarjetas#
"You are not carrying a bank card" en un cajero
Con Config.Metadata = true un cajero necesita una creditcard activa en el inventario. Emite una en un mostrador. En un servidor sin inventario con metadatos, configura Config.Metadata = false.
Las tarjetas no aparecen en el inventario
El ítem creditcard no existe en tu inventario, o el inventario no guarda metadatos. Añade el ítem como se muestra en Instalación. Una tarjeta ya emitida puede reimprimirse desde la pestaña Cards.
"Cards are only issued at a bank counter, not at an ATM"
Las tarjetas se emiten y gestionan dentro de Config.CardIssueDistance (4 m) del punto del banco de la sucursal, nunca en un cajero ni en una ventanilla adicional alejada de él. Si Config.CreateCardEverywhere = false, la sucursal también necesita tener Allow card creation marcado en el creador.
Un nivel de tarjeta está bloqueado
La puntuación de crédito del jugador está por debajo del minScore de ese nivel. Pagar el crédito la sube; o baja los umbrales en Config.CardTiers.
La tarjeta está bloqueada
Tres PIN incorrectos (Config.AttemptsCards) la congelan, o un banquero la congeló desde la ficha del cliente. El titular la descongela en la pestaña Cards en un mostrador.
"You have reached the limit of the hour" en un cajero
El jugador ha movido Config.AtmLimit a través de cajeros en la última hora; el mensaje indica cuánto queda. Los mostradores no tienen límite. Aumenta el valor o desactiva la opción *Limit correspondiente.
Dinero, crédito y sucursales con propietario#
El dinero está en el saldo pero no se puede retirar
Es la revisión de depósitos: un depósito de Config.Screening.minAmount o más se congela durante holdHours. Un banquero puede liberarlo en Manage → Finance. Si nunca se descongela, autoRelease está desactivado y nadie lo revisa: vuelve a ponerlo en true, o aumenta minAmount.
No aparece la pestaña Loans
La sucursal no presta. Por defecto solo lo hacen las sucursales con propietario que tienen la Lending Licence: Config.BankUpgrades.stateOwned.credit es false. Comprueba también Config.Loans.enable, el interruptor Lend money at this branch propio de la sucursal y que estés en un mostrador, no en un cajero.
Falta la pestaña Mortgage o Property
qs-housing no se está ejecutando, Config.RealEstate.enable / Config.Mortgage.enable está desactivado, o la sucursal no ha comprado la licencia Mortgage / Real Estate.
No se puede aprobar un préstamo
O el solicitante está desconectado (offline), y debe estar conectado para recibir el dinero, o la tesorería de la sucursal no puede cubrirlo (treasury). Las solicitudes solo pueden gestionarse en la sucursal donde se presentaron.
El propietario no puede retirar la tesorería
Comportamiento correcto. El fondo inicial (Config.Ownable.startingTreasury) es capital de trabajo y nunca puede retirarse; solo las ganancias por encima de él.
El personal no ve una sección de Manage
Su rango no tiene el permiso para ella: finance, customers, credit, settings o staff. Edita el rango en Manage → Staff. Las licencias y la venta de la sucursal son solo para el propietario.
Las puertas de la sucursal no se cierran con llave
Una sucursal sin propietario es pública, así que sus puertas quedan abiertas. Una vez que tiene propietario, las puertas de MLO que no están en la lista de puertas del juego también necesitan setr game_enableDynamicDoorCreation "true" en server.cfg.
Se rechaza un retiro de la empresa
El rol del miembro no puede retirar, o alcanzó el limit de su rol para el window actual. El jefe lo cambia en la pestaña Company, o en Config.Society.
Mapa y sincronización#
Los blips o peds no se actualizaron tras una edición
Los cambios se difunden al guardar. Un jugador que no los recibió solo tiene que volver a entrar, sin reiniciar. Comprueba también Config.ShowBlips y Config.EnablePeds.
"ATM model could not be loaded" o "Laptop model could not be loaded"
El nombre del modelo guardado en el creador no existe en el juego ni en tus assets en streaming. Elige otro de la lista y guarda.
Las ventas de propiedades no transfieren las llaves
La consola muestra qs-housing has no BankHandover export. Actualiza qs-housing a una versión que tenga ese export.
Motivos de rechazo#
Las acciones responden { ok = false, reason = '...' } cuando se rechazan. Los que verás con más frecuencia:
Motivo | Significado |
|---|---|
| El jugador no tiene el permiso de rango, o la acción es solo para el propietario. |
| El jugador, la cuenta de la empresa o la tesorería de la sucursal no pueden cubrirlo. |
| Fuera del rango permitido: plazos del préstamo, límites de órdenes o más de lo que se puede retirar. |
| Demasiados préstamos u órdenes permanentes abiertos, o el comprador está en el límite de casas de qs-housing. |
| El otro jugador debe estar conectado. |
| Se agotó el límite de retiro de un rol de empresa para el periodo. |
| Se alcanzó el límite de personal, los diez rangos o el máximo de ventanillas adicionales. |
| La sucursal no tiene la licencia o tiene los préstamos desactivados. |
| La casa no es del jugador, está alquilada o todavía tiene crédito de vivienda. |
| La casa ya respalda un préstamo, o el préstamo supera el |
| La base de datos rechazó el guardado; normalmente falta una columna. La consola la indica. |
¿Sigues atascado? Abre un ticket e incluye tu framework e inventario, la salida de la consola desde el inicio con
Config.Debug = truey el mensaje exacto que vio el jugador.