Wikis / MythicEnchants / Mythic Enchants Overleveled / Overlevel

Overlevel

MythicEnchantsOverleveled

Lets specific, allowlisted enchants be minted onto enchanted books above their normal MaxLevel, and makes the anvil honor that book's exact level instead of vanilla silently clamping the result back down.

Features

  • Per-enchant allowlist, not a global cap raise. Nothing is overleveled by default — each enchant needs its own entry in per-enchant-caps before it can exceed its MaxLevel at all. An enchant with no entry behaves identically to a server without this addon installed.
  • The anvil result is honored exactly. Vanilla clamps a merged enchant's level back to MaxLevel before this addon ever sees the result, so it rebuilds the anvil's output item from scratch and asserts the sacrifice book's overleveled level as final — layered on top of whatever core/vanilla already computed for every other enchant on the item.
  • /mench book can mint overleveled books directly. This addon overrides core's own book subcommand so admins can hand out a book above MaxLevel in one command, gated by its own permission separate from the base mench.book node.
  • A public API for other addons. OverleveledAPI.get() exposes getEffectiveCeiling()/isOverleveled()/createOverleveledBook() so other plugins, addons, or MythicMobs mechanics (e.g. a custom loot table or drop mechanic) can mint overleveled books programmatically, or ask "how far can this enchant go?" before doing their own math. MythicEnchantsScrolls's add-mode collision math already uses this.
  • Deliberately narrow scope. No loot table, custom enchanting table, or villager trade integration — overleveled books only ever come from /mench book or the API, by design.

Install

MythicEnchantsOverleveled.jar -> plugins/MythicEnchants/addons/

Restart. config.yml is written to plugins/MythicEnchants/addons/MythicEnchantsOverleveled/ with an empty allowlist — nothing is overleveled until you add entries.

Configuration (config.yml)

enabled: true

per-enchant-caps: {}

require-permission: "mench.overleveled.create"

debug: false
Key Default What it does
enabled true Master switch. When false, the anvil listener no-ops entirely and /mench book refuses any level above an enchant's plain MaxLevel.
per-enchant-caps {} Maps a full namespaced enchant id (vanilla or MythicEnchants custom, e.g. minecraft:sharpness, mythicenchants:fire_slash) to a non-negative integer bonus above MaxLevel. MaxLevel: 5 + cap 3 = an effective ceiling of 8. Lookup is case-insensitive; negative values are rejected with a load-time warning.
require-permission "mench.overleveled.create" Permission needed to mint a book above MaxLevel via /mench book. In-range books only need the base mench.book permission. Leave blank to let anyone with mench.book create overleveled books too.
debug false Logs each overleveled enchant applied during an anvil combine — enchant, book level, ceiling, applied level, player.

Commands

/mench book <player> <enchantment> <level>

Overrides core's own book subcommand — identical behavior for in-range levels, and additionally allows levels up to an enchant's effective ceiling (MaxLevel + per-enchant-caps bonus) if the sender has require-permission (or it's blank). Permission: mench.book.

API

OverleveledAPI api = OverleveledAPI.get();
if (api != null) {
    ItemStack book = api.createOverleveledBook("minecraft:sharpness", 6);
}
Method What it does
getEffectiveCeiling(Enchantment) Highest level this enchant may be minted at — MaxLevel + its per-enchant-caps bonus, or the plain MaxLevel if overleveling is disabled or the enchant has no cap entry.
isOverleveled(Enchantment, int level) Whether level exceeds the enchant's normal MaxLevel.
createOverleveledBook(String enchantId, int level) Resolves a namespaced enchant id and mints a book at level, clamped to the effective ceiling. null if the id doesn't resolve.
createOverleveledBook(Enchantment, int level) Same, given an already-resolved Enchantment.

OverleveledAPI.get() returns null if the addon isn't loaded — always null-check.

Updated Aug 19, 2026