Uso

Las tres ventanas#

Banking Creator tiene tres interfaces, y conviene saber desde el principio cuál es cuál:

El aviso del mostrador aparece a menos de 2.5 m del punto de una sucursal, los cajeros adicionales a menos de 2 m y el portátil del jefe a menos de Config.Laptop.distance. Con Config.UseTarget configurado, esos mismos puntos pasan a ser zonas de target.

Las sucursales están en la base de datos, no en config.lua. Todo lo que se coloca en el creador o se cambia en Manage se envía a todos los jugadores en cuanto se guarda — los blips, peds, props, zonas de target y puertas se reconstruyen al instante.

Con qué empieza un servidor nuevo#

La importación SQL coloca los ocho bancos que ya existen en el mapa de GTA, cada uno con un ped cajero, un blip y la emisión de tarjetas activada:

Los ocho empiezan siendo del Estado y no están a la venta. Todos los props de cajero del mapa también funcionan — prop_atm_01, prop_atm_02, prop_atm_03 y prop_fleeca_atm — además de cualquier cajero que coloques tú mismo.

El banco del cliente#

La cabecera muestra el nombre público de la sucursal y un botón Buy cuando está a la venta. Las pestañas de abajo solo aparecen cuando tienen algo que ofrecer:

Mover dinero#

• Deposit lleva el efectivo del bolsillo del jugador a la cuenta bancaria; Withdraw hace lo contrario.

• Transfer envía dinero a otro jugador que se busca escribiendo el nombre de su personaje — bastan dos letras, y solo se muestran los jugadores conectados.

• En el mostrador de una sucursal con propietario, se cobra además la comisión de servicio del propietario (consulta Comisiones y tesorería).

• El dinero congelado por la revisión de depósitos aparece como una línea ámbar bajo el saldo y no se puede retirar ni transferir.

Cajeros automáticos#

Un cajero automático es una sesión más ligera: la cuenta, el historial y los tres botones de dinero, además de las cuentas de empresa y los pagos programados. El crédito, las hipotecas, las propiedades y la emisión de tarjetas son exclusivos del mostrador.

Una tarjeta abre la cuenta de su titular. Una tarjeta robada y su PIN permiten a un ladrón retirar dinero de la cuenta de la víctima — es intencionado, para el roleplay de robos. Tres PIN incorrectos seguidos bloquean la tarjeta hasta que su titular la descongele en un mostrador.

Tarjetas bancarias#

Una tarjeta es un nivel, no solo un color: el banco solo la imprime cuando la puntuación crediticia del jugador alcanza el mínimo del nivel, y cobra su precio en efectivo.

Edita los nombres, las puntuaciones y los precios en Config.CardTiers, pero mantén los cinco ids — classic, silver, gold, platinum, black — porque cada uno tiene su propio diseño de tarjeta en la interfaz. Con la puntuación crediticia desactivada, todos los niveles están disponibles.

• Las tarjetas solo se emiten y gestionan en un mostrador, a menos de Config.CardIssueDistance (4 m) del punto de la sucursal — nunca en un cajero.

• Config.CreateCardEverywhere = false limita la emisión a las sucursales con Allow card creation marcado en el creador.

• Un jugador puede tener Config.MaxiCardsCreated tarjetas (4).

• Desde la pestaña Cards, el titular cambia el PIN, congela y descongela, cambia a otro diseño desbloqueado, reimprime una tarjeta perdida (solo si no la lleva ya encima) y la elimina.

• En una sucursal con propietario, el precio de la tarjeta va a la tesorería de la sucursal.

Crédito#

La puntuación crediticia#

Cada jugador tiene una puntuación entre 300 y 850, recalculada a partir de su historial cada vez que se consulta:

La puntuación sitúa al jugador en un nivel, y el nivel modifica las condiciones que le ofrece cada sucursal:

Establece Config.Loans.score.enable = false y todos reciben las condiciones básicas de la sucursal, y todos los niveles de tarjeta están disponibles.

Préstamos#

Las condiciones de préstamo tienen tres capas: Config.Loans.default sirve de base para cada sucursal, el creador o el panel Manage de la sucursal las sustituye por sucursal (mínimo, máximo, interés, cuotas, aprobación automática), y el nivel de puntuación del jugador ajusta el resultado.

1. El jugador lo solicita

   En la pestaña Loans elige un importe y el número de cuotas; el simulador muestra la cuota, el interés y el total. Puede añadir un motivo y, con qs-housing, ofrecer una casa como garantía.

