---
description: Guide to create new titles
---

# Create Titles

{% hint style="warning" %}
In this section we will only talk about <mark style="color:blue;">`title & subtitle`</mark>, we will not talk about the other sections, so if you want to know more, [click here](modify-menu).
{% endhint %}

## material\_no\_permission

This material will be displayed when a player does not have the necessary permission for the message. To learn more about the materials and how you should use them, [click here](../modify-menu#material).

{% code title="titles.yml" lineNumbers="true" %}
```yaml
Menu:
 material_no_permission: 'BARRIER'
```
{% endcode %}

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2FiNd8LVBC9eeny96rf5sN%2Fmaterial_no_permission.png?alt=media&#x26;token=8c4fd86e-568b-483b-8425-51e8a8e8f28c" alt=""><figcaption><p>No Permissions</p></figcaption></figure>

## create new title

Below you have the model to be able to copy and paste in your configuration file, it is important that you modify the name <mark style="color:blue;">`"key_name"`</mark> to avoid errors with the plugin.

{% code title="titles.yml" lineNumbers="true" %}
```yaml
  key_name:
   material: 'MATERIAL_NAME'
   display_name: 'TITLE_NAME'
   slot: 1
   lore:
    - 'Here enter the text you like'
    - 'Remember that you can also use variables from PlaceholderAPI'
    - 'and special variables of TITLES'
    - ''
   title: 'TITLE WITH COLOR CODE'
   subtitle: 'SUBTITLE WITH COLOR CODE'
   permission: 'PERMISSION'
```
{% endcode %}

## title & subtitle

These two sections are similar and therefore the configuration applies to both. Here you can modify and implement the text you like.

{% code title="titles.yml" lineNumbers="true" %}
```yaml
  key_name:
   title: '&a&lWelcome &f&l%player%'
   subtitle: '&7To server &cYour Server'
```
{% endcode %}

{% hint style="info" %}
You can use variables from [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) and variables from this event. You can also occupy colors of the new versions, only servers 1.16+, [click here](../others#use-rgb-hex-color).
{% endhint %}

## permission

This section is optional, if you want all users to be able to select this firework without permission, just put <mark style="color:blue;">`"none"`</mark>, it should be:

{% code title="titles.yml" lineNumbers="true" %}
```yaml
permission: 'none'
```
{% endcode %}

But if you like, you can place a permission, this so that only users with this permission can select it.

{% code title="titles.yml" lineNumbers="true" %}
```yaml
permission: 'customjoin.title_name'
```
{% endcode %}

## Titles Variables

Here are the variables that can be occupied solely in this event (lore), but you can also occupy PlaceholderAPI variables.

|          Variable          |                                                                                                                   Description                                                                                                                  |
| :------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|       `%titles_name%`      |       Shows the name of the title depending on the option you have <mark style="color:green;">`(key/display_name)`</mark>. Example: `title1` o <mark style="color:green;">**`Title`**</mark> <mark style="color:yellow;">**`#1`**</mark>       |
|      `%titles_title%`      |                                                     Shows the title that will be sent to the player when they log in. Example: <mark style="color:green;">**`Welcome`**</mark>**`_ImJona`**                                                    |
|     `%titles_subtitle%`    |                                                       Shows the title that will be sent to the player when they log in. Example: `To Server`<mark style="color:red;">`Your Server`</mark>                                                      |
|  `%titles_status_locked%`  | It shows the status of the title, if the user has the corresponding permission, the message that you configured in translations will appear. Example: <mark style="color:green;">`Unlocked`</mark> or <mark style="color:red;">`Locked`</mark> |
| `%titles_status_selected%` |        It shows the status of the title, if the user has it selected, the message that you configured in translations will appear. Example: <mark style="color:green;">`Selected`</mark> or <mark style="color:red;">`Unselected`</mark>       |
|         `%player%`         |                                                                                Shows the name of the player who is interacting with the menu. Example: `_ImJona`                                                                               |
