MythicEnchantsSkript — Syntax Reference

Skript addon for MythicEnchants. Requires Skript 2.15+ and MythicEnchants 5.12+ on Paper 1.21+. Addon version 1.3.0.

Types

Events

Of the six events, four are cancellable via Skript's built-in cancel event: enchant apply, enchant remove, prepare enchant, and skill trigger. The two newest event bridges — anvil prepare and trigger fire — are not cancellable; the anvil-prepare event is instead "overridden" by setting mench anvil result (see below).

On Mythic Enchantment Apply

Fires when enchantments are applied to an item via enchanting table or anvil. Cancellable.

[mythic[al]] enchant[ment] apply
mench enchant[ment] apply

Event values: player, item (ItemStack)

Event-only expressions:

• mench apply source — "TABLE" or "ANVIL"
• mench event slot — equipment slot name (e.g. "HAND") (shared with the remove event)

Example:

on mythic enchantment apply:
    if mench apply source is "TABLE":
        send "You enchanted %event-item% at the table!" to player

On Mythic Enchantment Remove

Fires when enchantments are removed from an item via grindstone or anvil. Cancellable.

[mythic[al]] enchant[ment] remove
mench enchant[ment] remove

Event values: player, item (ItemStack)

Event-only expressions:

• mench remove source — "GRINDSTONE" or "ANVIL"
• mench event slot — equipment slot name (shared with the apply event)

Example:

on mythic enchantment remove:
    if mench remove source is "GRINDSTONE":
        send "Enchantments stripped!" to player

On Mythic Enchantment Skill Trigger

Fires before MythicEnchants dispatches an enchantment's skills. One event fires per (enchantment, trigger) pair. Cancellable — cancelling suppresses that enchantment's skill dispatch only.

[mythic[al]] enchant[ment] skill trigger
mench skill trigger

Event values: player, item (ItemStack), entity (target, nullable), menchenchantment (the definition)

Event-only expressions:

• mench trigger name — uppercase trigger name (e.g. "ATTACK", "EQUIP", "TIMER") (shared with trigger fire)
• mench trigger level — enchantment level on the item (skill trigger only)
• mench trigger damage — final damage value, 0 if not a damage trigger (shared with trigger fire)
• mench trigger item attack — base item attack value, 0 if not an attack trigger (shared with trigger fire)
• mench trigger slot — equipment slot name (e.g. "HAND", "CHEST") (shared with trigger fire)

Example:

on mythic enchantment skill trigger:
    if mench trigger name is "ATTACK":
        if mench trigger damage > 20:
            send "Massive hit with %mench id of event-menchenchantment% level %mench trigger level%!" to player
    if mench trigger slot is "CHEST":
        cancel event  # suppress all chest-slot enchant skills

On Mythic Prepare Enchantment

Fires after MythicEnchants computes the three enchanting table offers but before they are shown to the player. Only fires when the custom enchanting table is enabled. Cancellable — cancelling leaves the vanilla offers untouched.

[mythic[al]] prepare enchant[ment]
mench prepare enchant[ment]

Event values: player, item (ItemStack)

Event-only expressions:

• mench table power — computed table power (typically 0–15, can exceed with custom configs)
• mench reagent key — normalised reagent key (e.g. "minecraft:lapis_lazuli", "crucible:moondust")

Example:

on mythic prepare enchantment:
    if mench reagent key is "crucible:moondust":
        send "Special reagent detected! Table power: %mench table power%" to player

On MythicEnchants Trigger Fire

Fires whenever a subscribed trigger name fires on an item — including items with no matching enchantment — unlike the narrower skill-trigger event, which only fires per (enchantment, trigger) pair. Use mench subscribe to trigger %string% first to opt into a given trigger name. Not cancellable.

[mythic[al]] enchant[ment] trigger fire
mench trigger fire

Event values: player, item (ItemStack), entity (target, nullable)

Event-only expressions (all shared with the skill-trigger event above):

• mench trigger name
• mench trigger damage
• mench trigger item attack
• mench trigger slot

Example:

mench subscribe to trigger "BLOCK_BREAK"

