🗑️ ClearBin – Smart Auto Item Removal System with Trash GUI

ClearBin is an advanced, performance-optimized Minecraft plugin that automatically removes dropped items while providing a modern Trash GUI system for players.

Designed for high-performance servers, ClearBin now includes Smart High RAM Mode, configurable warnings, and intelligent memory monitoring to prevent lag before it happens.

🚀 Why ClearBin?

Dropped items are one of the biggest causes of TPS drops and memory usage spikes on Minecraft servers.

ClearBin keeps your server optimized by:

• 🧹 Automatically clearing dropped items
• 📊 Monitoring RAM usage in real-time
• ⚡ Switching to faster clearing when memory is high
• 📦 Providing a clean Trash GUI
• 🔔 Sending configurable countdown warnings
• 🧠 Smart High RAM Mode (NEW)

ClearBin automatically detects when server RAM usage exceeds a defined threshold.

🧠 Smart High RAM Mode

How it works:

• When RAM usage exceeds 80% (configurable), ClearBin:
  • Switches to fast clear mode (5 minutes)
  • Notifies admins
• When RAM returns to normal:
  • Restores standard clear interval (10 minutes)

Fully Configurable:

high-ram-mode:
  enabled: true
  ram-threshold-percent: 80
  fast-interval-seconds: 300
  check-interval-seconds: 60

This makes ClearBin perfect for large PvP and SMP servers with high player counts.

⏱️ Automatic Clear System

Default settings:

auto-clear: true
interval-seconds: 600
clear-arrows: false
clear-xp: false

✔ Clear dropped items every 10 minutes
✔ Optional arrow clearing
✔ Optional XP orb clearing
✔ Manual force clear command

🔔 Countdown Warning System

Players receive broadcast warnings before items are cleared.

Default warning times:

• 60 seconds
• 30 seconds
• 10 seconds
• 5 → 1 second countdown

Fully configurable inside config.yml.

Example message:

Ground items will be cleared in 10 seconds!

📦 Trash GUI System

ClearBin includes a lightweight inventory-based Trash GUI.

Players can:

• Open trash with /clearbin
• Drag and drop unwanted items
• Instantly delete items
• Use permission-based access

Perfect for survival and PvP servers where players frequently need quick disposal.

🔐 Permissions

💬 Custom Messages System

Fully customizable prefix and messages:

prefix: "&8[&bClearBin&8] "
warning: "&cGround items will be cleared in %time% seconds!"
cleared: "&aRemoved %items% dropped items!"

Supports:

• Color codes
• Dynamic placeholders
• RAM usage display
• Item count display

💡 Smart Chat Suggestions

ClearBin can display helpful tips in chat:

• Remind players about /clearbin
• Inform about bypass permission
• Show how to check status
• Guide admins to force clear

Great for new players joining your server.

🎮 Perfect For

• PvP servers
• FFA arenas
• Survival SMP
• Prison
• SkyBlock
• Minigame networks
• Large servers with high RAM usage

⚡ Performance & Compatibility

• Lightweight & optimized
• Low memory footprint
• Asynchronous RAM checking
• Smart interval switching
• Compatible with Minecraft 1.13+

API version: 1.13
Main class: com.clearbin.ClearBin

📦 Installation

1. Download ClearBin
2. Place it in /plugins
3. Restart server
4. Configure config.yml

ClearBin keeps your server clean, optimized, and lag-free. 🚀