# menus

CubixDeposit te permite crear múltiples menús de depósito en `gui/`, cada uno completamente independiente con su propio diseño, items permitidos y sonidos.

{% hint style="info" %}
Esto genera un archivo nuevo en `gui/` con la estructura base lista para editar.

```
/deposit admin create <name>
```

{% endhint %}

<figure><img src="/files/z2AstabXzxGKcD30aJPf" alt=""><figcaption><p>Vista del menu de deposito</p></figcaption></figure>

***

## Estructura principal

```yaml
menu_default:
  title: "Deposit |Vault %vault_eco_balance% | PlayerPoints %playerpoints_points%"
  rows: 5
  deposit-slots: [20, 21, 22, 23, 24]
  layout:
    ...
  allowed-items:
    ...
  sounds:
    ...
```

<table><thead><tr><th width="197"></th><th>Descripción</th></tr></thead><tbody><tr><td><code>title</code></td><td>Título del Menu. Soporta <strong>MiniMessage</strong> y <strong>PlaceholderAPI</strong></td></tr><tr><td><code>rows</code></td><td>Filas del inventario. Mínimo <code>1</code>, Máximo <code>6</code></td></tr><tr><td><code>deposit-slots</code></td><td>Slots donde el jugador puede colocar items para depositar.</td></tr></tbody></table>

***

## Layout (Decoración)

El `layout` define los items decorativos del menú (bordes, fondos, iconos, etc.).

{% code expandable="true" %}

```yaml
  layout:
    example:
      material: BLACK_STAINED_GLASS_PANE
      name: " "
      slots: [9,10,11,12,13,14,15,16,17,18,19,25,26,27,28,29,30,31,32,33,34,35]

    #example_1:
    #  material: PLAYER_HEAD
    #  name: "<italic:false><#F7B334>%player_name%"
    #  slot: 8
    #  lore:
    #    - "<italic:false><#3b8bc1>Test test test"

    #example_2:
    #  material: BARRIER
    #  name: " "
    #  slot: 0
    #  model: 1
    #  hide-tooltip: true
    #  tooltip-style: "minecraft:diamond"

    #example_item_model:
    #  material: PAPER
    #  name: "<italic:false><gold>Item custom"
    #  slot: 0
    #  item-model: "namespace:items/example"
    #  hide-tooltip: true

    #example_commands:
    #  material: EMERALD
    #  name: "<italic:false><green>Recompensa diaria"
    #  slot: 4
    #  hide-tooltip: true
    #  commands:
    #    - "[console] eco give %player% 100"  # ejecutado por consola
    #    - "say Acaba de reclamar su recompensa" # ejecutado por el jugador
```

{% endcode %}

<table><thead><tr><th width="301"></th><th>Descripción</th></tr></thead><tbody><tr><td><code>material</code></td><td>Material vanilla del item</td></tr><tr><td><code>name</code></td><td>Soporta MiniMessage + PlaceholderAPI</td></tr><tr><td><code>lore</code></td><td>Soporta MiniMessage + PlaceholderAPI</td></tr><tr><td><code>slot</code></td><td>Un único slot (ej: <code>slot: 8</code>)</td></tr><tr><td><code>slots</code></td><td>Varios slots a la vez (ej: <code>slots: [0, 1, 2]</code>)</td></tr><tr><td><code>model</code></td><td>Custom Model Data</td></tr><tr><td><code>item-model</code></td><td>Namespace del item model (1.21.4+)<br><code>namespace:path</code></td></tr><tr><td>⭐ <code>tooltip-style</code></td><td>Tooltip personalizado vía resource pack (1.21.4+)<br><code>namespace:path</code></td></tr><tr><td>⭐ <code>hide-tooltip</code></td><td><code>true</code> oculta el tooltip al pasar el cursor (1.21.4+)</td></tr><tr><td><code>commands</code></td><td><code>[console]</code> Ejecutado por la consola (permisos de op)<br><code>Sin prefijo</code>  Ejecutado por el jugador (limitado a sus permisos)</td></tr></tbody></table>

***

## Allowed-items

Controla exactamente qué items se pueden depositar en cada menu.

```yaml
  allowed-items:
    - emerald
    - diamond_item_model
    - example_item_ce
    - example_item_ia
    - example_item_nexo
```

| Configuración       | Comportamiento                                       |
| ------------------- | ---------------------------------------------------- |
| `allowed-items: []` | Ningún item permitido — menú bloqueado               |
| Sin la sección      | Acepta **todos** los items definidos en `config.yml` |
| Con lista de ids    | Solo acepta los items listados                       |

{% hint style="info" %}
Puedes añadir items a esta lista sin editar el archivo manualmente usando:

```
/deposit admin setitem <id> <menu>
```

{% endhint %}

***

## Sonidos independientes

Cada menu puede tener sus **propios sonidos** o **heredar los globales** de `sounds.yml`.

```yaml
  sounds:
    sound-open:  "block.chest.open;1.0;1.0"
    sound-money: "ui.loom.select_pattern;1.0;1.0"
    sound-close: "block.chest.close;1.0;1.0"
    sound-error: "ui.button.click;0.7;0.5"
```

{% hint style="info" %}
Si no agregas esta sección, el menu hereda los **sonidos globales** automáticamente.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://victorrodasabarca.gitbook.io/cubixdesposit/configuracion/menus.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.