ВЕРСИИ (2)

# Recycler v2.1.0 ## 🐛 Bug Fixes - Fixed issue with legacy holograms not being properly removed when upgrading from older versions - Added comprehensive cleanup system to detect and remove leftover holograms - Improved hologram detection to identify various types of legacy hologram entities - Fixed issue where `/recycler hologram` command wasn't properly functioning for older hologram versions ## ✨ New Features - **Hologram Visibility Toggle**: Players can now use `/recycler hologram` to toggle hologram visibility - **Personal Preferences**: Hologram visibility settings are saved per-player between sessions - **Complete Tier Support**: Visibility toggle works with all chest tiers - **Player Privacy**: Keep your chest tiers private by hiding their holograms ## 🛠️ Admin Improvements - Added new admin command: `/recycleradmin hologram deep-cleanup` for thorough hologram entity cleanup - Enhanced hologram cleanup logic for better compatibility with older plugin versions - Improved server startup sequence with more efficient hologram management - Added detailed logging for hologram operations ## ⚙️ Configuration Updates - Added new `legacy_hologram_cleanup` setting in config.yml for automatic cleanup control - Implemented player preference storage for hologram visibility - **Customizable Chest Tiers**: Server administrators can now adjust existing chest tiers or create new ones through the config file - Extended tier configuration options including appearance, multipliers, and bonus chances ## 📋 How to Use Hologram Toggle - Type `/recycler hologram` to toggle visibility of all recycler chest holograms - Each player can have their own visibility preference - Other players' settings remain unaffected - Settings persist between server sessions ## 👨‍💻 For Server Administrators If upgrading from a previous version with hologram issues: 1. Ensure `legacy_hologram_cleanup: true` is set in your config.yml 2. Restart the server or use `/recycleradmin hologram deep-cleanup` 3. All hologram issues should be automatically resolved ### Custom Chest Tier Configuration Server administrators can now create and customize chest tiers in the config.yml: ```yaml chest-tiers: # Example of a custom tier (ID 5) 5: display_name: "&c&lMythic" value_multiplier: 3.0 bonus_chance: 0.2 color: "RED" chest_material: "CHEST" glow_effect: true ```

**Description** Recycler is a feature-rich economy plugin that transforms your server by adding a complete item recycling ecosystem. Turn unwanted items into money with tiered chests, boosters, auto-recycling, and detailed statistics!   **🔄 Key Features** - **Tiered Recycler Chests** - Four chest tiers with increasing rewards and unique visual effects - **Boosters System** - Server-wide and player-specific boosts with scheduled "Happy Hours" - **Auto-Recycling** - Configure items to be automatically recycled when picked up - **Statistics & Leaderboards** - Track personal and global recycling data - **Intuitive GUI** - Clean interface with real-time value calculations - **Visual Effects** - Custom particles, holograms, and sound effects - **Comprehensive Commands** - Full control for both players and admins - **Granular Permissions** - Complete permission system for server customization **💎 Recycler Chest Tiers** - **Basic**: 1.0× value multiplier - **Advanced**: 1.5× value multiplier, 5% bonus item chance - **Elite**: 2.0× value multiplier, 10% bonus item chance - **Ultimate**: 2.5× value multiplier, 15% bonus item chance Each tier has its own unique appearance, particles, and hologram display to enhance your server's aesthetic! **🚀 Boosters System** Make recycling more exciting with timed boosters: - **Player Boosters** - Give individual players recycling value boosts - **Server Boosters** - Boost recycling values for everyone on the server - **Happy Hours** - Schedule recurring boosted recycling periods - **Booster Announcements** - Automatic countdown and activation messages **📊 Statistics System** Keep track of all recycling activity on your server: - Personal and global recycling statistics - Top recyclers leaderboards - Most recycled items tracking - Total money earned from recycling - Detailed breakdowns of recycling activity **🤖 Auto-Recycling** Configure the plugin to automatically recycle specific items: - Add/remove materials from auto-recycle list - Toggle auto-recycling on/off - Set specific items to be instantly recycled upon pickup - Control which players have access to auto-recycling **📜 Commands** **Player Commands:** ``` /recycler open - Open the recycler interface /recycler stats - View your recycling statistics /recycler top [limit] - View top recyclers /recycler boosters - View active and upcoming boosters /recycler auto - Manage auto-recycling settings /recycler values - View item recycle values /recycler info - View plugin information /recycler help - Show command help ``` **Admin Commands:** ``` /recycleradmin give <player> <tier> - Give a recycler chest to a player /recycleradmin reload - Reload the configuration /recycleradmin stats [player] - View player statistics /recycleradmin globalstats - View global statistics /recycleradmin booster player <player> <multiplier> <minutes> - Give player booster /recycleradmin booster server <name> <multiplier> <minutes> - Create server booster /recycleradmin help - Show admin command help ``` **⚙️ Permissions** The plugin includes a complete permission system with granular control: ``` recycler.command - Use the main recycler command recycler.command.open - Open recycler GUI from command recycler.command.stats - View personal recycling statistics recycler.command.top - View top recyclers recycler.command.boosters - View active boosters recycler.command.auto - Configure auto-recycling recycler.command.values - View recycle values recycler.use - Use recycler chests recycler.break - Break recycler chests recycler.gui.use - Use the recycler GUI recycler.auto - Auto-recycle items recycler.admin - Use admin commands ``` **💡 Configuration** Easily configure the plugin to suit your server's economy: - Custom value for every material - Adjustable visual effects and messages - Scheduled Happy Hours configuration - Cooldown settings and statistics save intervals - Control which items can be recycled and their values **📦 Dependencies** - **Vault**: Required for economy integration - **Economy Plugin**: Any economy plugin compatible with Vault **🏗️ Server Integration Ideas** 1. Create recycling centers with tiered chests for different player ranks 2. Design special recycling events during Happy Hours with increased activity 3. Use recycling statistics as part of a server achievement system 4. Create specialized shops for different tiers of recycler chests 5. Integrate auto-recycling permissions into your server's rank system **🛠️ Installation** 1. Place the `Recycler.jar` file in your plugins folder 2. Restart your server 3. Configure the plugin settings in `plugins/Recycler/config.yml` 4. Enjoy a comprehensive recycling economy on your server! **💝 Support Development** If you find this plugin useful, consider: 1. Follow us in Modrinth 2. Rating the plugin 3. Sharing with other server owners **For support:** Join our Discord community - https://discord.gg/NJVHMSMR6m Made with ❤️ for the Minecraft community