SinceEnchantments

SinceEnchantments - Changelog v1.2.3 (Official Release)

Full compilation of critical bug fixes, cross-plugin integrations, native multi-threading support, and a complete overhaul of the random book system.

---

Critical Bug Fixes & Core Enhancements

1.21 Data Components & Cache Alignment

Texture Overwrite Bug Fix:* Resolved a critical cache collision bug in ItemPacketListener caused by Minecraft 1.21 Data Components (item_model and custom_model_data) failing to be uniquely identified by raw NBT hashing. The packet listener now perfectly identifies and renders independent custom item textures. Packet Lore Cache Tuning:* Added configurable packet lore cache settings directly in settings.yml and enforced cache clearing during plugin shutdown to prevent stale memory references and memory leaks. Enchantment Slots Lore Fix:* Fixed an issue where the enchantment slots lore text would still erroneously display even if the remaining enchantment slot count was less than or equal to 0.

Hardcode Extraction & Configuration Flexibility

Configurable Command Aliases:* Moved List.of("se", "sinceenchant") out of core hardcoding. You can now cleanly define your own command aliases in settings.yml. Dynamic Enchantable Material System:* Moved isEnchantableGear material criteria entirely into settings.yml under settings.enchantable-gear-suffixes and settings.enchantable-gear-exact, unlocking complete sandbox customization for custom server gear. Code Hardening:* Shifted all inline Fully Qualified Class Names (FQCN) to standard top-file imports and documented previously obscured logic with clean, explanatory English Javadoc blocks. ---

Native Folia & Performance Support

Thread-Safe Scheduler Routing:* Added full Folia support by safely routing player-bound delayed tasks through region-aware schedulers rather than the global server thread. Metadata Alignment:* Added folia-supported: true flags to the Paper plugin boot metadata. Task Guard Hardening:* Eliminated stuck-state and infinite-loop edge-case risks within the Excavator and Thunder enchantment safety guards. Constant Consolidation:* Relocated distributed PersistentDataContainer namespace keys into a centralized, static constants layout for fast indexing. ---

Ecosystem Extensions & Cross-Plugin Hooks

Third-Party Custom Enchantments Compatibility

AdvancedEnchantments & CrazyEnchantments Fixes:* Resolved an issue where external custom enchantments from other active plugins failed to load, register, or apply correctly onto items. Unified Registry Ingestion:* Remapped the backend loader to ensure third-party enchantments register correctly into the local engine, making them accessible to standard commands and packet listeners.

Native ExcellentEnchants API Integration

API Hooking:* Implemented a non-reflective, native API hook for ExcellentEnchants. Added explicit compile-time Gradle dependencies for su.nightexpress.excellentenchants:Core:5.4.3 and su.nightexpress.nightcore:main:2.16.2. Metadata Auto-Registration:* Reads registered entries via EnchantRegistry.getRegistered() to auto-inject excellentenchants:<id> metadata for runtime book creation, lore mapping, tab completion, and random filtering. Best-Effort Profile Parsing:* Dynamically reads configuration files directly from plugins/ExcellentEnchants/enchants, falling back safely to the native Bukkit enchantment registry for fallback max levels and item applicability limits. Dynamic Description Overrides:* Introduced a customizable description array for dynamic ExcellentEnchants listings inside settings.yml:

  settings:
    ee-default-description:
      - "&7Special effect from"
      - "&7ExcellentEnchants."
  

Complete Random Book System Overhaul

Advanced Filtered Generation Command

New Command Structure:* Introduced a dedicated random enchantment book generator command packed with combinable logic filters:

/se giverandombook <player> [options]

Engine Arguments & Filters:* * -level:<number> - Forces the book to a specific level, ignoring enchantments whose maximum design level falls below this value. * -rarity:<rarity> - Limits selections strictly to enchantments matching specific rarity metadata tags. * -target:<target> - Filters items matching target types (e.g., WEAPON). * -type:<type> - Filters based on origin hooks. Supported source type aliases include: * vanilla, minecraft, mc * since, se, custom * ae, advancedenchantments * ce, crazyenchantments * ee, excellentenchants * -success:<number|range> - Assigns static or randomized success percentages (e.g., -success:40to90). * -failure:<number|range> - Assigns static or randomized failure/destroy percentages (e.g., -failure:10to30). * -amount:<number|range> - Dictates the given book bundle size (e.g., -amount:1to2).

Refactored Workflow Changes

`/se givebook` Realignment:* Kept strictly focused on target-specific, uniform distribution and is fully backward-compatible: /se givebook <player> <enchant> <level> [success] [destroy]. It no longer accepts the random argument; use /se giverandombook instead. Unified Accessor Pools:* Random book selections now use shared metadata accessors, meaning vanilla Bukkit, SinceEnchantments, AdvancedEnchantments, CrazyEnchantments, and ExcellentEnchants all participate natively inside filtered pools. Proactive Constraint Checking:* Book generation now cross-references and validates requested enchantment levels against native max-level capacities before generating items, avoiding corrupted index items. Enhanced Tab Completion:* Added predictive tab completion for random filters, sub-values, range parameters, and silent mode flags. Tip:* To trigger option tab-completion, type the option string, insert 1 space, then delete that space to activate the completion popup. Silent Mode execution:* Added an -s silent modifier flag across both /se givebook and /se giverandombook to completely suppress executor console feedback, streamlining automated crate and vote rewards.

