ClearLag+

A modern, lightweight and highly configurable cleanup plugin for Paper 26.2 servers.

ClearLag Plus focuses on safe ground-item cleanup by default, with configurable entity cleanup, countdown warnings, whitelists, protected entities, multilingual messages, PlaceholderAPI support, and powerful manual cleanup commands.

✨ Features

• Automatic ground-item cleanup
• Configurable cleanup interval
• Customizable countdown warnings
• Item whitelist
• Minimum item age
• Optional entity cleanup
• Optional mob cleanup
• Projectile & XP Orb cleanup
• Named entity protection
• Tamed entity protection
• Leashed entity protection
• Entity whitelist
• Aggressive "/clear nuke" cleanup with confirmation
• Per-world cleanup settings
• Configurable batch cleanup for better performance
• Modern status command
• Fully configurable messages
• Multilingual support
• PlaceholderAPI integration
• Lightweight and standalone
• No economy plugin required

🌍 Supported Languages

ClearLag Plus currently includes:

• 🇬🇧 English ("en") — Default
• 🇮🇩 Indonesian ("id")
• 🇨🇳 Chinese ("zh")
• 🇷🇺 Russian ("ru")
• 🇵🇹 Portuguese ("pt")
• 🇩🇪 German ("de")

Change the language in-game with:

/clear language /clear language

Example:

/clear language id

💬 Commands

Main Command

/clear

Help

/clear help

Clear Ground Items

/clear item

Clear Configured Entities

/clear entity

Aggressive Entity Cleanup

/clear nuke /clear nuke confirm

View Status

/clear status

Reload Configuration

/clear reload

Language

/clear language /clear language

Aliases

/clearlag /clag /clearlagplus

🔐 Permissions

Permission| Description| Default "clearlagplus.use"| Access to basic "/clear" help| Everyone "clearlagplus.item"| Clear dropped items| OP "clearlagplus.entity"| Clear configured entities| OP "clearlagplus.nuke"| Use aggressive nuke cleanup| OP "clearlagplus.status"| View ClearLag status| OP "clearlagplus.reload"| Reload configuration and messages| OP "clearlagplus.language"| View/change plugin language| OP "clearlagplus.admin"| Full ClearLag Plus access| OP "clearlagplus.bypass"| Bypass world cleanup restrictions| OP

"clearlagplus.admin" includes the main ClearLag Plus permissions.

🔌 PlaceholderAPI

PlaceholderAPI is supported as an optional soft dependency.

PlaceholderAPI is not required for ClearLag Plus to function.

Expansion identifier:

clearlagplus

Available Placeholders

%clearlagplus_total_entities% %clearlagplus_total_items% %clearlagplus_total_mobs% %clearlagplus_total_projectiles% %clearlagplus_total_xp_orbs%

%clearlagplus_last_removed% %clearlagplus_last_items% %clearlagplus_last_entities% %clearlagplus_last_duration% %clearlagplus_last_world%

%clearlagplus_cleanup_count% %clearlagplus_total_removed% %clearlagplus_total_items_removed% %clearlagplus_total_entities_removed%

%clearlagplus_next_clear% %clearlagplus_next_clear_seconds% %clearlagplus_interval% %clearlagplus_auto_clear% %clearlagplus_status%

%clearlagplus_tps% %clearlagplus_mspt%

%clearlagplus_world_entities% %clearlagplus_world_items%

Placeholders are designed to use cached plugin statistics rather than performing expensive full scans every time they are requested.

⚙️ Default Configuration

By default, ClearLag Plus runs automatic cleanup every 180 seconds and only removes dropped items.

auto-clear: enabled: true interval: 180

cleanup: dropped-items: true entities: false mobs: false

item-whitelist:

• BEACON
• DRAGON_EGG

Entity and mob cleanup are disabled by default to avoid accidentally removing important entities.

🛡️ Safe Cleanup

ClearLag Plus protects important entities by default, including:

• Players
• Named entities
• Tamed entities
• Leashed entities
• Villagers
• Wandering Traders
• Armor Stands
• Item Frames
• Glow Item Frames

The cleanup system is configurable so server owners can decide exactly what may be removed.

🚨 Nuke Cleanup

For administrators who need a more aggressive entity cleanup:

/clear nuke

ClearLag Plus requires confirmation by default:

/clear nuke confirm

The nuke system includes a configurable cooldown and optional countdown.

Players and protected entities are never intentionally targeted by the cleanup system.

📊 Status & Monitoring

Use:

/clear status

to view information such as:

• Auto-clear status
• Cleanup interval
• Next cleanup
• Ground item count
• Loaded entity count
• Last cleanup statistics
• TPS
• MSPT

🎨 Modern Message System

Messages use a clean color hierarchy:

• Aqua — ClearLag Plus branding
• Gray — descriptions and labels
• White — important values
• Green — success
• Yellow — warnings
• Red — dangerous actions
• Dark Gray — separators and muted information

All messages are configurable through the language files.

📁 Configuration

Main configuration:

plugins/ClearLagPlus/config.yml

Language files:

plugins/ClearLagPlus/messages/en.yml plugins/ClearLagPlus/messages/id.yml plugins/ClearLagPlus/messages/zh.yml plugins/ClearLagPlus/messages/ru.yml plugins/ClearLagPlus/messages/pt.yml plugins/ClearLagPlus/messages/de.yml

🧩 Dependencies

Required

None

Optional

PlaceholderAPI

ClearLag Plus works independently without PlaceholderAPI.

🖥️ Compatibility

• Paper 26.2
• Java 25
• Modern Paper servers
• Standalone plugin

Author: KingBrezz

Version: 1.0.0