ВЕРСИИ (8)

- Added `/ImprovedHoppers restore` command to recover broken hoppers, including permission `improvedhoppers.user.restore` and restore guidance messages. - Can be held or right-clicked with after command has ran. - Fixed MAJOR dupe exploit

- Add H2/MySQL storage options - Prevent self-transfer duplication

# ImprovedHoppers v1.1.1 – Performance & Stability Update This update focuses on performance optimizations, caching improvements, and safer handling of unloaded chunks, ensuring smoother operation and reduced server load. --- ## 🔑 Highlights ### Caching Enhancements - Cached transfer task rate lookups, transferable item checks, and smelt/fuel settings. - Cached disabled world configs, link distance checks, GUI particle colors, and particle color lookups. - Cached suction entity buckets, smelter values, hopper filter totals, and experience task nodes. - Added per-tick link resolution cache for transfer tasks. - Integrated primitive `LongHashSet` and long maps for efficient XP orb handling. ### Performance Optimizations - Optimized XP orb scanning and bucketing for experience hoppers. - Limited XP searches to boundary chunks to reduce overhead. - Batched hopper movement stat updates. - Avoided hopper holder lookups and simplified inventory detection. - Used live block states for inventories to improve accuracy. ### Stability & Compatibility - Guarded hopper transfers and particle rendering against unloaded chunks. - Prevented eager chunk loads when resolving containers or handling XP orbs. - Adjusted chunk loading behavior in transfer tasks. - Refined hopper activation checks. - Adjusted internals for Java 8 compatibility. ### User Experience - Return to the filter submenu automatically after linking a single item. - Experience bottles are now returned when breaking hoppers.

# 🧪 ImprovedHoppers v1.1.0 — The Bottled Experience & Localization Update A feature-rich update focused on **XP storage & bottling**, a **localization overhaul**, and lots of stability and integration improvements. ## ✨ Highlights - **Experience Storage & Bottling** - Store hopper-generated XP and **bottle it** directly from the menu. - Supports **partial withdrawals**, **per-XP bottle queues**, and localized metadata/lore. - PRs: #924, #925, #927, #928, #929, #930, #931, #932, #933 - **Localization Overhaul** - New `messages.yml` and **MessageService** powering **all** menus, prompts, and command feedback. - Covers settings, filters, links, network views, stats, admin/trusted menus, holograms, and more. - PRs: #820–#852 (selected) - **Compatibility & Integrations** - **Guarded hologram hook** when DecentHolograms isn’t present. (#806) - **Runtime particle adapter** and legacy-safe item metadata helpers. (#812, #809) - Graceful **NamespacedKey** handling on older servers. (#813, #814) - **1.21 shaped recipe category** support. (#815) - **Relaxed BentoBox startup gating**. (#818) - **Performance & Stability** - Coalesced **async hopper node saves** and prevented tasks from loading distant chunks. (#926, #934) - Reloads config **before** applying power settings. (#819) - Shared data directory **migration** for cleaner upgrades. (#807) - **UI/UX Tweaks** - New **main menu entrypoint** for hoppers. (#919) - **Back button** in filter browser; **Search** moved above **Simulate**. (#923, #922) - Trimmed settings button from filter list where redundant. (#920) - Compatibility icons (e.g., **Experience Bottle**, End Crystal, Redstone Torch). (#921, #903, #904) ## 🔧 Additional Improvements & Fixes (selected) - Refactors and helpers for sound/particle lookups across legacy runtimes. (#901, #911–#918) - Safer fallbacks for GUIs, icons, dyes, panes, and comparator/stats visuals on older servers. (#878–#882, #879, #880) - Misc. legacy guards (API availability, version detection) and cleanups. (#870, #877, #887, #883) ---

# 🚀 ImprovedHoppers v1.0.9 – Full Legacy & Modern Support Bringing **full compatibility from 1.8 through 1.21**, this update backports the plugin for legacy servers while retaining modern features. Now, ImprovedHoppers runs seamlessly across nearly every active Minecraft version. ## 🔑 Highlights - ✅ Full version support from **Minecraft 1.8 → 1.21** - ✅ Backported codebase to **Java 8** for maximum server compatibility - ✅ Added **versioned NMS adapters** for each legacy release - ✅ Introduced particle, sound, and GUI compatibility fallbacks for older servers ## 🛠 Technical Improvements - Added adapters for versions **1.8 → 1.21** ensuring stable support. - Backported features with **Java 8 compatibility** (compiler target set to 8). - Introduced **compatibility helpers** (particles, sounds, GUIs, icons, items). - Dual-shaded JARs with split descriptors for smoother legacy loading. - Refactored key handling and fallback guards for missing APIs on older servers. ## 🎉 Why This Matters This update makes ImprovedHoppers one of the **most version-flexible hopper plugins available**, giving server owners confidence whether they’re running cutting-edge 1.21 builds or long-standing 1.8 setups.

