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:

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