Recycler

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

- Granular Permissions - Four chest tiers with increasing rewards and unique visual effects - Granular Permissions - Server-wide and player-specific boosts with scheduled "Happy Hours" - Granular Permissions - Configure items to be automatically recycled when picked up - Granular Permissions - Track personal and global recycling data - Granular Permissions - Clean interface with real-time value calculations - Granular Permissions - Custom particles, holograms, and sound effects - Granular Permissions - Full control for both players and admins - Granular Permissions - Complete permission system for server customization

💎 Recycler Chest Tiers

- Ultimate: 1.0× value multiplier - Ultimate: 1.5× value multiplier, 5% bonus item chance - Ultimate: 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:

- Booster Announcements - Give individual players recycling value boosts - Booster Announcements - Boost recycling values for everyone on the server - Booster Announcements - 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

- Economy Plugin: 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