ClearBin

🗑️ 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:

```yaml 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:

```yaml 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

| Permission | Description | Default | |-------------------|-----------------------------|---------| | clearbin.admin | Full admin access | OP | | clearbin.reload | Reload configuration | OP | | clearbin.clear | Force clear dropped items | OP | | clearbin.status | View next clear time | OP | | clearbin.bypass | Items won't be cleared | False | | clearbin.use | Use Trash GUI | True |

---

💬 Custom Messages System

Fully customizable prefix and messages:

```yaml 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+

Main class: 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. 🚀