# 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.


---

# 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.darrionatplugins.com/plugins/custom-enchants+/guis.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.