MythicEnchant icon
Public Plugin

MythicEnchant

Turn enchanted books into a living, physical arcane library.

6Spigot downloads
Modrinth downloads
Not rated0 Spigot ratings
2.1.1Current version
11 Jul 2026Last public update

Full overview

Turn enchanted books into a living, physical arcane library.

MythicEnchant rebuilds enchanting around discovery, collection and player choice. Instead of repeatedly rolling a vanilla table until the right offer appears, players create a physical Arcane Library from enchanted books stored in nearby chiseled bookshelves.

When an item is placed into the custom enchanting interface, the library checks the knowledge physically available around that table and presents only compatible options. The result is a system that rewards exploration, trading and shared community builds while still respecting Minecraft items, XP and lapis.

Best suited toSurvival, RPG and economy servers that want enchanting to become a visible long-term collection system.

How it works

From discovered book to permanent library knowledge

Enchanted books enter the world through the server's chosen discovery methods. Players place those books into chiseled bookshelves around an enchanting table, turning a decorative build into a functional collection of magical knowledge.

The GUI filters entries by item type, level, compatibility and conflicts. Server owners decide how books combine, which enchantments can appear naturally, whether anvils remain usable and how much XP or lapis each rarity should cost.

  • Exact enchantment selection instead of random rerolling
  • Physical public, personal or clan libraries
  • Vanilla and custom books in one progression loop
  • Configurable compatibility, conflicts, costs and discovery

Administration

Configuration and live-server use

The plugin is designed for live survival servers: enchant data is stored safely on items, recursive multi-block and area effects are guarded, secondary PvP damage can be controlled and the GUI, messages, sounds and costs are configurable. LevelCraft support is optional, allowing Sorcery requirements and XP rewards without making LevelCraft a hard dependency.

CompatibilityPaper/Spigot 1.21.10 IntegrationsLevelCraft edition, Vault-ready design Version2.1.1

Feature breakdown

Everything included in MythicEnchant

Each headline feature is expanded below so visitors can understand the real server use rather than seeing a short tag list.

Selectable enchanting GUI

Insert compatible equipment, inspect every valid option and apply the exact enchantment the player has unlocked.

Physical bookshelf libraries

Chiseled bookshelves hold the real enchanted books that define what each enchanting table knows.

Vanilla and custom enchantments

Minecraft enchantments and MythicEnchant content can coexist inside the same library and interface.

100 custom enchantments

Weapons, tools, armour, shields and elytras receive active effects ranging from utility upgrades to boss-focused combat powers.

Configurable XP and lapis costs

Rarity, treasure status and server balancing rules can all influence the final price.

Natural book discovery and drops

Rare knowledge becomes exploration and trade content rather than an admin-only catalogue.

Getting started

Installation and rollout

The platform buttons include downloads, changelogs and the original public resource discussion.

  1. 1

    Install the plugin and restart the server to generate its files.

  2. 2

    Configure enchanting rules, custom enchantments, messages and costs.

  3. 3

    Place books in chiseled bookshelves around an enchanting table and test the scan range.

  4. 4

    Install LevelCraft only when Sorcery progression integration is wanted.

Tokens & placeholders

Text tokens found in the source

Availability depends on the feature that references each token.

%amount%%custom%%enchant%%enchants%%item%%lapis%%level%%levels%%player%%roman%%shelves%%vanilla%

Source architecture

42 Java classes across 9 packages

listeners (12), models (9), managers (6), utils (6), gui (4), tasks (2), commands (1), hooks (1)

Core systems

AdminGUI, EnchantingGUI, Main, AdminBookCategory, AdminBookType, AdminSetting, CustomBookData, CustomEnchantDefinition, CustomEnchantRarity, EnchantOffer, EnchantTarget, ScanResult, AdvancedPassiveEnchantTask, PassiveEnchantTask, CustomEnchantUtil, EnchantUtil, ItemUtil, Metrics and 1 more

Commands

MythicEnchantCommand

GUI & menus

AdminGUIHolder, EnchantingGUIHolder

Listeners & events

AdminGuiListener, AdvancedArmorEnchantListener, AdvancedToolEnchantListener, AdvancedWeaponEnchantListener, AnvilListener, CustomArmorEnchantListener, CustomEnchantLootListener, CustomToolEnchantListener, CustomWeaponEnchantListener, EnchantGuiListener, EnchantTableListener, VanillaEnchantListener

Managers & services

ConfigManager, CostManager, CustomEnchantManager, EnchantApplyManager, MessageManager, ShelfScanner

Integrations & API

LevelCraftHook

Utilities

ColorUtil

Configuration reference

3 bundled YAML files

Top-level sections and defaults are summarised from the supplied resources.

