Wikis / MythicEnchants / Enchants / Custom Enchantments

Custom Enchantments

File Locations

The primary location custom enchantments are stored is in the /plugins/MythicMobs/enchantments/ folder. Enchantments may also be organized into and loaded from the ../enchantments/ folder of any Mythic Pack.

A typical custom enchantment might be located in /plugins/MythicMobs/enchantments/holy_shine.yml.
Enchantment files may include multiple enchantments, such as /plugins/MythicMobs/enchantments/lunar.yml containing the lunar_blessing and lunar_light enchantments.
A Mythic Pack location might be /plugins/MythicMobs/packs/lemons_enchants/enchantments/sour_strike.yml, featuring the sour_strike enchantment from the "Lemon's Enchants" pack.

Enchantment Elements

General Settings

Internal Name

❗️Required. The internal string identifier for the enchantment. Must be a unique name using valid characters and no spaces. Only visible in configurations.

example_enchant:

The enchant-id placeholder returns this value in enchantment skills.

Display Name

The visible name of the enchantment, shown in rich text locations.

example_enchant:
  Display: "<yellow>Example Enchant"

The enchant-name placeholder returns this value, including its colors and formatting, in enchantment skills.

Description

An optional description for the enchantment. Used for informational purposes.

example_enchant:
  Display: "<yellow>Example Enchant"
  Description: "Heals the player on attack."

Min Level

The minimum level the enchantment starts at. Defaults to 1.

example_enchant:
  Display: "<yellow>Example Enchant"
  MinLevel: 1

Max Level

❗️Required. The maximum level the enchantment is permitted to reach. Must be a whole number between 1 and 255.

example_enchant:
  Display: "<yellow>Example Enchant"
  MaxLevel: 5

The enchant-maxlevel placeholder returns this integer in enchantment skills.

Rarity

The rarity tier assigned to the enchantment. Creates groupings beyond weight, such as being able to roll a "RARE" enchantment specifically.
Rarities are defined in a Rarities file.

example_enchant:
  Display: "<yellow>Example Enchant"
  Rarity: UNCOMMON

The enchant-rarity placeholder returns this value in enchantment skills.

Anvil Cost

The experience cost associated with the enchantment during anvil operations.
Half of this value is used for operations on an enchanted book. This cost is multiplied by the enchantment's level.

example_enchant:
  Display: "<yellow>Example Enchant"
  AnvilCost: 3

Tags

The enchantment tags assigned to the enchantment. Configures many behaviors such as loot table inclusion, exclusivity groups, and more.

example_enchant:
  Display: "<yellow>Example Enchant"
  Tags:
    - minecraft:on_random_loot  # appears in general vanilla chest/mob loot
    - special_group             # example custom tag for grouping

Unlike other config areas, tags do not require the #minecraft:tag syntax — this field takes plain tag name inputs.

Conflicting Enchantments

Enchantments considered mutually exclusive with this enchantment. Accepts all lowercase enchantment IDs or enchantment tags. Must include namespace in enchantment ID.

example_enchant:
  Display: "<yellow>Example Enchant"
  ConflictingEnchants:
    - '#minecraft:exclusive_set/damage'
    - minecraft:mending

Options

A configuration section for behavioral flags.

Option Default Description
Enabled true Enables or disables the enchantment entirely
Cursed false Applies the #minecraft:curse tag — red name, prevents removal
Treasure false Applies the #minecraft:treasure tag
RandomLoot true Whether this enchantment can appear in random loot
Tradeable true Whether this enchantment can be traded by villagers
TradedEquipment true Whether this enchantment can appear on villager-traded equipment
MobSpawnEquipment true Whether this enchantment can appear on mob spawn equipment
PVP (unset) Override PVP behavior for this enchantment's skills
StrictMythicItems false Restrict application to only the exact Mythic items listed in PrimaryItems (see Primary Items) 
example_enchant:
  Display: "<yellow>Example Enchant"
  Options:
    Enabled: true
    Cursed: false
    Treasure: false
    RandomLoot: true
    Tradeable: true
    StrictMythicItems: false

Valid Slots

❗️Required. The equipped slot(s) the enchantment takes effect in..

example_enchant:
  Display: "<yellow>Example Enchant"
  ValidSlots:
    - MAINHAND
    - OFF_HAND

Supported Items

❗️Required. The item tag defining which items this enchantment can be applied to. Accepts a datapack item tag reference.

example_enchant:
  Display: "<yellow>Example Enchant"
  SupportedItems: '#minecraft:swords'

Enchantments missing this field will fail to load.

Primary Items

The specific item material IDs or item tags that are the preferred items for this enchantment. Shown first in the enchanting table UI.
Also accepts mythic:ID entries to reference MythicMobs/Crucible items by their internal ID.

example_enchant:
  Display: "<yellow>Example Enchant"
  PrimaryItems:
    - '#minecraft:swords'
    - minecraft:diamond_axe
    - minecraft:netherite_axe
    - mythic:MY_MYTHIC_ITEM_ID

mythic: entries are stored separately and enforced at runtime — datapacks match by material only and cannot distinguish Mythic items from plain ones of the same type.
To restrict the enchantment exclusively to the listed Mythic items (blocking plain items of the same material), set Options.StrictMythicItems: true.

Enchanting

Configure the enchanting weight and table behaviors of the enchantment.

example_enchant:
  Display: "<yellow>Example Enchant"
  Enchanting:
    Weight: 10
    MinCost: 15
    MaxCost: 50
    Promised: true
    BookOffer: true
    Reagent:
      - LAPIS_LAZULI
    Conditions:
      - outside

Attributes

A declarative shorthand for applying attribute modifiers via synthetic skill lines, without writing full skill syntax. See Attributes.

example_enchant:
  Display: "<yellow>Example Enchant"
  Attributes:
    MainHand:
      - ATTACK_DAMAGE 2

MythicStats

A declarative shorthand for applying MythicMobs stat modifiers via synthetic skill lines, without writing full skill syntax. See MythicStats.

example_enchant:
  Display: "<yellow>Example Enchant"
  Stats:
    - POWER 10
    - CRITICAL_STRIKE_CHANCE 5 ADDITIVE
    - ATTACK_DAMAGE <math:enchant_level*2>

Skills

The primary action section of your enchantment, using the Mythic Skill System to define what the enchantment does and when.

example_enchant:
  Display: "<yellow>Example Enchant"
  Skills:
    - heal{a=0.5*<skill.var.enchant-level>;cooldown=5} @self ~onAttack

Examples

📝 CONFIG.YML SNIPPET

Updated Aug 19, 2026