2. La sucursal decide

   Una sucursal del Estado con aprobación automática paga al instante. Una sucursal con propietario siempre espera: el propietario recibe una notificación, y cualquiera con el permiso credit la aprueba o la rechaza en Manage → Credit, donde se muestra el número de teléfono del solicitante. El solicitante debe estar conectado para recibir el dinero, y el préstamo se paga desde la tesorería de la sucursal.

3. Se cobran las cuotas

   Cada Config.Loans.interval minutos se cobra la cuota de la cuenta bancaria — incluso cuando el jugador está desconectado — y se devuelve a la tesorería de la sucursal que hizo el préstamo. El jugador también puede pagar una cuota a mano, o liquidar el resto de una vez mientras earlyPayoff esté activado.

4. Pagos impagados

   Si la cuenta no puede cubrir una cuota, se añade a la deuda un recargo por demora del lateFee % de la cuota. Tras maxMissed pagos impagados seguidos, el préstamo pasa a estar en impago: los cobros automáticos se detienen, la puntuación se resiente y la sucursal embarga la casa ofrecida como garantía.

Hipotecas#

Con qs-housing en ejecución, conviven dos tipos de hipoteca — no los confundas:

Sucursales con propietario#

Cualquier sucursal puede convertirse en un negocio de un jugador. Un administrador la pone a la venta en el creador (Ownership & Sale → List this bank for sale y un precio), y aparece un botón Buy en la cabecera de ese banco. El precio sale de la cuenta bancaria del comprador.

Comisiones y tesorería#

• Un nuevo propietario empieza con Config.Ownable.defaultFee % (2) y puede fijar cualquier comisión hasta maxFee (10). Se cobra en retiradas y transferencias en sus mostradores — y en depósitos si feeOnDeposit está activado — y nunca al propio propietario.

• Las comisiones, las ventas de tarjetas, los reembolsos de préstamos y las ventas de propiedades van a la tesorería de la sucursal; los préstamos y las compras de propiedades salen de ella.

• Al comprarla, la tesorería se inicia con Config.Ownable.startingTreasury (2,000,000). Ese fondo es el capital de trabajo de la sucursal: solo se puede retirar lo que está por encima de él, así que comprar y revender un banco nunca crea dinero.

• Cuando otro jugador compra una sucursal con propietario, el propietario anterior recibe el precio más lo que se pudiera retirar (payFromPreviousOwner). Venderla de vuelta al Estado reembolsa la tesorería retirable más el sellRefundPercent % (50) de lo que pagó el propietario.

Licencias#

Una sucursal del Estado es un mostrador básico. El propietario la convierte en un banco completo comprando licencias en Manage → Overview, que se pagan desde su propia cuenta bancaria:

Config.BankUpgrades.stateOwned decide qué puede hacer una sucursal sin propietario sin licencias, y Config.BankUpgrades.enable = false le da todo a cada sucursal. Los nombres y descripciones de las licencias vienen de los archivos de idioma (ui.upgrades.catalog); añade title y description a una entrada del catálogo para sustituirlos.

El panel Manage#

Rangos y permisos#

Un rango es un nombre, un grado y cualquier combinación de siete permisos. Una sucursal puede tener hasta diez rangos; el propietario siempre tiene todos los permisos.

Cada sucursal empieza con Manager (todo), Banker (finanzas, crédito, clientes, puertas) y Teller (clientes, puertas). Comprar las licencias, colocar cajeros y poner la sucursal a la venta siguen siendo cosa del propietario.

Puertas#

Las puertas seleccionadas en el creador solo se bloquean cuando la sucursal tiene propietario — un banco sin propietario es público. El propietario y los rangos con doors ven [E] - Lock Door a menos de Config.Doors.distance; las dos hojas de una puerta doble se mueven juntas. Con lockedOnBuy, la sucursal se cierra en cuanto se compra.

Revisión de depósitos#

Un depósito igual o superior a minAmount se registra en la cuenta y luego se congela: el cliente ve el dinero, pero no puede retirarlo ni transferirlo hasta que termine la retención.

Config.Screening = {
    enable      = true,   -- false = no deposit is ever flagged
    minAmount   = 250000, -- deposits of this or more are flagged (0 = flag nothing)
    holdHours   = 3,      -- hours the money stays frozen (0 = flag it, never freeze it)
    autoRelease = true,   -- the money unfreezes on its own when the hours are up
    includeAtms = true,   -- screen ATM deposits as well as counter deposits
}