config.yml

  • Enchanting — 7 nested settings: Open-Custom-GUI, Disable-Vanilla-Table, Disable-Anvil-Book-Enchants, Allow-Anvil-Item-Combining, Require-Permission, Permission, Title
  • Combination-Fallback — 3 nested settings: Enabled, Only-When-Anvil-Book-Enchants-Disabled, Books-Per-Upgrade
  • Bookshelves — 4 nested settings: Type, Radius-XZ, Vertical-Range, Max-Shelves-Scanned
  • Enchantments — 5 nested settings: Allow-Treasure-Enchants, Allow-Curses, Respect-Vanilla-Compatibility, Allow-Unsafe-Levels, Allow-Upgrades
  • Costs — 4 nested settings: Bypass-Permission-Enabled, XP, Lapis, Custom
  • Effects — 1 nested settings: Allow-Secondary-PvP
  • Sounds — 4 nested settings: Open, Apply, Fail, Page

custom-enchants.yml

  • Natural-Loot — 5 nested settings: Enabled, Chest-Chance, Max-Books-Per-Chest, Extra-Book-Chance, Allow-Plugin-Generated-Loot
  • Enchantments — 100 nested settings: executioner, vampirism, venom, giant_slayer, cleaving, duelist, arc_strike…

messages.yml

  • Prefix — &8[&dMythicEnchant&8]
  • No-Permission — &cYou do not have permission to use this.
  • Reloaded — &aMythicEnchant and all custom enchantments reloaded.
  • Only-Players — &cOnly players can use this command.
  • Look-At-Table — &cLook at an enchantment table and try again.
  • Anvil-Blocked — &cEnchanted books must be studied through an Arcane Library.
  • Anvil-Item-Combining-Blocked — &cCombining enchanted items in anvils is disabled. Use the Arcane Library fallback.
  • Vanilla-Table-Blocked — &cUse the Arcane Enchanting menu instead.
  • Place-Item — &ePlace an enchantable item into the item slot.
  • No-Library-Enchants — &cNo usable enchantments were found in nearby chiseled bookshelves.
  • Invalid-Item — &cThat item cannot be enchanted here.
  • Not-Enough-XP — &cYou need &e%levels% XP levels&c to apply this enchantment.
  • Not-Enough-Lapis — &cYou need &9%lapis% lapis lazuli&c in the lapis slot.
  • Applied — &aApplied &d%enchant% %level%&a to your item.
  • Already-Has — &cYour item already has this enchantment at the same or a higher level.
  • Incompatible — &cThat enchantment is incompatible or conflicts with an enchant already on this item.
  • Scanned — &aScanned &e%shelves%&a shelves and found &d%enchants%&a enchantments.
  • Scanned-Detailed — &aScanned &e%shelves%&a shelves: &b%vanilla% vanilla&a and &d%custom% custom&a enchantments.
  • Unknown-Custom-Enchant — &cUnknown custom enchantment: &f%enchant%
  • Player-Not-Found — &cPlayer &f%player%&c is not online.
  • Book-Given — &aGave &f%amount%x &d%enchant% %level%&a book to &f%player%&a.
  • Fishing-Treasure — &dMaster Angler uncovered: &f%item%&d!
  • Phoenix-Saved — &6Your Phoenix enchantment saved you from death!
  • Guardian-Angel-Saved — &eYour Guardian Angel pulled you back from death and returned you to safety!
  • Soulbound-Restored — &dYour Soulbound equipment has returned to you.
  • Sounds — 4 nested settings: Open, Apply, Fail, Page

Permissions

3 declared permission nodes

Defaults and descriptions come directly from plugin.yml.

mythicench.use

Allows players to use the MythicEnchant library table.

Default: True

mythicench.admin

Allows the MythicEnchant admin GUI, commands and book spawning.

Default: op

mythicench.bypasscost

Bypasses XP and lapis when Costs.Bypass-Permission-Enabled is true.

Default: not specified

Commands

1 declared command

Aliases, usage and permissions come directly from plugin.yml.

/

/mythicench

MythicEnchant administration and custom book commands.

Aliases: /menchant, /mythicbook · Usage: /mythicench <admin|reload|scan|list|givebook|status> · Permission: None declared

Source-verified reference

Checked against MythicEnchant 2.1.1

This static reference is built from the supplied plugin.yml, YAML resources and Java source. No browser-generated documentation is used.

Main classme.Ghoul.MythicEnchant.MainAPI version1.21Java classes42 Hard dependenciesNoneSoft dependenciesNoneLoad beforeNone

Community feedback

Latest SpigotMC reviews

Live ratings and recent written reviews from the public Spigot resource page.

Not rated ☆☆☆☆☆ 0 community ratings
Read all reviews on SpigotMC ↗
Loading the latest Spigot reviews…

Review data is loaded through Spiget. Static rating fallbacks remain visible if the service is unavailable.

Related projects

Continue exploring