on mench trigger fire:
    if mench trigger name is "BLOCK_BREAK":
        send "Trigger fired on %event-item%, even with no matching enchant!" to player

On MythicEnchants Anvil Prepare

Fires after MythicEnchants computes the anvil combine result but before it's shown in the anvil UI. Not cancellable — instead of cancelling, override the outcome by setting mench anvil result. This hook exists specifically so scripts can honor "overleveled" enchanted books past vanilla's level clamp (e.g. allow a level-6 Sharpness book to combine onto a level-6 sword when vanilla would cap it at 5).

[mythic[al]] anvil prepare
mench anvil prepare

Event values: player, item (the result ItemStack)

Event-only expressions:

• mench anvil left item — the base item (anvil slot 1)
• mench anvil right item — the sacrifice item (anvil slot 2)
• mench anvil result — gettable and settable. See below.

Example — the standout capability, overriding the result:

on mench anvil prepare:
    if {_shouldOverride}:
        set mench anvil result to {_myOverleveledBook}

mench anvil result getting returns the override result if one has already been set that tick, otherwise the vanilla/core-computed result. Setting it replaces the anvil's output outright — this is the only way to influence this event, since it cannot be cancelled.

Expressions

Item Enchantment Expressions

Examples:

set {_lvl} to mench level of "mythicenchants:fire_slash" on player's tool
send "%mench enchantments of player's tool%"
send "%mench registered enchantments of player's tool%"
send "Enchantability: %mench enchantability of player's tool%"
set {_curses::*} to mench curses of {_item}
set {_id} to mench custom item id of {_item}
set {_total} to mench total level of "mythicenchants:fire_slash" on player
set {_defs::*} to all mench applicable definitions for {_item}

Definition Expressions

Examples:

set {_def} to mench enchantment "fire_slash"
send "Name: %mench display name of {_def}%"
send "Rarity: %mench rarity of {_def}%"
send "Levels: %mench min level of {_def}%-%mench max level of {_def}%"
send "Tags: %mench tags of {_def}%"
send "Conflicts: %mench conflicts of {_def}%"
send "Reagents: %mench reagents of {_def}%"
send mench rarity of "mythicenchants:fire_slash"
send "%mench max level of ""mythicenchants:fire_slash""%"

loop all mench definitions:
    send "%mench id of loop-value%: %mench display name of loop-value%"

Rarity & Reagent Registry Expressions

Examples:

set {_rarities::*} to all mench rarities
set {_keys::*} to all mench reagent keys
set {_defs::*} to mench enchantments accepting reagent "crucible:moondust"

Tag Expressions

Examples:

set {_members::*} to mench enchantments in tag "mythicenchants:celestial_pack"
send "Celestial pack has %size of {_members::*}% enchantments"
set {_ids::*} to mench resolved ids of "sharpness", "minecraft:smite" and "#celestial_pack"

Stored/Book Enchant Expressions

"id:level" encoding convention: mench book with/containing, mench enchantment snapshot of, and mench restore enchantment snapshot (effect, below) all use a string format of "namespace:key:level" — the full enchant id (which itself contains a : for its namespace) followed by a final :level suffix. Parsing splits on the last : in the string, so "mythicenchants:fire_slash:3" is read as id mythicenchants:fire_slash at level 3.

Examples:

set {_book} to mench book with "mythicenchants:fire_slash:3"
set {_book} to mench book containing "mythicenchants:fire_slash:3" and "mythicenchants:lunar_light:2"

set {_snap::*} to mench enchantment snapshot of {_item}
mench restore enchantment snapshot {_snap::*} to {_item}

set {_stored::*} to mench stored enchantments of {_book}
set {_mythic::*} to mench mythic stored enchantments of {_book}
set {_lvl} to mench stored enchant level of "mythicenchants:fire_slash" on {_book}

Mob, Table & Seed Expressions

Examples:

send "%mench override for enchant ""minecraft:smite"" on mob ""ZOMBIE""%"
set {_offers::*} to mench table offers for player
send "Your enchant seed: %mench enchant seed of player%"

Migration Expressions

Example:

set {_target} to mench migration target of "mythicenchants:old_fire_slash"

Option Expressions (Config Options section)

Examples:

