The item mods module allows modification of all items present on a map or created during the match. This can be used, for example, to make all gold swords unbreakable or give all items of a specific type a custom name.
| Element | Description | |
|---|---|---|
<item-mods> </item-mods>
|
The item mods node, containing all the individual modification rules. | |
| Sub-elements | Value/Children | |
<rule> </rule>
|
A single item modification rule. | Rule Sub-Elements |
| Element | Description | Value/Children |
|---|---|---|
<match> </match>
|
Required Unique The material or materials to modify. | Match Sub-Elements |
<modify> </modify>
|
Required Unique The attributes to modify on the specified material(s). | Item Meta |
| Element | Description | Value/Children |
|---|---|---|
<material> </material>
|
An individual material to match. | Single Material Pattern |
<all-materials/>
|
Match all materials. | |
<all-blocks/>
|
Match all block type materials. |
Examples
<item-mods>
<rule>
<match>
<material>Iron Sword</material>
</match>
<modify unbreakable="true">
<enchantment level="1">Knockback</enchantment>
</modify>
</rule>
</item-mods>
<item-mods>
<rule>
<match>
<material>Bow</material>
</match>
<modify show-enchantments="false" unbreakable="true">
<enchantment level="2">Infinity</enchantment>
</modify>
</rule>
</item-mods>
The following attributes and sub-elements can be used with the <modify> element to modify an item or block.
While these are the same attributes as used in item kits
the modify element does not currently support the projectile or grenade attributes.
| Element | Description | Value |
|---|---|---|
<enchantment> </enchantment>
|
This item's enchantments. | Enchantments |
<effect> </effect>
|
A custom potion effect, only applies for potion items. | Potion Effect |
<attribute> </attribute>
|
Custom attributes for this item. | Attribute Modifiers |
<can-destroy> </can-destroy>
|
The materials that can be mined with the item. | Can Destroy |
<can-place-on> </can-place-on>
|
Materials that the item can be placed on. | Can Place On |
| Attribute | Description | Value | Default |
|---|---|---|---|
name
|
The item's display name. | String | |
lore
|
Custom lore string. | String | |
unbreakable
|
Specify if this item is unbreakable, hides the durability bar in minecraft. | true/false | false |
color
|
Leather armor color as a hexadecimal color. RRGGBB
Only applies to leather armor items. |
Hex Color | |
potion
|
Potion type
Only applies to potion items. |
Potion ID | |
show-enchantments
|
Show enchantments in the item tooltip. | true/false | true |
show-attributes
|
Show attribute modifiers in the item tooltip. | true/false | true |
show-unbreakable
|
Show the unbreakable property in the item tooltip. | true/false | true |
show-can-destroy
|
Show the breakable block list in the item tooltip. | true/false | true |
show-can-place-on
|
Show the blocks the item can be placed on in the item tooltip. | true/false | true |
show-other
|
Show various other things in the item tooltip. | true/false | true |