Magic Item Config

Mutual Configuration:

Option	Description	Type	Default
ignored-attributes	As defined here.	List
blacklisted-attributes	As defined here.	List
strict-enchants	Since 4.0 Beta 13. When false, enchantments other than those specified on the magic item no longer cause the match to fail.	Boolean	true
strict-enchant-level	Since 4.0 Beta 13. With false, items being matched require at least the level of enchantments specified on the magic item, rather than the exact level.	Boolean	true
strict-durability	Since 4.0 Beta 13. When false, the magic item requires at least the specified durability, instead of exactly the same amount.	Boolean	true
strict-block-data	Since 4.0 Beta 13. When false, the magic item uses BlockData#matches instead of strict equality.	Boolean	true

<option>:
    # This is where the options go.
    name: ". . ."
    lore:
        - line 1
        - line 2
        - . . .
    # . . .

---

Formats:

Further options depend on the format used:

• Vanilla Format
• Spigot's ItemStack Serialization Format
• MagicSpells Format

---

Vanilla Format:

Warning

Since 4.0 Beta 14.

To use this format, set type to external::vanilla.

Option	Description	Type
data	Data like it is passed to the /give command.	String
amount		Integer

---

Spigot's ItemStack Serialization Format:

This is the format Bukkit/Spigot uses to store item data in a configuration format. More info about this can be found here. You can generate Magic Items in this format from handheld items using the ItemSerializeSpell. This is useful in case you don't feel like configuring a matching configuration for an existing item (e.g. from another plugin) or if a specific item configuration is missing in other formats.

magic-items:
    <internal name>:
        type: "external::spigot"
        data:
            # This is where the options go.

---

MagicSpells Format:

When options specify a format, arguments indicated with angle brackets (<>) are required. Optional arguments are indicated with square brackets ([]); when specifying an optional argument, all arguments prior to it must be specified.

Option	Description	Type	Default
type	Material name, as listed here. As mentioned above, type can also be the the name of a different item-reading format.	String
name		Formatted Text
amount	The amount of the item.	Integer	1
lore		Formatted Text List
enchants	List of enchantment lines in the format: (enchantment) (level).	String List
custom-model-data	The item's custom model data.	Integer	0
hide-tooltip	Since 1.21 this does not work. We don't have an alternative yet. Hide extra item tooltip information.	Boolean	false
fake-glint	Applies a fake enchantment glint to the item if it has no enchantments.	Boolean	false
repair-cost	The item's repair cost.	Integer	0
unbreakable	Whether the item is unbreakable.	Boolean	false
attributes		Attributes
block-data	Block States key-value pairs, stored in square brackets list.	String

Items with Durability:

Option	Description
durability	The item's durability damage; items with full durability have a damage of 0.

magic-items:
    dull-blade:
        type: "stone_sword"
        name: "&8Dull Blade"
        durability: 20

Potions:

Option	Description	Type
potion-effects	A string list of status effects from. Format: <potion effect type> [level] [duration] [ambient] [particles] [icon]. Duration is in ticks (600 by default). A list of potion effect types can be found here.	List
Before 4.0 Beta 14: potion-color Since 4.0 Beta 14: color	Color (hex code) of the potion.	String
potion-data	Before 4.0 Beta 14. Potion type of the item. It may be followed up by extended or upgraded keywords.	String
potion-type	Since 4.0 Beta 14.	Potion type

magic-items:
    healing-potion:
        type: "splash_potion"
        name: "&#66ff00Healing Potion"
        potion-color: "66ff00"
        potion-effects:
            - "regeneration 1 100 false"
            - "instant_health 1 0"

Suspicious Stew:

Option	Description	Type
potion-effects	Potion effects of the stew. Format: <potion effect> [duration]. Duration is in ticks (600 by default). A list of effects can be found here.	List

magic-items:
    healing-stew:
        type: "suspicious_stew"
        name: "&aHealing Stew"
        potion-effects:
            - "regeneration 100"

Firework Stars:

Option	Description	Type	Default
firework-type	Type of the firework, as defined here.	String
trail	Should the firework have a trail?	Boolean	false
flicker	Should the firework flicker?	Boolean	false
colors	Colors (hex codes) of the firework, separated by a comma.	String
fade-colors	Fade colors (hex codes) of the firework, separated by a comma.	String

magic-items:
    sun-firework-star:
        type: "firework_star"
        name: "&eSun Firework Star"
        trail: true
        flicker: false
        colors: "FFE484, FFCC33, FC9601"
        fade-colors: "B72C3C, D14009"

Fireworks:

Option	Description	Type	Default
firework-effects	Firework effects of the rocket. Format: <type> <trail> <flicker> <colors> [fade-colors].	List
power	Power of the firework rocket (0 - 128).	Integer	0

magic-items:
    sun-firework:
        type: "firework_rocket"
        name: "&rFirework - &ESun"
        power: 2
        firework-effects:
            - "ball_large true false FFE484,FFCC33,FC9601 B72C3C,D14009"
            - "ball false false B72C3C,D14009"

