# Settings

Settings are enchant specific toggles where you can define special things

{% hint style="info" %}
Settings are for that enchant only, letting you have different settings for each and every enchant
{% endhint %}

```
superspeed:
  display: '%group-color%Super Speed'
  description: 'Gives super speed'
  applies-to: 'Boots'
  type: 'EFFECT_STATIC'
  group: 'RARE'
  applies:
    - ALL_BOOTS
  settings:
    required-enchants:
      - 'speed:3'
      - 'strongboots'
    not-applyable-with:
      - 'highjump'
      - 'superhighjump'
    removed-enchants:
      - 'speed'
    removeable: true
    disable-in-enchanter: true
    disabled-worlds:
      - 'parkour'
      - 'parkour2'
    showActionBar: true
  levels:
    1:
      effects:
        - 'POTION:SPEED:3'
```

### **required-enchants**

* Here you can list enchantments that are needed to be already on the item before this enchant can be added on
* You can have multiple required enchants
* You can put a :\<number> after the name to require a specific level, otherwise any level will count\
  Example: `- 'gears:10'`

### **not-applyable-with**

* A list of enchants that if are already on the item, this enchant can't be added to it
* You can have multiple incompatible enchants

### **removed-enchants**

* A list of enchants that will be automatically removed when this enchant is added onto the item

{% hint style="info" %}
Pair this with `require-enchants` to make a higher enchant rarity for an enchant
{% endhint %}

### **removeable**

* Accepts `true` or `false`
* Makes enchantment non-removeable with blackscrolls

### **disable-in-enchanter**

* Accepts `true` or `false`
* Makes enchantment not obtainable from Enchanter

### **disabled-worlds**

* A list of worlds which the enchantment will not activate

{% hint style="warning" %}
`disabled-worlds` is cAsE sEnSiTiVe
{% endhint %}

### **showActionBar**

* Whether this enchantment should be showedcased in player's action bar upon activation, example gif: <https://i.imgur.com/F68eOm1.gif>
* It has a hard-coded 1s cooldown to prevent spam showcases


---

# 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://ae.advancedplugins.net/enchantments/creating-enchantments/settings.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.