> For the complete documentation index, see [llms.txt](https://wiki.valhelsia.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.valhelsia.net/external-mods/forbidden-and-arcanus/wiki/datapack-guide/item-modifiers.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://wiki.valhelsia.net/external-mods/forbidden-and-arcanus/wiki/datapack-guide/item-modifiers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.