Example Usages

/se giverandombook Steve
/se giverandombook Steve -level:1 -target:WEAPON -type:ae
/se giverandombook Steve -rarity:LEGENDARY -type:ee -success:40to90 -failure:10to30 -amount:1to2 -s
/se givebook Steve "minecraft:sharpness" 5 60 40 -s

---

Wiki & Open-Source Docs Migration

GitHub Pages Transition:* Abandoned old GitLab infrastructure and fully migrated the documentation network over to a high-speed, modern open-source hub. New Wiki URL:* [https://sincerpg.github.io/SinceEnchantments/](https://si…

Release Notes - Version 1.2.2

⚡ Performance & Optimization Massive Lag Reduction:* Fixed severe server lag and TPS drops caused by spam-clicking or rapidly pressing the swap-hand ('F') key inside chests and menus. Zero-Lag Visuals:* Introduced a highly optimized, smart caching system for visual enchantments. The plugin is now virtually lag-proof, even on heavy servers with constant inventory updates. Extractor GUI Anti-Spam:* Added strict anti-spam protection to the Extractor menu to prevent server bottlenecking and potential item duplication exploits. 🐛 Bug Fixes Placeholder Display Fix:* Fixed a critical issue where the {enchants} placeholder would occasionally disappear or fail to display the custom enchantments on items. Creative Mode Fix:* Fixed a bug where taking custom items out of the Creative menu would incorrectly strip their hidden item flags and expose vanilla enchantments. Placeholder Consistency:* Fixed a visual glitch where removed enchantments would incorrectly leave behind #enchants# instead of your custom configured placeholder. ⚙️ Configuration Updates 100% Hardcode Removal:* Every single piece of text, including console warnings and startup logs, has been moved to messages.yml and is now fully customizable/translatable. Smart File Auto-Updates:* Added new configuration toggles allowing you to selectively auto-update specific files (like settings.yml and messages.yml) without overwriting your other configs.

SinceEnchantments - 1.2.1 - Override max level, rarity, enchant target vanilla - Improve override max level, rarity, enchant target vanilla - [Compatibility with AdvancedEnchantments](https://gitlab.com/sincerpg/SinceEnchantments/-/wikis/Hom…

- Readded mmoitems item limit config to split it - Config mythicmobs to make it work with items - Add "enchant-targets" settings to settings file to make it changeable for enchant apply check - Implement EnchantManager to handle custom enchantment configurations and item limitations

SinceEnchantments v1.1 - The Foundation Update

This update introduces a massive refactor of the core systems, improved compatibility with MMOItems, and critical fixes for anvil exploits and visual bugs.

Key Highlights

| Feature | Description | | :--- | :--- | | New Items | Added Randomizer Stone, Protection Gem, and Stat Tracker. | | Modular Config | Config split into enchants.yml, gui.yml, settings.yml, and limits.yml. | | Vanilla+ Support | Freshly crafted gear now displays slots/whitelists immediately. | ---

Full Change Log

New Features & Refactors

Config Evolution:* Moved from a single file to a modular system for better management. Smart Categories: Full support for Vanilla wildcards (e.g., `_PICKAXE`) and MMOItems (Type:ID). Dynamic Protection:* Toggle whether Protection Gems are permanent or consumed on death in settings.yml.

Exploit & Security Fixes

Anvil Hardening:* Enchantment books must now be applied via drag-and-drop (prevents bypassing RNG). * Fixed bypasses for Max Slots and incompatible enchantments during merging. Combat Balance:* Lifesteal no longer works on Armor Stands or dead corpses. Grief Prevention:* Excavator now respects WorldGuard/Towny protection.

Bug Fixes & UX

Visual Polish:* Fixed {enchants} placeholder lingering on clean items. Stat Trackers:* Fixed instant rendering (starts at 0) and isolated applicator NBT keys. Ghost Items:* Resolved the "Ghost Item" cursor bug when using the last Extractor. Addon System:* Fixed a critical NoClassDefFoundError in the AddonLoader.

<div align="center"> <h1> SinceEnchantments </h1> <p><b>The Ultimate, Highly-Optimized RPG Custom Enchantment System for PaperMC</b></p> <p> <a href="https://gitlab.com/sincerpg/SinceEnchantments/-/wikis/Home"><b> DOCUMENTATION (WIKI)</b></a> • <a href="https://youtu.be/fHJwspsIYoQ"><b> VIDEO SHOWCASE</b></a> </p> </div> ---

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

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/fHJwspsIYoQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

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](https://gitlab.com/sincerpg/SinceEnchantments/-/wikis/Home)