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