---
description: Guía para modificar los menús correctamente
---

# Modificar Menú

Apartados disponibles.

* [TITLE\_MENU](#title_menu)
* [SIZE](#size)
* [DECORATIONS](#decorations)
* [MATERIAL](#material)
* [DISPLAY\_NAME](#display_name)
* [ACTION\_TYPE](#action_type)
* [SOUND\_ON\_CLICK](#sound_on_click)
* [SLOT](#slot)
* [LORE](#lore)

{% hint style="info" %}
Todo lo que se mostrara a continuación sirve para todos los menús que contiene el plugin
{% endhint %}

## title\_menu

El título de menú es lo que se muestra en la parte superior izquierda del inventario. Podrás modificarlo a tu gusto.

<pre class="language-yaml" data-title="config.yml" data-line-numbers><code class="lang-yaml">Menu:
<strong> title_menu: '&#x26;bCustomJoin&#x26;fEvents &#x26;8| &#x26;7Main'
</strong></code></pre>

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2FP7utkAWLfIg7hxFxdq0A%2Ftitulo_menu.png?alt=media&#x26;token=6d7e8a17-1dea-4869-866e-4b666a96491b" alt=""><figcaption><p>Título del menú</p></figcaption></figure>

{% hint style="info" %}
El plugin admite los nuevos colores de Minecraft, pero para usarlos es necesario estar en una versión superior a la <mark style="color:blue;">`1.16`</mark>.

Si gustas saber como usar estos nuevos colores, da [clic aquí](../otros#usar-hex-color).
{% endhint %}

## size

El tamaño del menú es importante, dependiendo el valor que le coloques, será su tamaño. Aquí están los tamaños disponibles

Tamaños válidos: <mark style="color:blue;">`9,18, 27, 36, 45 y 54`</mark>

{% hint style="warning" %}
Es importante que coloques el valor correctamente para evitar errores con el plugin.
{% endhint %}

{% code title="config.yml" lineNumbers="true" %}
```yaml
Menu:
 title_menu: '&bCustomJoin&fEvents &8| &7Main'
 size: 45
```
{% endcode %}

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2Fg8BPLdUqfrlhIVClLorU%2Fsize.png?alt=media&#x26;token=241b3d5d-eebe-4fb7-b9c2-5c50562fa619" alt=""><figcaption><p>Tamaños del menú</p></figcaption></figure>

## decorations

La sección de decoración es para colocar gran variedad de ítems decorativos, el plugin cuenta con algunas decoraciones por defecto. Si quieres eliminar alguna de esas decoraciones, solo borra el apartado. Pero si quieres conservar el apartado y desactivar la decoración, solo busca el apartado <mark style="color:orange;">`enabled`</mark> y cambia su valor a <mark style="color:blue;">`false`</mark>. De esta manera, la decoración será desactivada pero conservando su configuración.

{% code title="config.yml" lineNumbers="true" %}
```yaml
Menu:
 decorations:
  title_menu: '&bCustomJoin&fEvents &8| &7Main'
  size: 45
  decorations:
   glass:
    material: 'GRAY_STAINED_GLASS_PANE'
    display_name: ' '
    enabled: true
   close:
    material: 'BARRIER'
    display_name: '&6&l✦ &cClose &6&l✦'
    enabled: true
    lore:
     - ''
     - '&6&l| &fClick to close this menu'
     - ''
```
{% endcode %}

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2FESqfumagjInNYk2Jt983%2Fdecorations.png?alt=media&#x26;token=3d25b50a-8b11-4c0c-965b-2d5b8e0a781c" alt=""><figcaption><p>Decoraciones</p></figcaption></figure>

{% hint style="info" %}
Lo que viene a continuación es para la sección de <mark style="color:purple;">`ítems`</mark> y <mark style="color:blue;">`decorations`</mark>.
{% endhint %}

## material

El material será el ítem que se muestre al usuario en el inventario de su respectivo menú. En esta sección puedes colocar materiales y hasta cabezas de jugadores personalizadas.&#x20;

Para colocar un ítem o cabeza de jugador personalizada hay <mark style="color:blue;">`3`</mark> maneras de hacerlo.

<mark style="color:blue;">**`1) Ítem normal`**</mark>

Para el ítem normal o material, debes de colocar el nombre del material en el apartado correspondiente que es `material`.

{% hint style="info" %}
Materiales de la versión 1.8+, da [clic aquí](https://helpch.at/docs/1.8/org/bukkit/Material.html).

Materiales de la versión 1.13+, da [clic aquí](https://helpch.at/docs/1.13/org/bukkit/Material.html).

Materiales de la versión 1.16+, da [clic aquí](https://helpch.at/docs/1.16.1/org/bukkit/Material.html).
{% endhint %}

{% hint style="danger" %}
Es superimportante que uses los nombres de los materiales correctamente, dependiendo la versión, puedes usar absolutamente nombre de las versiones superiores, pero materiales que existan en versiones inferiores.
{% endhint %}

{% tabs %}
{% tab title="Ejemplo 1" %}
{% code title="config.yml" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'FIREWORK_ROCKET'
```
{% endcode %}
{% endtab %}

{% tab title="Ejemplo 2" %}
{% code title="config.yml" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'COMPARATOR'
```
{% endcode %}
{% endtab %}

{% tab title="Ejemplo 3" %}
{% code title="config.yml4" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'NOTE_BLOCK'
```
{% endcode %}
{% endtab %}
{% endtabs %}

<mark style="color:blue;">**`2) Texturas`**</mark>

Para colocar texturas es algo más complicado de realizar, pero aquí te enseñaré como. Primero debes ir al siguiente link: [clic aquí](https://minecraft-heads.com/custom-heads). Seleccionarás la cabeza que más te agrade e irás al final de la página y buscaras el apartado <mark style="color:red;">`"Other"`</mark> y copiaras el valor que se encuentra en <mark style="color:green;">`value`</mark>.

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2FiO5aw7v52ah4mmMbUPz2%2Fimage.png?alt=media&#x26;token=89fd0c36-c71f-4dc3-90ee-d98249281f6f" alt=""><figcaption><p>Minecraft value</p></figcaption></figure>

Una vez hayas copiado el <mark style="color:purple;">`value`</mark> de la textura, lo pegarás en `material` seguido de la palabra <mark style="color:blue;">`TEXTURE-value`</mark>. Aquí hay algunos ejemplos.

{% tabs %}
{% tab title="Ejemplo 1" %}
{% code title="config.yml" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'TEXTURE-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDg5ODVmODI0MDVjY2FjOGY1YWUxYjlmNjAzMTQyNTYzYzBlNTFmNGI4NGE4ZTM5NThkNTNiOTkzZWNiMThkMyJ9fX0='
```
{% endcode %}
{% endtab %}

{% tab title="Ejemplo 2" %}
{% code title="config.yml" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'TEXTURE-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjRlOTQyNzNjNzI3YjFmMmM5Mzc2YjVjYWU0ZWQ5YTQ4ZDU4NTFiZDJhYjJmZDgzZDVmODFhNmU2YWZmMTkzZCJ9fX0='
```
{% endcode %}
{% endtab %}

{% tab title="Ejemplo 3" %}
{% code title="config.yml" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'TEXTURE-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWFmY2Y0NDNiNWI1MWI3MzUyNjg4OTY0ZGE0NmZkYjMzMGQwNTdjNDAzZGM4ZDJjNjdlM2M3MTY5YWRjNjM0NyJ9fX0='
```
{% endcode %}
{% endtab %}
{% endtabs %}

<mark style="color:blue;">**`3) Cabeza de jugador`**</mark>

Esto es igual a la textura, pero en aquí puedes poner el nombre de un jugador (premium) y este será reemplazado por la cabeza de dicho jugador. Para colocar la cabeza del jugador, debes de colocar en `material` lo siguiente <mark style="color:blue;">`PLAYER_HEAD-player_name`</mark>

{% tabs %}
{% tab title="Ejemplo 1" %}
{% code title="config.yml" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'PLAYER_HEAD-_ImJona'
```
{% endcode %}
{% endtab %}

{% tab title="Ejemplo 2" %}
{% code title="" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'PLAYER_HEAD-PzSoul_'
```
{% endcode %}
{% endtab %}
{% endtabs %}

## display\_name

Display\_name será el nombre que se le dará al ítem en el inventario, puedes elegir el nombre a tu gusto.&#x20;

{% code title="config.yml" lineNumbers="true" %}
```yaml
  Menu:
   items:
    settings:
     material: 'COMPARATOR'
     display_name: '&a&lTitle &e#2'
```
{% endcode %}

{% hint style="info" %}
También puedes usar colores de la nueva versión de Minecraft <mark style="color:blue;">`1.16`</mark> y versiones superiores. Para saber como utilizarlo, da [clic aquí](../otros#usar-rgb-hex-color).
{% endhint %}

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2FBLyojXUsOjqalLlhuKbM%2Fimage.png?alt=media&#x26;token=3bf8300d-1b16-4042-ad93-21a3ece8eb47" alt=""><figcaption><p>display_name</p></figcaption></figure>

## action\_type

Action\_type son las acciones que hace el ítem al ser cliqueado por el usuario, puedes elegir acciones ya predeterminadas.

**`Actions disponibles:`**

&#x20; <mark style="color:green;">`1) OPEN_MENU_<menú>`</mark>

&#x20; <mark style="color:green;">`2) CLOSE_MENU`</mark>

&#x20; <mark style="color:green;">`3) BACK_MENU_<menú>`</mark>

Actualmente, hay 6 menús disponibles.

&#x20; <mark style="color:yellow;">`1) MAIN`</mark>

&#x20; <mark style="color:yellow;">`2) FIREWORK`</mark>

&#x20; <mark style="color:yellow;">`3) SETTINGS`</mark>

&#x20; <mark style="color:yellow;">`4) SOUND`</mark>

&#x20; <mark style="color:yellow;">`5) MESSAGE`</mark>

&#x20; <mark style="color:yellow;">`6) TITLE`</mark>

{% hint style="warning" %}
Este apartado es solo para <mark style="color:blue;">`decorations`</mark>, no pasará nada si lo colocas en otro lugar.
{% endhint %}

{% code title="config.yml" lineNumbers="true" %}
```yaml
  message:
   material: 'PAPER'
   display_name: '&3Messages'
   action_type: 'OPEN_MENU_MESSAGE'
```
{% endcode %}

## sound\_on\_click

Este apartado solo viene agregado por defecto en <mark style="color:blue;">`decorations - "close"`</mark>. ¿Qué hace realmente? Bueno, ejecuta un sonido cuando un usuario da clic al ítem en cuestión. Puedes agregarlos en todos los apartados que usted guste.

{% hint style="warning" %}
Para saber como colocar los sonidos correctamente, da [clic aquí](../otros#uso-correcto-de-sonidos).
{% endhint %}

{% code title="config.yml" lineNumbers="true" %}
```yaml
Menu:
 items:
  close:
   material: 'BARRIER'
   display_name: '&cClose'
   sound_on_click: 'CHEST_CLOSE'
   enabled: true
   action_type: 'CLOSE_MENU'
```
{% endcode %}

## slot

Slot será el lugar donde se ubicara nuestro material dentro del inventario. Eres libre de elegir la posición que gustes.

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2FERBH51kfoboRqZJ5e3AV%2Fimage.png?alt=media&#x26;token=52c2a922-5971-4a40-a987-7e490c8699d9" alt=""><figcaption><p>Inventario slots</p></figcaption></figure>

En la imagen que se muestra se encuentran números en cada slot, debes elegir uno y escribirlo en tu apartado de <mark style="color:blue;">`slot`</mark> de tu evento. Pero te mostraré otras formas de colocar tu material en el inventario.

<mark style="color:orange;">**1) Slot nomal**</mark>&#x20;

La primera manera es la que se te menciono, seleccionas la posición en el inventario (número) y lo colocas en <mark style="color:purple;">`slot`</mark> y ya quedaría.

{% code title="config.yml" lineNumbers="true" %}
```yaml
Menu:
 items:
  close:
   material: 'BARRIER'
   display_name: '&cClose'
   sound_on_click: 'CHEST_CLOSE'
   enabled: true
   slot: 40
   action_type: 'CLOSE_MENU'
```
{% endcode %}

<mark style="color:orange;">**2) Lista**</mark>

En este podrás colocar múltiples posiciones de un material en el inventario, hacemos lo mismo que lo anterior mencionado. Seleccionamos las posiciones que deseamos y lo vamos colocando de la siguiente manera.

{% code title="config.yml" lineNumbers="true" %}
```yaml
Menu:
 decorations:
 items:
  glass_1:
   material: 'PINK_STAINED_GLASS_PANE'
   display_name: ' '
   enabled: true
   slot:
    - 0
    - 1
    - 7
    - 8
    - 9
    - 17
    - 27
    - 35
    - 36
    - 37
    - 43
    - 44
```
{% endcode %}

<mark style="color:orange;">**3) Todo**</mark>

Esto es más sencillo de lo que parece, si lo que quieres que se rellene los espacios vacíos de tu inventario, solo coloca <mark style="color:red;">`-1`</mark> en el apartado de <mark style="color:blue;">`slot`</mark> y automáticamente este será rellenado.

{% code title="config.yml" lineNumbers="true" %}
```yaml
Menu:
 decorations:
 items:
  glass:
   material: 'PINK_STAINED_GLASS_PANE'
   display_name: ' '
   enabled: true
   slot: -1
```
{% endcode %}

## lore

El lore es la información que se muestra de un material/item, sirve para especificar con más detalle ciertas cosas, esto es totalmente modificable en todos los inventarios.

{% code title="config.yml" lineNumbers="true" %}
```yaml
Menu:
 decorations:
 items:
  message:
   material: 'PAPER'
   display_name: '&3Messages'
   action_type: 'OPEN_MENU_MESSAGE'
   slot: 23
   lore:
    - ''
    - '&6&l| &fClick to open the messages menu'
    - ''
```
{% endcode %}

{% hint style="info" %}
Admite variables de [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) y también puedes usar colores de la versión 1.16 (solo si el servidor es 1.16, de lo contrario no funcionará), da [clic aquí](../otros#usar-hex-color) para saber como utilizar los colores.                                         &#x20;
{% endhint %}

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2FMmJjArb4KyZXzQgvThjK%2Flore.png?alt=media&#x26;token=052b0e01-395f-4991-997d-b524a9b6ab2f" alt=""><figcaption><p>Información de ítem</p></figcaption></figure>