set {_v} to mench raw option "MyCustomFlag" of "mythicenchants:fire_slash"
set {_v} to mench boolean option "MyCustomFlag" of "mythicenchants:fire_slash" else false
set {_v} to mench integer option "MyCustomCount" of "mythicenchants:fire_slash" else 0
set {_v} to mench string option "MyCustomLabel" of "mythicenchants:fire_slash" else "default"

PDC (Persistent Data Container) Expressions

Examples:

set {_v} to mench pdc boolean "myKey" of {_item} else false
set {_v} to mench pdc integer "myKey" of {_item} else 0
set {_v} to mench pdc number "myKey" of {_item} else 0
set {_v} to mench pdc string "myKey" of {_item} else "default"

Anvil/Grindstone Config Expressions

Examples:

send "Cost multiplier: %mench anvil cost multiplier%"
send "XP return: %mench grindstone xp return percent%%%"

Anvil Prepare Event Expressions

Examples:

set {_base} to mench anvil left item
set {_sacrifice} to mench anvil right item

on mench anvil prepare:
    if {_shouldOverride}:
        set mench anvil result to {_myOverleveledBook}

General Config Expressions

Examples:

send "Datapack: %mench datapack name%"
send "Language: %mench language%"
send "Max: %mench max enchantments per item%"

Apply/Remove Event Expressions

Examples:

if mench apply source is "TABLE":
if mench remove source is "GRINDSTONE":
if mench event slot is "HAND":

Prepare Enchant Event Expressions

Examples:

if mench table power >= 15:
if mench reagent key is "crucible:moondust":

Trigger Event Expressions (Skill Trigger & Trigger Fire)

These five expressions all work in both mench skill trigger and mench trigger fire events, except mench trigger level which is skill-trigger only.

Examples:

if mench trigger name is "ATTACK":
set {_lvl} to mench trigger level
if mench trigger damage > 10:
    cancel event
set {_base_atk} to mench trigger item attack
if mench trigger slot is "HAND":

Counter Expressions

Counters are named, expiring long values scoped either to a player or to an item's persistent data.

Examples:

set {_v} to mench player counter "kills" of player
set {_v} to mench item counter "uses" of {_item}

Pet Ownership Expression

Example:

set {_owner} to mench pet owner of {_wolf}

Table Power Expressions

Direct access to the exact math the custom enchanting table uses, independent of the mench prepare enchantment event.

Examples:

set {_power} to mench table power at {_tableLoc}
set {_lvl} to mench table slot 0 base level for power 15

Reagent Introspection Expressions

Examples:

set {_key} to mench reagent key for {_item}
set {_entries::*} to mench reagent pool entries of "my_reagent"

Table Offer Detail Expressions

Parallel arrays to mench table offers for %player% (enchantment ids) — same index maps to the same offer slot.

Examples:

set {_costs::*} to mench offer costs for player
set {_levels::*} to mench offer levels for player

MythicMobs Item Bridging Expressions

Examples:

set {_type} to mench mythic item type of {_item}
set {_mat} to mench material for mythic "my_item"

Datapack Tag Introspection Expressions

Example:

set {_tags::*} to all mench known enchantable tags

Conditions

Item Conditions

All support negation.

Examples:

if player's tool has mench enchantment "mythicenchants:fire_slash":
if {_item} has a mench curse:
if {_book} is mench stored enchanted:
if {_item} has a mench active enchant for triggers "ATTACK" and "KILL":
if {_item}'s mench enchantment tooltip is hidden:
if {_item} has mench pdc key "myKey":
if {_item} mench matches "mythic:excalibur":
if "mythicenchants:fire_slash" mench can be applied to {_item}:

Definition Conditions