# ✨ Improved Hoppers – Release Notes This update introduces **full GUI localization support** and a new **Message Service** system to centralize and configure all in-game messages. ## 🔑 New Features - **`messages.yml`** file added for complete GUI text localization. - **Message Service** implemented to manage all configurable messages. ## 🛠 Enhancements All hopper menus, prompts, and system messages have been routed through the new message service, making them customizable and translatable: - Hopper settings, filter, fuel link, type change, and link detail menus - Network overview, item search, simulation, and stats menus - Trusted player management, admin tools, and hologram displays - Remote controller, command feedback, and link session messages - Place/break messages, unclaim warnings, and smelt unlock/queue alerts - Rename prompts, copy filter listeners, and other interactive prompts ## 🐛 Fixes & Stability - Corrected hopper management denial messages. - Localized hopper limit warnings. - Added safeguards for node saving when the data store is unavailable. ## 🙌 Special Thanks A huge thank you to [**Gudu666**](https://www.spigotmc.org/members/gudu666.2270401/) for suggesting this update!

# 📦 ImprovedHoppers – Update Release This update addresses several critical bugs and improves plugin reliability across different setups. ### 🛠 Fixes - **Hopper Filters & Holograms** - Fixed: Filters would not save to specified hoppers when *DecentHolograms* was not installed. - Fixed: On updating to a newer version, hoppers no longer revert to vanilla named hoppers—they now retain their ImprovedHoppers data. - **BentoBox Compatibility** - Fixed: Plugin no longer stalls on servers running *BentoBox* without AcidIsland. - Improved startup logic to properly handle alternative world names (e.g., `bskyblock_world`) instead of being locked to `acidisland_world`. - **Configuration Reload** - Fixed: Config watcher now properly reloads updated settings from disk. - Manual edits to `config.yml` are immediately recognized without requiring `/ImprovedHoppers reload`. --- ✅ With these fixes, ImprovedHoppers is now more stable, compatible, and responsive to server environments.

# 📦 ImprovedHoppers v1.0.6 ### ✨ New Features - **GitHub Release Update Checker** Integrated directly with GitHub releases to notify users when new versions are available. PR: #796 by @JakeHoolz - **Website Link in Update Notifications** Update messages now include a direct project website link for easier access. PR: #799 by @JakeHoolz ### ⚙️ Improvements - **Storage Prioritization** In *average mode*, storage links are now prioritized before void links for better consistency. PR: #797 by @JakeHoolz - **Startup Banner Enhancements** Update info is now shown directly in the startup banner for improved visibility. PR: #800 by @JakeHoolz - **Improved Release Parsing** More reliable parsing of release data during update checks. PR: #802 by @JakeHoolz - **API-Based Update Checker Restored** Restored API-based update checking for stability and accuracy. PR: #804 by @JakeHoolz ### 🐞 Fixes - **Update Checker Patterns** Fixed escaping issues with single quotes in update checker patterns. PR: #803 by @JakeHoolz - **Update Checker Tests** Rewritten to support JSON responses, improving validation robustness. PR: #805 by @JakeHoolz ### 🔧 Technical Enhancements - **Scraping GitHub Releases** Update checker now scrapes GitHub releases in addition to using the API, providing redundancy. PR: #798 by @JakeHoolz --- # 📦 Previous Releases ### v1.0.5 - Unified cleanup flow for remote/manual unclaims (loads hopper chunk, refunds smelts, clears containers, and returns Improved Hopper if inventory space allows; otherwise cancels with warning). - Remote controllers now validate ownership/trust before opening, preventing stale access. - Network menu quick links skip secondary destinations without coordinates, preventing `NullPointerException`. ### v1.0.4 - Fixed chest-linking issues when single → double chest conversion happens. - Prevented compilation failure caused by missing location comparison helper. - Streamlined test dependencies to remove Paper API conflicts. - Added planned logic to drop links when linked containers are destroyed. - Enhanced double-chest linking so links persist if one half is removed. ### v1.0.3 - Added **TransferMode enum** (`PRIORITY`, `AVERAGE`) for per-hopper item distribution control. - Expanded HopperNode to remember next destination index per material and mode. - Added GUI toggle for transfer mode display. - Updated smelt-output and transfer logic to rotate evenly in *AVERAGE* mode. - Persisted transfer mode across YAML and SQLite backends. ### v1.0.2 - Enabled Maven resource filtering (#769 by @JakeHoolz). - Dropped Improved Hopper item on node break (#770 by @JakeHoolz). ### v1.0.1 - **Seamless Startup:** Bundled `bStats` into plugin JAR, fixing `NoClassDefFoundError`. - **Modern Compatibility:** Standardized builds on Java 17 for Paper compatibility.