---
description: Guide to modify the menus correctly
---

# Modify Menu

Sections available.

* [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" %}
Everything that will be shown below is used for all the menus that the plugin contains
{% endhint %}

## title\_menu

The menu title is what is displayed at the top left of the inventory. You can modify it to your liking.

<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>Menu title</p></figcaption></figure>

{% hint style="info" %}
The plugin supports the new Minecraft colors, but to use them you need to be on a version higher than<mark style="color:blue;">`1.16`</mark>.

If you want to know how to use these new colors, [click here](../others#use-rgb-hex-color).
{% endhint %}

## size

The size of the menu is important, depending on the value that you place, it will be its size. Here are the sizes available

Valid sizes: <mark style="color:blue;">`9,18, 27, 36, 45 y 54`</mark>

{% hint style="warning" %}
It is important that you place the value correctly to avoid errors with the 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>Size menu</p></figcaption></figure>

## decorations

The decoration section is to place a variety of decorative items, the plugin has some decorations by default. If you want to remove any of those decorations, just delete the section. But if you want to keep the section and disable the decoration, just look for the <mark style="color:orange;">`enabled`</mark> section and change its value to <mark style="color:blue;">`false`</mark>. In this way, the decoration will be deactivated but keeping its configuration.

{% 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>decorations</p></figcaption></figure>

{% hint style="info" %}
What comes next is for the<mark style="color:purple;">`items`</mark>and<mark style="color:blue;">`decorations`</mark> section.
{% endhint %}

## material

The material will be the item that is shown to the user in the inventory of their respective menu. In this section you can place materials and even custom player heads.

To place an item or custom player head there are <mark style="color:blue;">`3`</mark> ways to do it.

<mark style="color:blue;">**`1) Normal item`**</mark>

For the normal or material item, you must place the name of the material in the corresponding section that is `material`.

{% hint style="info" %}
Materials of version 1.8+, [click here](https://helpch.at/docs/1.8/org/bukkit/Material.html).

Materials of version 1.13+, [click here](https://helpch.at/docs/1.13/org/bukkit/Material.html).

Materials of version 1.16+, [click here](https://helpch.at/docs/1.16.1/org/bukkit/Material.html).
{% endhint %}

{% hint style="danger" %}
It is super important that you use the names of the materials correctly, depending on the version, you can absolutely use the names of the higher versions, but materials that exist in lower versions.
{% endhint %}

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

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

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

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

To place textures is somewhat more complicated to do, but here I will show you how. First you must go to the following link: [click here](https://minecraft-heads.com/custom-heads). You will select the head that you like the most and you will go to the bottom of the page and look for the <mark style="color:red;">`"Other"`</mark> section and copy the value found in <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>

Once we have copied the texture <mark style="color:purple;">`value`</mark>, you will paste it into `material` followed by the word <mark style="color:blue;">`TEXTURE-value`</mark>. Here are some examples.

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

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

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

<mark style="color:blue;">**`3) Player head`**</mark>

This is the same as the texture, but here you can put a player's name (premium) and it will be replaced by that player's head. To place the player's head, you must place the following in `material` <mark style="color:blue;">`PLAYER_HEAD-player_name`</mark>

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

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

## display\_name

Display\_name will be the name that will be given to the item in the inventory, you can choose the name to your liking.

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

{% hint style="info" %}
You can also use colors from the new version of Minecraft <mark style="color:blue;">`1.16`</mark> and higher. To know how to use it, [click here](../others#use-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 are the actions that the item does when clicked by the user, you can choose already predetermined actions.

**`Actions available:`**

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

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

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

Currently, there are 6 menus available.

&#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" %}
This section is only for <mark style="color:blue;">`decorations`</mark>, nothing will happen if you place it elsewhere.
{% endhint %}

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

## sound\_on\_click

This section is only added by default in <mark style="color:blue;">`decorations - "close"`</mark>. What does it really do? Well, it plays a sound when a user clicks on the item in question. You can add them in all the sections that you like.

{% hint style="warning" %}
To know how to place the sounds correctly, [click here](../others#correct-use-of-sounds).
{% 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 will be the place where our material is located within the inventory. You are free to choose the position you like.

<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>Inventory slots</p></figcaption></figure>

In the image shown there are numbers in each slot, you must choose one and write it in your <mark style="color:blue;">`slot`</mark> section of your event. But I will show you other ways to place your material in the inventory.

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

The first way is the one that is mentioned to you, select the position in the inventory (number) and place it in the <mark style="color:purple;">`slot`</mark> and it would be left.

{% 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) List**</mark>

In this you can place multiple positions of a material in the inventory, we do the same as the above mentioned. We select the positions we want and we are placing it as follows.

{% 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) All**</mark>

This is easier than it seems, if you want the empty spaces in your inventory to be filled, just put <mark style="color:red;">`-1`</mark> in the <mark style="color:blue;">`slot`</mark> section and it will automatically be filled.

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

## lore

The lore is the information that is displayed on a material/item, it is used to specify certain things in more detail, this is fully modifiable in all inventories.

{% 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" %}
It supports [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) variables and you can also use colors from version 1.16 (only if the server is 1.16, otherwise it won't work), [click here](../others#use-rgb-hex-color) to know how to use colors.
{% 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>Item information</p></figcaption></figure>
