> 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/installation.md).

# Instalación

Instala Cuxial Banking paso a paso: dependencias, ítems de inventario, convars y orden de arranque.

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.

{% stepper %}
{% step %}

## 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.
{% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## Copia el recurso

Coloca la carpeta `cuxial_banking` dentro de tu directorio `resources`. No le cambies el nombre.
{% endstep %}

{% step %}

## 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`.

{% code title="ox\_inventory/data/items.lua" %}

```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,
    consume = 0,
},

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

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

{% endcode %}

{% hint style="warning" %}
Mantén `stack = false` en los seis: cada tarjeta, cheque y recibo lleva sus propios datos. `consume = 0` permite usar el cheque, el talonario y el recibo sin que se gasten.
{% endhint %}

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.
{% endstep %}

{% step %}

## 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:

{% tabs %}
{% tab title="El efectivo es un ítem" %}
Pon el nombre de tu ítem de efectivo.

{% code title="shared/config.lua" %}

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

{% endcode %}
{% endtab %}

{% tab title="El efectivo es una cuenta del framework" %}
Desactiva el modo ítem.

{% code title="data/general.lua" %}

```lua
UseCashAsItem = false,
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Tras el primer arranque, este ajuste vive en la base de datos. Cámbialo desde `/bankadmin` → Config → General. Consulta [Configuración](/scripts/es/nucleo/cuxial-banking/configuration.md#donde-viven-los-ajustes).
{% endhint %}
{% endstep %}

{% step %}

## Define las convars

Todas son opcionales.

{% code title="server.cfg" %}

```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"
```

{% endcode %}

{% hint style="info" %}
El webhook va en `server.cfg`, nunca en los archivos del recurso. Sin él no se envía ningún log.
{% endhint %}
{% endstep %}

{% step %}

## Arranca el recurso

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

{% code title="server.cfg" %}

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

{% endcode %}

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`.

{% hint style="warning" %}
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.
{% endhint %}
{% endstep %}

{% step %}

## 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.
   {% endstep %}
   {% endstepper %}

Siguiente: aprende cómo funciona cada parte en la [Guía de funciones](/scripts/es/nucleo/cuxial-banking/features.md), o ajusta el banco en [Configuración](/scripts/es/nucleo/cuxial-banking/configuration.md).


---

# 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/installation.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.