# Options & Configurations

**DeluxeMenus** is a highly customizable plugin, it has many options and configurations to give you the ability to change everything you want to make your custom menus that fits your server's layout.\
It has **GUI** options to manage the GUI menu, and **Item** options to manage every single item on the GUI menu.

## Useful links

* [Placeholders](https://helpch.at/placeholders)
* Materials
  * [1.8.8](https://helpch.at/docs/1.8.8/org/bukkit/Material.html)
  * [1.12.2](https://helpch.at/docs/1.12.2/org/bukkit/Material.html)
  * [1.13.2](https://helpch.at/docs/1.13.2/org/bukkit/Material.html)
  * [1.14.4](https://helpch.at/docs/1.14.4/org/bukkit/Material.html)
  * [Latest](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
* [Enchantments](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html) (Be aware that some enchantments are not available on some items.)
* [Dye Colors](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/DyeColor.html)
* [Pattern Types](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/banner/PatternType.html)
* [Sound Types](https://gist.github.com/Andre601/1ab3b4fabd0010ae241156333491c379)

## Values keywords

| Keyword        | Description                                                                                                                                                                                                                      |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **BOOLEAN**    | Replace this with `true` or `false` (If used with a PlaceholderAPI placeholder, this will be `yes` or `no` instead of `true`/`false` \[It's changeable from PlaceholderAPI config file, but `yes`/`no` are the default values]). |
| **TEXT**       | Replace this with any text. Check the description to find out if you can use color/formatting codes.                                                                                                                             |
| **#**          | Replace this with a number. Check the description to see if there are limits.                                                                                                                                                    |
| **COMMAND**    | Replace this with a command without slash (`/`).                                                                                                                                                                                 |
| **SOUND**      | Replace this with a sound name.                                                                                                                                                                                                  |
| **EXPRESSION** | Replace this with a java/placeholder expression/comparison. See [this](https://wiki.helpch.at/helpchat-plugins/deluxemenus/options-and-configurations/requirements) page for more information.                                   |

## RGB/Hex

If you want to use RGB/Hex colors in DeluxeMenus on 1.16+ you can use the following format: "\&#aaFF00"

## Placeholders

There is one available placeholder from DeluxeMenus:

* `%deluxemenus_meta_<key>_<dataType>_[default_value]%` - Returns the meta value that is saved with the specified key and type. If no value is saved with the given key and type, the default value is returned. If no default value is specified, an empty value is returned.
* `%deluxemenus_meta_has_value_<key>_[dataType]%` - Returns yes/no response. Checks if there is a value with the given key. It also checks the type if specified.
* `%deluxemenus_opened_menu%` - Returns the ID of the menu that the player currently has open
* `%deluxemenus_is_in_menu%` - Returns yes/no if a user has a menu opened
* `%deluxemenus_last_menu%` - Returns the ID of the previous menu the player had opened

## General plugin options

### Debug

> ```yaml
> debug: STRING
> ```
>
> > **Default value:** `HIGHEST`\
> > **Available values:**\
> > `LOWEST`, `LOW`, `MEDIUM`, `HIGH`, `HIGHEST`

Determines which debug messages are going to be shown in console based on their importance.

`HIGHEST` LEVEL = only debug messages with highest priority are shown\
`LOWEST` LEVEL = all debug messages are shown\
[Stacktraces](https://rollbar.com/blog/java-stack-trace) are only displayed when the debug level is set to MEDIUM, HIGH or HIGHEST.

### Check updates

> ```yaml
> check_updates: BOOLEAN
> ```
>
> > **Default value:** `true`

Enables/Disables checking new updates for the plugin.\
Notifies any operator if there is an update available.


---

# 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://wiki.helpch.at/helpchat-plugins/deluxemenus/options-and-configurations.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.