> For the complete documentation index, see [llms.txt](https://wiki.darrionatplugins.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.darrionatplugins.com/plugins/custom-enchants+/guis.md).

# GUIs

## Custom GUI

A custom GUI, graphical user interface, is a feature within that gives players a unique way of enchanting. GUI's can be opened up by [Custom Blocks](/plugins/custom-enchants+/custom-blocks.md) or with [commands](/plugins/custom-enchants+/commands-and-permissions.md). Each GUI is animated, in the terms of items  moving around within the GUI while the player is interacting with it. 

### Enchanter

<div align="left"><img src="/files/-M6jGT4EbJuKPKzQLXYx" alt="GIF of the Enchanter GUI"></div>

As first GUI to be introduced to Custom Enchants+, it is definitely also the most important. The Enchanter is to be used to add [Enchantments](/plugins/custom-enchants+/enchants.md). The Enchanter will refuse items with no remaining slots. The Enchanter will also refuse items types that are not able to be enchanted.&#x20;

#### Upgrading Existing Enchantments

The Enchanter has a chance to increase an item's already-existing enchantments when enchanting. The default percentage is 50%. This percentage can be configured within the [config.yml](/plugins/custom-enchants+/configuration-files/config.yml.md). Every successful upgrade will roll a chance for an upgrade again. So by default: one upgrade is a 50% chance, two upgrades  is a 25% chance, three upgrades is a 12.5% chance, and so on.

### Tinkerer

<div align="left"><img src="/files/-M6jV1F7JwZb67RaJEIl" alt="GIF of the Tinkerer GUI"></div>

The Tinkerer is a unique GUI that allows a player to remove their custom enchantments in return for EXP. The given is experience is determined by [`used_slots`](/plugins/custom-enchants+/enchants.md#slots)`* enchantExpCost`. enchantExpCost is defined within the config.yml.

#### Obtaining Scrolls

[Scrolls](/plugins/custom-enchants+/scrolls.md) can be obtained from tinkering. By default, each scroll has a 5% chance from tinkering, this percentage can be configured in the config.yml.

### Anvil

<div align="left"><img src="/files/-M6jVN9k3ldnpWhod31b" alt="GIF of the Anvil GUI"></div>

The Anvil GUI allows a player to forge two items together. At least one item must contain a custom enchantment to be utilized. The Anvil does support Vanilla enchantments. Forging two items costs the player experience. The total amount of experience is calculated by `the total amount of enchantments * forgeExpPerEnchantment`. Forging does not increase the max number of slots on either item. Books may be used within the Anvil GUI.

### Selector

<div align="left"><img src="/files/-M6jdEZSpxaWzZyd-W7t" alt=""></div>

<div align="left"><img src="/files/-M6jd9LkxFGa1Gh9dnbD" alt=""></div>

The Selector GUI is displayed when a player activates either the [Enchantment Upgrade Scroll](/plugins/custom-enchants+/scrolls.md#enchantment-upgrade) or the [Enchantment Removal Scroll](/plugins/custom-enchants+/scrolls.md#enchantment-removal). It allows the user to select an enchantment for the scroll to perform its action.