PerfEnchants
Custom enchant display, apply commands, GUI browser, books, anvil rules, and optional audit stats. Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – Fully compatible with Folia region threading
• Custom enchant lore – Replaces vanilla enchant text with styled MiniMessage lore (icons, colors, levels)
• Rarity system – Per-enchant rarity in enchants.yml (common → mythic) with matching lore styles and optional glow
• Vanilla tooltip order – Sort lore by Minecraft 1.21 tooltip_order, rarity, or alphabetically
• Level formats – Arabic or Roman numeral display; hide vanilla enchant lines on items and books
• Enchant browser GUI – /enchants opens a paginated GUI with categories (combat, armor, tools, ranged, trident, fishing, curses); click an enchant, pick a level, apply to item in main hand
• Apply & remove command – /enchant applies enchants to the held item; level 0 removes the enchant (e.g. /enchant mending 0)
• Above-max levels – Configurable unsafe levels above vanilla max with perfenchants.enchant.unsafe permission
• Enchanted books – Generate custom-lore books via /enchants book or admin /perfenchants book
• Per-enchant anvil rules – enchants.yml anvil section: allow combine above max, cost multiplier, max combine level
• Auto lore refresh – Updates lore after enchant table, anvil, smithing, grindstone, and inventory changes
• Audit log & stats – Optional SQLite/MySQL logging of applies/books; /perfenchants stats (player) shows totals
• Fully configurable – config.yml, enchants.yml, gui/enchants-gui.yml, messages.yml
Commands
/enchant (enchant) (level) [player] – Apply or remove (level 0) an enchant on held item (perfenchants.enchant)
/enchants – Open the enchant browser GUI (perfenchants.use)
/enchants gui – Open the enchant browser GUI (perfenchants.use)
/enchants book (enchant) (level) [amount] [player] – Give custom-lore enchanted book(s) (perfenchants.book)
/perfenchants reload – Reload configs (perfenchants.admin)
/perfenchants help – Show admin command usage (perfenchants.admin)
/perfenchants refresh [player|all] – Re-render enchant lore on player inventory (perfenchants.admin)
/perfenchants stats (player) – Show enchant apply audit stats (perfenchants.admin)
/perfenchants gui [player] – Open enchant browser for yourself or another player (perfenchants.admin)
/perfenchants enchant (enchant) (level) [player] – Admin apply/remove enchant (perfenchants.admin)
/perfenchants book (enchant) (level) [amount] [player] – Admin give enchanted book(s) (perfenchants.admin)
Database
• SQLite (default)
• MySQL (configurable)