All support negation (isn't mench cursed, is not mench registered, etc.).

Example:

set {_def} to mench enchantment "fire_slash"
if {_def} is mench cursed:
    send "This enchantment is a curse!"
if "fire_slash" is mench registered:
    send "Fire Slash is registered"
if "mythicenchants:old_fire_slash" is mench migrated:
    send "Migrated to %mench migration target of ""mythicenchants:old_fire_slash""%"

Apply-Result Conditions

Check on the line right after a mench apply.

mench apply "mythicenchants:fire_slash" at level 3 to player's tool
if last mench apply succeeded:
    send "Enchanted!" to player

Tag & Conflict Conditions

Example:

if "mythicenchants:fire_slash" is in mench tag "mythicenchants:celestial_pack":
    send "Fire Slash is in the Celestial Pack!"

set {_a} to mench enchantment "fire_slash"
set {_b} to mench enchantment "ice_blade"
if {_a} mench conflicts with {_b}:
    send "These enchantments conflict!"

Mob Conditions

Example:

if "ZOMBIE" has mench overrides:
    send "This mob has custom enchant applicability rules."

Config/Feature-Flag Conditions

These all check a live config value and support negation.

Examples:

if mench custom table is enabled:
if mench datapack auto-generates:
if mench debugging is enabled:
if mench checks for updates:
if mench cleanup is enabled:
if mench cleanup is silent:
if mench has migrations:
if mench treasure is allowed at the table:
if mench vanilla is in the table:
if mench anvil combining is allowed:
if mench anvil use is free:
if mench anvil bypasses too expensive:
if mench anvil supported items are enforced:
if mench anvil shows cost when unaffordable:
if mench grindstone removal is allowed:
if mench grindstone keeps curses:

Counter Condition

Example:

if mench player counter "kills" of player matches ">=10":
    send "Double digits!" to player

Pet Ownership Condition

Example:

if player is the mench pet owner of {_wolf}:
    send "That's your pet!" to player

Reagent Condition

Example:

if "my_reagent" is a mench declared reagent:

Vanilla Curse Flag Conditions

Vanilla Minecraft's Curse of Binding and Curse of Vanishing, tracked separately from MythicEnchants' own Cursed: option system used by custom enchantments.

Example:

if {_item} has a mench vanilla binding curse:

Datapack Tag Introspection Condition

Example:

if "#minecraft:enchantable/sword" is a mench known enchantable tag:

Effects

Enchantment Effects

Examples:

mench apply "mythicenchants:fire_slash" at level 3 to player's tool
if last mench apply failed:
    send "That enchantment can't go on this item." to player
mench apply "mythicenchants:fire_slash" at level 3 to player's tool for player and fire trigger
mench remove "mythicenchants:fire_slash" from player's tool
mench copy enchantments from {_oldItem} to {_newItem}
unregister mench enchantment "yourplugin:starfall"

Registering new definitions is a Java-API operation (MythicEnchantsAPI.register(...) with the EnchantmentDefinition.builder), not a Skript effect — brand-new enchantments require a server restart to enter the datapack/Registry.ENCHANTMENT, so runtime script-side creation has limited use. See docs/API.md.

Stored/Book Enchant Effects

Example:

set {_snap::*} to mench enchantment snapshot of {_item}
# ... later ...
mench restore enchantment snapshot {_snap::*} to {_item}

PDC Effects

Examples:

mench set pdc boolean "myKey" of {_item} to true
mench set pdc integer "myKey" of {_item} to 5
mench set pdc number "myKey" of {_item} to 3.5
mench set pdc string "myKey" of {_item} to "myValue"
mench remove pdc key "myKey" from {_item}

Tooltip Effects

Example:

mench hide the enchantment tooltip of {_item}
mench show the enchantment tooltip on {_item}

Seed Effects

Example:

mench reroll enchant seed of player
send "Your enchanting table offers have been refreshed!"

Trigger Subscription Effects

Example:

mench subscribe to trigger "BLOCK_BREAK"
# ... later ...
mench unsubscribe from trigger "BLOCK_BREAK"

Debug/Maintenance Effects

Examples:

mench enable debugging
mench disable debug
regenerate mench datapack
reload mench enchantment files

Counter Effects

Examples:

mench add 1 to player counter "kills" of player
mench add 1 to player counter "combo" of player expiring in "5s"
mench set player counter "kills" of player to 0
mench remove player counter "combo" from player

mench add 1 to item counter "uses" of {_item}
mench set item counter "streak" of {_item} to 3 expiring in "10s"
mench remove item counter "streak" from {_item}

Table Offer Effect

Example:

mench invalidate table offers for player

Vanilla Curse Flag Effects

Examples:

mench add a vanilla binding curse to {_item}
mench remove a vanilla vanishing curse from {_item}

Cancel Event

Of the six MythicEnchants events, four support Skript's native cancel event:

on mythic enchantment skill trigger:
    if mench trigger name is "ATTACK":
        if player is in world "spawn":
            cancel event  # suppress enchantment skills in spawn

• Apply/Remove events: cancelling suppresses MythicEnchants' skill dispatch for that trigger, but does NOT revert the underlying Bukkit operation.
• Skill trigger event: cancelling skips the skill call for that specific enchantment only.
• Prepare enchant event: cancelling leaves the vanilla offers untouched.
• Trigger fire event: NOT cancellable — this is a pure notification bridge, there is no vanilla operation to suppress.
• Anvil prepare event: NOT cancellable — instead, "override" its outcome with set mench anvil result to ....

Full Example Script

on mythic enchantment skill trigger:
    # Suppress all enchant skills in the spawn world
    if player is in world "spawn":
        cancel event
        stop

    # Log high-damage enchantment hits
    if mench trigger name is "ATTACK":
        if mench trigger damage > 15:
            log "%player% dealt %mench trigger damage% damage with %mench id of event-menchenchantment% level %mench trigger level%"

on mythic enchantment apply:
    # Announce rare enchantment applications
    set {_def} to mench enchantment "mythicenchants:legendary_strike"
    if {_def} is set:
        if mench apply source is "TABLE":
            broadcast "&6%player% just enchanted their %event-item% with Legendary Strike!"

on mythic prepare enchantment:
    # Show reagent info
    if mench reagent key is not "minecraft:lapis_lazuli":
        send "&dSpecial reagent: %mench reagent key% (Power: %mench table power%)" to player

# Subscribe to a trigger that has no matching enchantment requirement
mench subscribe to trigger "BLOCK_BREAK"

on mench trigger fire:
    if mench trigger name is "BLOCK_BREAK":
        send "&7Trigger fired on %event-item%." to player

# Honor "overleveled" enchanted books past vanilla's level clamp at the anvil
on mench anvil prepare:
    set {_left} to mench anvil left item
    set {_right} to mench anvil right item
    if {_right} is not set:
        stop
    set {_bookLevel} to mench stored enchant level of "mythicenchants:fire_slash" in {_right}
    if {_bookLevel} > mench max level of "mythicenchants:fire_slash":
        # Vanilla would clamp this combine — build our own overleveled result instead.
        set {_snap::*} to mench enchantment snapshot of {_left}
        set {_result} to mench anvil result
        mench restore enchantment snapshot {_snap::*} to {_result}
        mench apply "mythicenchants:fire_slash" at level {_bookLevel} to {_result}
        set mench anvil result to {_result}

# Curses, options, PDC helpers, and tooltip hiding on a crafted "cursed relic"
command /makerelic:
    permission: mench.relic
    trigger:
        set {_relic} to mench book with "mythicenchants:doom_curse:1"
        mench set pdc string "relic_owner" of {_relic} to "%player%"
        mench set pdc boolean "relic_bound" of {_relic} to true
        mench hide the enchantment tooltip of {_relic}
        give {_relic} to player
        if {_relic} has a mench curse:
            send "&4Beware — this relic is cursed!" to player

# Command to inspect an enchantment
command /enchinfo <text>:
    permission: mench.info
    trigger:
        if arg-1 is not mench registered:
            send "&cEnchantment not found."
            stop
        set {_def} to mench enchantment arg-1
        send "&aEnchantment: &f%mench display name of {_def}%"
        send "&aID: &f%mench id of {_def}%"
        send "&aRarity: &f%mench rarity of {_def}%"
        send "&aLevels: &f%mench min level of {_def}%&7-&f%mench max level of {_def}%"
        send "&aTags: &f%mench tags of {_def}%"
        send "&aConflicts: &f%mench conflicts of {_def}%"
        send "&aReagents: &f%mench reagents of {_def}%"
        if {_def} is mench cursed:
            send "&c(Curse)"
        if {_def} is mench treasure:
            send "&e(Treasure)"