Leather Armor:

Option	Description	Type
color	Color (hex code) of the leather armor.	String

magic-items:
    bloodied-vest:
        type: "leather_chestplate"
        name: "&#8A0303Bloodied Vest"
        color: "8A0303"

Skulls:

You can use this website to find these values from a username: https://mineskin.org/

Option	Description
skull-owner	The name of the skull's owner. Must be defined if uuid is not defined for texture to apply.
uuid	The UUID of the skull owner. Must be defined if skull-owner is not defined for texture to apply.
texture	The skull's texture.
signature	The signature for the skull's texture.

magic-items:
    jeb-head:
        type: "player_head"
        skull-owner: "jeb_"
        uuid: "853c80ef-3c37-49fd-aa49-938b674adae6"
        texture: "ewogICJ0aW1lc3RhbXAiIDogMTYxMzkzOTQ5NTg2NCwKICAicHJvZmlsZUlkIiA6ICI4NTNjODBlZjNjMzc0OWZkYWE0OTkzOGI2NzRhZGFlNiIsCiAgInByb2ZpbGVOYW1lIiA6ICJqZWJfIiwKICAic2lnbmF0dXJlUmVxdWlyZWQiIDogdHJ1ZSwKICAidGV4dHVyZXMiIDogewogICAgIlNLSU4iIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzdmZDliYTQyYTdjODFlZWVhMjJmMTUyNDI3MWFlODVhOGUwNDVjZTBhZjVhNmFlMTZjNjQwNmFlOTE3ZTY4YjUiCiAgICB9LAogICAgIkNBUEUiIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzU3ODZmZTk5YmUzNzdkZmI2ODU4ODU5ZjkyNmM0ZGJjOTk1NzUxZTkxY2VlMzczNDY4YzVmYmY0ODY1ZTcxNTEiCiAgICB9CiAgfQp9"
        signature: "XWHSTMXVrh2GWxJx8PX0kedO4t7SS6zpg7aTcslbo4WzKXufuE8DiO61sQm0LbQhMmrP9Zw9jCbkKtYtsruddC+jc5FYbHbpU9+dXLSJ2rWfAHRDbcw6IfrjyAEYPB3IyhoCPGaOitQrGoWIINvdYiipXbPOA3KuOBYdvsLSu30QTtVdujQ/RMCXrA6SIk1YeoVhsztjbWNnzevTe/C2WTSyVFYHNm618HudZbNM2qbDLwOMu0Ddzla+pf9roT3V0jZstStldIptZMOooIUmr57MfIZ6MQ8/76ZSBeaM/KDZu4w3VmyN18sTY+jDWzVm7onw+O3H3FRmJe0oWAofqoA3CoYH52YrkYSsCRo4CDojcX8SXv9DzsudAPnSL3gZ69LKP8VCqRY75TroclFMmptseS57yV9aJCAlFsccstveilefpCSUrVUoM8g/gzhuZwrQCBsVKlzVEQAcwvagxckHj2VqFHBrLoKrJDlG1ZFfHw9qMYvRkEnpHjlvV/CaVchWTeJ4MLt7xuGQM4CbldQELwl6ApwvWNvKLn3uPMJmyrAci3bZHIao9txXbRyn5M2EYMw1ftjDhAqrY982LkDK1WBcFgzTvzhlvBiLHbwLAjGUmdpBYKHfj2c4YPRz8wpnlvhwup81nDta90Lk+a6M1wXpj/V14FxNdWmypww="

Written Books:

Option	Description	Type
title	Book title.	Before 4.0 Beta 14: String Since 4.0 Beta 14: Formatted Text
author	Book author.	Before 4.0 Beta 14: String Since 4.0 Beta 14: Formatted Text
pages	A list of strings representing the pages of the book. Line breaks can be represented with \n, <br>, or <newline>. Supports multi-line strings, a built-in feature of YAML, as mentioned here).	Formatted Text List

magic-items:
    rule-book:
        type: "written_book"
        title: "&4Rule Book"
        author: "&cAdmin"
        pages:
          - "Read the rules, they are important."
          - "This is page two. It has more rules on it."
          - |
            This is page three.
            It has multiple lines.

            Here's another line.

Banners:

Option	Description
patterns	A list of strings representing banner patterns - (pattern) (color).

magic-items:
    pillager-banner:
        type: "white_banner"
        patterns:
            - "rhombus_middle cyan"
            - "stripe_bottom light_gray"
            - "stripe_center gray"
            - "stripe_middle black"
            - "half_horizontal light_gray"
            - "circle_middle light_gray"
            - "border black"
    pillager-banner-short:
        type: "white_banner"
        patterns:
            - "mr cyan"
            - "bs light_gray"
            - "cs gray"
            - "ms black"
            - "hh light_gray"
            - "mc light_gray"
            - "bo black"