> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/es/nucleo/cuxial-banking/features.md).

# Guía de funciones

Cómo se usa Cuxial Banking en el juego: cuentas, cajeros, tarjetas, cheques, préstamos, ahorros y el panel de staff.

Qué pueden hacer jugadores y staff con el banco, y las reglas que hay detrás de cada parte.

## Sucursales y cajeros

Los jugadores abren el banco con la opción de target de una sucursal. Cada operación se comprueba en el servidor contra la posición del jugador: lejos de una sucursal, nada se ejecuta.

* **Las sucursales** son puntos guardados en la base de datos. El primer arranque las crea a partir de `data/banks.lua`; después, el staff las añade, mueve y elimina desde el panel.
* **Los cajeros** funcionan en los modelos de prop listados en `data/atms.lua` y en cualquier punto de cajero colocado desde el panel.
* Un punto se puede limitar a uno o varios trabajos.

{% hint style="info" %}
Con `cuxial_interactions` en marcha, una sucursal que tenga modelo de ped, o que use el aspecto del propio jugador, se muestra como un NPC que atiende. Sin él, la misma sucursal es una zona de target.
{% endhint %}

## Cuentas

| Cuenta     | Quién la usa                        | Notas                                                                                                                             |
| ---------- | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Personal   | El personaje                        | Su saldo es el dinero de banco de tu framework.                                                                                   |
| De empresa | Los jefes de un trabajo             | Una por trabajo, creada automáticamente a partir de la lista de trabajos de tu framework.                                         |
| Compartida | El titular y los miembros que añada | La crean los jugadores pagando una comisión. Cada miembro tiene sus propios permisos: depositar, retirar, transferir y préstamos. |

El IBAN de una cuenta es su identificador: el identificador del personaje, el nombre del trabajo o el código de la cuenta compartida. No se puede cambiar.

Cada cuenta tiene un PIN, un historial de movimientos y, si están activados, sus propios préstamos y ahorros. Los jugadores pueden guardar contactos de transferencia, marcar favoritos y enviar una transferencia a varios contactos a la vez.

## Tarjetas y cajeros

Una tarjeta se pide en una sucursal, eligiendo el nivel y un PIN. Llega como ítem de inventario.

* Un cajero solo se abre si el jugador lleva una tarjeta activa, y pide su PIN.
* Quien lleve la tarjeta y sepa el PIN puede usarla. El uso por alguien que no es el titular queda registrado.
* Cada nivel tiene un límite diario. Demasiados PIN erróneos bloquean la tarjeta durante un tiempo.
* El titular puede bloquear una tarjeta, cambiarle el PIN o reemplazarla desde el banco. El staff puede bloquearla desde el panel.

## Cheques

{% tabs %}
{% tab title="Cheque personal" %}

1. En una sucursal, el jugador escribe un cheque: beneficiario, importe y un concepto opcional.
2. El importe sale de su cuenta en el momento y el cheque llega como ítem.
3. Le entrega el ítem a alguien.
4. Quien lo tenga lo lleva a una sucursal, lo ingresa y lo cobra en su cuenta.
   {% endtab %}

{% tab title="Cheque de empresa" %}

1. Un jefe usa el ítem talonario.
2. Durante unos segundos (`BookSeconds`, 30 por defecto) aparece una opción de target sobre los jugadores cercanos.
3. El jefe elige a un jugador e introduce el importe y un concepto opcional.
4. El importe sale de la cuenta de empresa y el cheque va directo al inventario de ese jugador.
5. El jugador lo ingresa y lo cobra en una sucursal.

Usar el talonario otra vez lo guarda.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Un cheque se paga al escribirlo, no al cobrarlo. Quien tenga el papel puede ingresarlo, así que un cheque perdido es dinero perdido.
{% endhint %}

Usar un ítem de cheque desde el inventario lo muestra en pantalla.

## Préstamos y puntuación de crédito

Los jugadores piden un préstamo eligiendo entre varios planes, cada uno con un importe máximo, un tipo de interés y un número de cuotas. Cuánto pueden pedir depende del saldo de la cuenta, de la deuda que ya tengan y, en las cuentas personales, de sus nóminas recientes y su puntuación de crédito.

* Vence una cuota cada mes de juego. Un mes de juego dura un día real por defecto.
* Una cuota sin pagar pasa a atrasada al acabar el periodo de gracia y suma una penalización. Pasado el plazo de mora, el préstamo queda en mora.
* Mientras un préstamo está atrasado o en mora, se retiene parte de cada nómina y el banco cobra del saldo de la cuenta.
* La puntuación de crédito sube con los pagos a tiempo y baja con los retrasos y las moras. Mueve hacia arriba o hacia abajo el interés de los préstamos nuevos.

## Ahorros

Los jugadores crean metas de ahorro con un nombre y un objetivo, les pasan dinero y lo retiran cuando quieren. Las metas dan intereses al tipo de su clase de cuenta. El interés se paga una vez por semana de ahorro, que dura 8 horas reales por defecto.

## Nóminas

El banco no genera sueldos. Otros recursos dejan nóminas con el export [`AddPaycheck`](/scripts/es/nucleo/cuxial-banking/developers.md#addpaycheck) y los jugadores las cobran en una sucursal. Las nóminas cobradas cuentan como ingresos cuando el banco calcula cuánto puede pedir prestado un jugador.

## Recompensas

Los jugadores ganan puntos por depósitos, retiros, transferencias, uso del cajero y pagos de préstamos. Los puntos se gastan en un catálogo: efectivo, una comisión gratis, una mejora del interés de los ahorros o un descuento en el próximo préstamo. Los tiempos de espera, un tope diario y un control del dinero que va y vuelve evitan el farmeo de puntos.

## Recibos

Desde el historial, un jugador puede imprimir el recibo de un movimiento pagando una comisión. Llega como ítem de inventario, y al usarlo se muestra en pantalla.

## Panel de staff

`/bankadmin` abre el panel para el staff.

| Pestaña    | Para qué sirve                                                                                                                                                                      |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Resumen    | Totales de dinero del servidor, flujo de las últimas 24 horas y 7 días, préstamos, tarjetas y los saldos más altos.                                                                 |
| Ciudadanos | Busca un personaje por nombre o identificador. Muestra su riqueza, cuentas, préstamos, tarjetas y movimientos. Ajusta un saldo, fija la puntuación de crédito, bloquea una tarjeta. |
| Sociedades | Cuentas de empresa y sus saldos.                                                                                                                                                    |
| Préstamos  | Todos los préstamos. Condona uno o fuerza su cobro.                                                                                                                                 |
| Puntos     | Crea, edita y elimina sucursales y puntos de cajero: posición colocada en el mundo, modelo de ped, blip, zona de target, trabajos permitidos.                                       |
| Config     | Edita los ajustes en vivo, sección por sección. Restablece una sección a los valores del archivo, exporta e importa.                                                                |
| Registro   | Cada acción del staff: quién, qué y cuándo.                                                                                                                                         |

{% hint style="info" %}
Los cambios guardados en Config se aplican al momento a todos los jugadores. La sección de cheques es la excepción: el panel la marca como pendiente de reiniciar el recurso.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cuxial.com/scripts/es/nucleo/cuxial-banking/features.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.