--- # ♻ RecyclePlugin — v3.0.1 ## 🛠 Stability & Code Quality Small follow-up to the v3.0.0 platform migration. No gameplay or config changes — internal robustness fixes only. ### Fixed - Potential NullPointerException when resolving the fallback sound key for a configured sound effect with no explicit `sound` entry - Plugin startup looked up `/recycle` and `/rpadmin` commands twice instead of reusing the result, which could theoretically return inconsistent state between the two lookups ### Improved - Narrowed several overly broad `catch (Exception e)` blocks (sound/particle resolution, numeric config parsing) down to the exact exception type each call site can throw --- # ♻ RecyclePlugin — v3.0.0 ## 🧱 PLATFORM MIGRATION — Paper 26.2 / MC 26.2 / JDK 25 This release migrates RecyclePlugin to the current Paper/Minecraft platform, following Mojang/Paper's switch to year-based versioning in 2026. - 🔧 Build target bumped to JDK 25 (`maven.compiler.release`) - 📦 `paper-api` dependency bumped from `1.21.11-R0.1-SNAPSHOT` to `26.2.build.121-stable` - 📝 `plugin.yml` `api-version` bumped from `1.21` to `26.2` - ✅ Full codebase audit against the new API — no removed or deprecated methods found (verified via `javac -Xlint:deprecation -Xlint:removal` against the real `paper-api-26.2` jar) - 🚫 No gameplay or configuration logic changed — this is a platform compatibility release only ### Why a major bump This is a breaking compatibility change: builds targeting JDK 25 / Paper 26.2 will no longer run on older Paper/Minecraft servers (pre-26.2), so the major version reflects that boundary rather than new features. ---

# ♻ RecyclePlugin v2.0.1 — Bugfix Update > 🛠 Stability and consistency improvements --- ## 🛠 Fixed - Fixed **stack handling** - Rewards now correctly scale with item amount (e.g. 64 arrows → correct output) - Fixed **preview desync** - GUI preview now matches actual rewards on confirm - Fixed **XP calculation** - XP now scales properly with stack size - Fixed **duplicate reward issue** - No more extra items added on confirm --- ## 🔄 Improved - Update checker reliability - Reduced cache issues when fetching latest version - Internal calculation consistency - Preview and execution now use the same logic --- ## ⚠ Notes - No config changes required - Fully compatible with v2.0.0 configs --- 💥 Small patch, big impact — stable and consistent recycling system.

# ♻ RecyclePlugin v2.0.0 — Full Rewrite # **⚠ Migration Notice** _> 🔥 Massive update — complete rewrite of the plugin architecture_ v2.0.0 introduces a completely new config structure. If you are upgrading from v1.x: - Old configs are no more supported - It is strongly recommended to: 1. Delete your old config.yml, lang files. 2. Restart the server 3. Reconfigure using the new system No support for errors using old config.yml and lang files. --- ## 🚀 Highlights - ⚙ Fully config-driven system - 🖥 Custom GUI fully configurable - 💾 Persistent player stats (no more resets) - 🔄 Live reload support (`/rpadmin reload`) - ✨ Configurable sounds & particles - 🧠 Clean and scalable architecture --- ## 🆕 Added - **100% configurable GUI** - Layout, items, actions, dynamic elements - **Recycling preview system** - Live reward preview in GUI - **Persistent stats system** - Stored in `data/stats.yml` - Tracks total recycled items per player - **Lucky system** - Chance-based reward multiplier - **Cooldown system** - **Update Checker** - Console + OP notifications - **Tab completion** - `/rpadmin reload` --- ## 🔄 Changed - Complete rewrite of plugin core - Reworked recycling logic (clean, deterministic, no desync) - Improved durability-based reward calculation - Reworked XP system (rarity-based + enchant scaling) - Refactored GUI system (no hardcoded elements) --- ## 🛠 Fixed - Fixed reward desync between preview and confirm - Fixed duplicate reward bug - Fixed stats reset on server restart - Fixed GUI refresh inconsistencies - Fixed sound/particle compatibility (modern registry) --- ## ⚙ Config - New structure: - config.yml → full control (gui + recycle + effects + messages) - data/stats.yml → player stats - Legacy compatibility supported (`items:` fallback) --- ## ⚠ Breaking Changes - Old configs may require update - GUI is now fully config-based - Some keys renamed for consistency --- ## 📈 Performance - Reduced allocations in GUI refresh - Optimized recycling calculations - Cleaner event handling --- ## 🔮 Roadmap - Economy support (Vault) - Money rewards option - Leaderboards (`/recycle top`) - PlaceholderAPI support - Per-item custom behaviors - Advanced permissions --- ## 💬 Notes This version lays the foundation for future expansion. The plugin is now modular, scalable, and ready for public servers. --- 💥 **v2.0.0 = stable, clean, and production-ready**

⚠️ Important If you update from an older version, run: /rpadmin reload to sync missing language keys. Delete old lang folder if needed.

Release v1.1.0 - Robust language fallback system - Automatic configuration correction for invalid language values - Active language tracking for accurate logging - Styled console startup/reload/shutdown logs - Permission validation improvements - Protection against recycling unregistered items - Improved stability and null safety