📖 Overview

SinceEnchantments is a next-generation custom enchantment plugin designed to bring authentic MMORPG upgrade mechanics to your Minecraft server.

Say goodbye to messy NBT tags and broken lore! Powered by PacketEvents, SinceEnchantments renders all enchantment visuals purely via packets. Your items remain fundamentally clean on the server side, while clients see beautiful, dynamically placed enchantment lore.

📺 Video Showcase

(Click the image to watch the showcase!)

⭐ Core Features

📡 Packet-Rendered Lore (Zero Item Bloat)

• Virtual Rendering: Enchantments are displayed via client-side packets. No permanent lore strings are written to the item, eliminating the "zero-width space" bugs and messy legacy formatting.
• Custom Positioning: Place the {enchants} placeholder anywhere in your item's lore, and the plugin will seamlessly inject the enchantments exactly where you want them.

🎲 Deep RPG Upgrade Mechanics

• RNG System: Every Enchantment Book comes with specific Success and Destroy rates. Will your players risk losing their gear for ultimate power?
• Slot Limits: Balance your server economy! Limit the maximum number of custom enchantments an item can hold based on its material type.

⚔️ Seamless Compatibility

• MMOItems Integration: Fully hooked into MMOItems. You can set specific enchantment whitelists and custom slot limits for individual MMOItem IDs.
• Vanilla Anvil Support: Combine custom enchant books to level them up, or apply them directly to gear using Vanilla XP mechanics.

🧩 Addon & API System

• Easily write your own custom enchantments! Developers can create standalone .jar addons and simply drop them into the plugins/SinceEnchantments/Enchantments folder. No messy hardcoding required.

💎 The Enchantment Ecosystem (Custom Items)

SinceEnchantments introduces a balanced economy of upgrade items, fully customizable in items.yml:

• 📙 Enchantment Books: The core upgrade item featuring dynamic levels, success rates, and destroy rates.
• 🍀 Success Charms: Drag and drop these onto an Enchantment Book to increase its Success Rate (and decrease its Destroy Rate). A must-have for endgame crafting!
• 💎 Slot Gems: Apply these to an item to increase (or decrease) its maximum enchantment capacity.
• 📜 Extractors: Safely remove an enchantment from an item and turn it back into a book. Features two modes:
  • Random: Pulls a random enchantment off the item.
  • Specific: Opens a modern, lag-free Paper Dialog API GUI, allowing players to choose exactly which enchantment to extract.
• 🔥 Purge Scrolls: Cleanse an item of all custom enchantments instantly (with an admin option to refund the books).
• 🔒 Lock Scrolls: Permanently lock an item, preventing any further enchantments, extractions, or modifications.

🚀 Getting Started

Ready to revolutionize your server's gear progression? 👉 Read the Official Wiki for Setup & Configuration Guides