• Los depósitos retenidos aparecen en Manage → Finance y en la ficha del cliente, para cualquiera con el permiso customers.

• Clear libera el dinero de inmediato. Return lo saca de la cuenta y lo entrega en efectivo — el cliente debe estar conectado.

• Los depósitos en cajeros no pertenecen a ninguna sucursal, así que cualquier sucursal puede revisarlos.

• Con autoRelease = false, solo un banquero libera el dinero — en un servidor donde nadie gestiona una sucursal, puede quedarse congelado indefinidamente.

Cuentas de empresas y bandas#

Cada trabajo — y cada banda en QBCore — tiene una cuenta compartida, que se abre automáticamente la primera vez que un miembro visita la pestaña Company (autoCreate). Se guarda en la tabla propia de qs-banking, así que funciona igual en ESX y QBCore sin esx_addonaccount ni qb-management.

Los depósitos y retiradas mueven dinero entre la cuenta bancaria del miembro y la de la empresa; Pay envía dinero de la empresa directamente a un jugador conectado, con una nota. Cada movimiento se registra con quién, qué y por qué. El jefe es quien el framework marque como jefe — en ESX, cuyos trabajos no tienen indicador de jefe, cualquiera con grado igual o superior a bossGrade (3).

Los jefes editan los dos roles en el juego. Para un control más fino, asigna grados a roles en la configuración — cualquier rol que no sea jefe o personal solo existe ahí:

Config.Society.roles.manager = {
    label = 'Manager', view = true, deposit = true,
    withdraw = true, transfer = true, manage = false,
    limit = 25000, window = 60,
}

Config.Society.gradeRoles = {
    police = {
        [0] = 'staff',
        [2] = 'manager',
        [3] = { label = 'Captain', withdraw = true, transfer = true, limit = 50000 },
        [4] = 'boss',
    },
    -- ['*'] = { ... } applies to every job or gang not listed
}

Órdenes permanentes#

Transferencias recurrentes que un jugador configura una vez en la pestaña Scheduled — alquiler, salarios, devolver dinero a alguien. El destinatario debe estar conectado cuando se crea la orden; después, el banco la cobra según el calendario, estén conectados o no.

Banca inmobiliaria#

Requiere qs-housing y, en la sucursal, la licencia Real Estate. Desactiva toda la sección con Config.RealEstate.enable = false.

Casa como garantía. En una sucursal con la licencia, un prestatario puede ofrecer como garantía una casa que posea por completo. El préstamo no puede superar el maxLoanToValue % (70) del precio de la casa, y una casa solo puede respaldar un préstamo abierto. Si el préstamo entra en impago, la sucursal embarga la casa y se avisa al antiguo propietario por teléfono.

El creador de bancos#

/bankcreator abre una lista de todos los bancos y cajeros a la izquierda, con búsqueda, y el formulario del seleccionado a la derecha. Teleport te lleva hasta él; New crea uno nuevo.

Un cajero necesita una etiqueta, una posición y un blip, además de una elección: Spawn a physical ATM prop coloca una máquina nueva del modelo elegido, mientras que dejarlo desactivado convierte un cajero ya existente en el mapa en un punto de interacción.

Colocar un punto#

Cada posición — punto del banco, ped, portátil, cajero, cajero adicional — se coloca de la misma forma: la ventana se oculta y se activa una cámara libre, con una vista previa translúcida del ped o prop real bajo el cursor.

La rotación y la altura se muestran en pantalla mientras colocas, y al volver a colocar algo se parte de la rotación que ya tenía.

Seleccionar puertas#

Pick doors abre la misma cámara libre. Apunta a una puerta y haz clic izquierdo para añadirla — o quitarla si ya está seleccionada —; el clic derecho deshace la última, Enter termina y Backspace cancela. Las puertas seleccionadas se resaltan en verde.

Save y la sucursal aparece para todos a la vez — blip, ped, portátil, zonas de target y puertas. Eliminar un banco o un cajero lo quita de la misma forma, y no se puede deshacer.

Notificaciones del teléfono#

Con qs-smartphone en ejecución, el banco envía notificaciones agrupadas en su propia app. Cada tipo tiene su propio interruptor en Config.PhoneNotifications:

Las congelaciones de tarjetas, los depósitos retenidos y liberados, las ofertas de casas y los embargos siempre se notifican mientras el teléfono está activado.