BuffedItems

📋 BuffedItems v1.5.4 Patch Notes

This update represents a major architectural overhaul for the Crafting System and Editor, shifting to a high-performance "RAM-First" approach. It also brings significant optimizations for combat servers and stabilizes item identification across server restarts. 🛠️ Crafting System & Editor Overhaul

This update completely rewrites how recipes are created, stored, and loaded.

[Crafting Engine] Batched I/O & Zero-Latency:
    Logic: Recipes are now registered/unregistered in batches (5 per tick) instead of all at once.
    Impact: Eliminates server freezes during /bi reload, even with large recipe databases. Custom crafting is now instant after reload; no need to wait for background tasks.
[Editor] RAM-First Editing:
    Logic: The editor no longer writes to disk on every slot change. Changes are held in RAM and flushed to disk only when necessary.
    Fix: Eliminates UI lag/freezing when editing recipes in the GUI.
[Editor] Smart Auto-Save & Safety:
    Reload Guard: /bi reload now detects unsaved changes in the editor and warns admins, preventing accidental data loss.
    Auto-Save: Closing the menu or disconnecting automatically saves pending changes.
    UX Fix: Auto-save no longer triggers falsely during chat inputs (e.g., typing permissions).
[Editor] Ghost Recipe Fix: Fixed an issue where newly created recipes were technically "saved" but not marked correctly, sometimes causing them to vanish.

⚡ Performance & Optimization

[Combat] Event Listener Cleanup:
    Change: Removed the onEntityDamage listener entirely.
    Impact: The plugin no longer checks item updates on every attack. This significantly reduces CPU usage in PvP/PvE scenarios.
[Core] Distributed Join Scanning:
    Change: Replaced the full-inventory loop on join with a time-sliced task (scanning 3 slots per tick).
    Impact: Prevents "Thundering Herd" lag spikes when multiple players join the server simultaneously.
[Item Updater] Smart Rate Limiting:
    Hash-Based Versioning: Static items (without placeholders) are now hashed and skipped during update checks if they haven't changed.
    Placeholder Throttling: Items with PAPI placeholders are strictly rate-limited to update only once every 3 seconds.

🐛 Critical Fixes & Stability

[Core] Persistent Item Hashing:
    The Issue: Previously, item version hashes relied on JVM Enum objects, which changed hash codes on every server restart, forcing unnecessary mass-updates.
    The Fix: Switched to stable String-based hashing. Item versions now remain consistent across restarts.
[Visual] Lore Sync & Usage Limits:
    Fixed a logic error where the "Uses: 9/10" lore wouldn't visually update immediately after use.
    Added a needs_lore_update flag to ensure immediate refresh only when necessary.
[Visual] Custom Model Data (CMD): Removed obsolete NMS/Reflection checks for CMD assignment, fixing compatibility issues on newer versions.

⚠️ Migration & Compatibility Note

This update is Backward Compatible for BuffedItems configurations. However:
* [External Plugins] NBT Structure Update:
  * The Change: Due to the new persistent hashing system, the internal NBT tags of items have changed.
  * Impact: Plugins that rely on strict NBT matching (e.g., Shop Plugins) may not recognize old items.
  * Action Required: You must re-configure or re-add your custom items to your shop/trade plugins to ensure they are detected correctly.