# Basic

## `enabled`

```yaml
enabled: true
```

With this setting you can disable an item completely.

{% hint style="warning" %}
Items won't be deleted from the world or inventories if you disable them.
{% endhint %}

## `name`

```yaml
name: "Test"
```

Item name shown in the tooltip.

{% hint style="warning" %}
ItemsAdder 4.0.8 and lower use the `display_name` property instead.
{% endhint %}

## `permission_suffix`

```yaml
permission_suffix: myitem
```

This property is used to identify if a user has permission to see an item in the `/ia` GUI.\
For example the full permission will be `ia.user.ia.seeitem.myitem`.

For now this is the only use of this permission.

{% content-ref url="/pages/-M3q-MfRaqsjqG\_hjxa2" %}
[Permission](/adding-content/items/item-properties/permission.md)
{% endcontent-ref %}

## `lore`

```yaml
lore:
- '&7When you mine a block'
- '&7it drops exp orbs'
- '&750% of times.'
```

Lore lines of the item.

## `enchants`

```yaml
enchants:
  - ARROW_FIRE:1
  - anger_artifact:1
  - my_custom_plugin:custom_enchant:6
```

Enchants of the item.\
You can set [vanilla enchants](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html) and custom enchants of other plugins (for example [EcoEnchants](/compatibility-with-other-plugins/compatible/ecoenchants.md), [ExcellentEnchants](https://www.spigotmc.org/resources/goldenenchants-%E2%80%A2-more-vanilla-like-enchantments-1-14-1-16.61693/)...).\
Supports also **namespaces** (if you are creating custom enchants using Namespaced keys).

## `glint`

Set visibility of enchantment glint on item.

```yaml
glint: false
```

## `attribute_modifiers`

```yaml
attribute_modifiers:
  mainhand:
    attackDamage: 19
    attackSpeed: 1.1
    maxHealth: 1.1
    movementSpeed: -1
    armor: 1.1
    armorToughness: 1.1
    attackKnockback: 1.1
    luck: 1.1
  offhand:
    attackDamage: 19
    attackSpeed: 1.1
    maxHealth: 1.1
    movementSpeed: 1.1
    armor: 1.1
    armorToughness: 1.1
    attackKnockback: 1.1
    luck: 1.1
```

These are the vanilla attribute modifiers, you can get more info here: <https://minecraft.wiki/w/Attribute>

## `durability`

```yaml
durability:
  max_durability: 200
  durability: 32
  disappear_when_broken: false
  unbreakable: false
  usages: 5
```

`usages` : Number of usages for the current item. Remember to decrement it using [events](/adding-content/items/item-properties/events.md).

`durability` : Initial durability which the item has (if not specified is the same as `max_durability`).

`max_durability` : Max durability of the item.

## `max_stack_size`

Sets the max amount of items allowed to be merged. Default value is inherited by the vanilla material.

## `item_flags`

```yaml
item_flags:
  - HIDE_ATTRIBUTES
  - HIDE_DESTROYS
  - HIDE_ENCHANTS
  - HIDE_PLACED_ON
  - HIDE_POTION_EFFECTS
  - HIDE_UNBREAKABLE
```

Special item flags that can hide some vanilla info of the item.\
You can find a detailed info list here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/ItemFlag.html>

{% hint style="info" %}
This option is old and might not working as it did on previous game versions due to changes in Minecraft 1.20.4.
{% endhint %}

## `blocked_enchants`

Disables enchants for this item.

{% tabs %}
{% tab title="Disable some enchants" %}

```yaml
blocked_enchants:
- DAMAGE_UNDEAD
- DAMAGE_ALL
- DAMAGE_ARTHROPODS
- KNOCKBACK
- DURABILITY
- SWEEPING_EDGE
```

{% endtab %}

{% tab title="Disable all enchants" %}

```yaml
blocked_enchants:
- ALL
```

{% endtab %}
{% endtabs %}

## `events_needed_player_stats`

Special attribute to make events work only if the player stat (ItemsAdder player stat, which are usually shown in HUDs) satisfies the set rule. You can set it to `>`, `<` ad `=`.

Example: [magic wand example item](/adding-content/items/other-items-examples/magic-wand.md).

## `glow`

You can make an item glowing when dropped on the ground.\
Very useful for **rare items**.

{% hint style="warning" %}
Available on ItemsAdder 4.0.9 or greater.
{% endhint %}

![](/files/-MkD1y3qn7E-mr-jc92Z)

```yaml
items:
  glowing_item:
    display_name: Glowing Item
    resource:
      material: DIAMOND
      generate: true
      textures:
      - item/glowing_item.png
    drop:
      glow:
        enabled: true
        color: DARK_RED
```

## `show_name`

You can make a drop show its name.\
Very useful for **rare items**.

![](/files/-MkH2Zy_yLFofa9uhFSV)

```yaml
  glowing_item:
    display_name: Glowing Item
    resource:
      material: DIAMOND
      generate: true
      textures:
      - item/glowing_item.png
    drop:
      show_name: true
```

## `template` and `variant_of`

{% content-ref url="/pages/-Mbqt6ZkkKyQm6vUDzn6" %}
[Templates and variants](/adding-content/items/item-properties/templates-and-variants.md)
{% endcontent-ref %}

## Use the official files editor to read all the properties

{% content-ref url="<https://github.com/LoneDev6/Wiki-ItemsAdder/blob/master/adding-content/beginners/files-editor.md>" %}
<https://github.com/LoneDev6/Wiki-ItemsAdder/blob/master/adding-content/beginners/files-editor.md>
{% endcontent-ref %}


---

# 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://itemsadder.devs.beer/adding-content/items/item-properties/basic.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.