# Item Modifiers

Item Modifiers add special abilities to your tools.\
\
Item Modifiers can be configured using JSON files within a data pack in the path `data/<namespace>/forbidden_arcanus/item_modifier`.

{% hint style="warning" %}
Currently, the modifier effects are hardcoded and cannot be changed through data packs.
{% endhint %}

| Name                        | Description                                                                  | Value                                                          | Required |
| --------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------- | -------- |
| `predicate`                 | Determines which item the modifier can be applied to.                        | An item predicate.                                             | true     |
| `incompatible_items`        | An additional item filter for the predicate.                                 | An item, a list of items, or an item tag.                      | false    |
| `incompatible_enchantments` | Determines which enchantments are incompatible with this modifier.           | An enchantment, a list of enchantments, or an enchantment tag. | false    |
| `components_to_remove`      | These data components get removed from the item after applying the modifier. | One data component or a list of data components.               | false    |
| `display`                   | Everything related to the representation of the modifier.                    | A [Display Settings](#display-settings) object.                | true     |

### Example JSON

The following code is used to create the Eternal item modifier.

{% code lineNumbers="true" %}

```json
{
  "components_to_remove": [
    "minecraft:damage",
    "minecraft:max_damage"
  ],
  "display": {
    "name": {
      "translate": "modifier.forbidden_arcanus.eternal"
    },
    "texture": "forbidden_arcanus:textures/gui/tooltip/eternal.png",
    "tooltip_color": {
      "end": -13551304,
      "start": -5589601
    }
  },
  "incompatible_enchantments": "#forbidden_arcanus:modifier/eternal_incompatible",
  "incompatible_items": "#forbidden_arcanus:modifier/eternal_incompatible",
  "predicate": {
    "predicates": {
      "valhelsia_core:all_of": {
        "valhelsia_core:has_component": [
          "minecraft:max_damage",
          "minecraft:damage"
        ]
      }
    }
  }
}
```

{% endcode %}

### Display Settings

| Name            | Description                                     | Value                                                                   | Required |
| --------------- | ----------------------------------------------- | ----------------------------------------------------------------------- | -------- |
| `name`          | The prefix that gets added to the item.         | A [JSON text component](https://minecraft.wiki/w/Raw_JSON_text_format). | true     |
| `texture`       | The texture for the custom tooltip decorations. | A valid resource location.                                              | true     |
| `tooltip_color` | The colors for the custom tooltip border.       | A pair consisting of two int values: `start` and `end`.                 | true     |


---

# 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.valhelsia.net/external-mods/forbidden-and-arcanus/wiki/datapack-guide/item-modifiers.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.