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!" ```

• 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. 🚀