# 🚀 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:` 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`: ```yaml 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: ```bash /se giverandombook [options] ``` * **Engine Arguments & Filters:** * `-level:` - Forces the book to a specific level, ignoring enchantments whose maximum design level falls below this value. * `-rarity:` - Limits selections strictly to enchantments matching specific rarity metadata tags. * `-target:` - Filters items matching target types (e.g., `WEAPON`). * `-type:` - Filters based on origin hooks. Supported source type aliases include: * `vanilla`, `minecraft`, `mc` * `since`, `se`, `custom` * `ae`, `advancedenchantments` * `ce`, `crazyenchantments` * `ee`, `excellentenchants` * `-success:` - Assigns static or randomized success percentages (e.g., `-success:40to90`). * `-failure:` - Assigns static or randomized failure/destroy percentages (e.g., `-failure:10to30`). * `-amount:` - 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 [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 ```bash /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://sincerpg.github.io/SinceEnchantments/)

SinceEnchantments

1.2.4

1.2.3

1.2.2

1.2.1

1.2

1.1

1.0