Saro´s Clearlag

Saro’s Clearlag is a powerful server-side optimization mod designed to keep your Minecraft server running smoothly by automatically clearing lag-causing entities. With highly customizable intervals, blacklists, and whitelists, you have complete control over what gets cleared and when. Perfect for both vanilla and modded servers!

• Automatic Entity Clearing 🔄
• Set custom intervals to automatically clear entities and keep your server lag-free.
• Configurable warning system alerts players before entities are cleared.

• Smart Filtering System 🎯
• Choose between blacklist or whitelist mode for precise control.
• Protect specific entity types from being cleared.
• Full support for modded entities from any mod!

• Advanced Protection 🛡️
• Automatically protect named entities (like named pets).
• Keep tamed animals safe from clearing.
• Protect leashed entities.
• Set protection radius around players.

• Flexible Configuration ⚙️
• Configure which entity types to clear: items, mobs, projectiles, boats, minecarts, XP orbs.
• Customize warning messages and clear notifications.
• Adjust all settings via easy-to-use config file.

• Server-Side Only 🖥️
• Clients don’t need the mod installed to connect!
• Perfect for server administrators.
• Can also be used client-side for single-player optimization.

Clearable Entity Categories:

• Items 📦: Dropped items on the ground
• Hostile Mobs 👾: Zombies, skeletons, creepers, and more
• Projectiles 🏹: Arrows, snowballs, and other thrown items
• Vehicles 🚂: Boats and minecarts
• Experience Orbs ✨: XP orbs from mining and mob kills
• Custom Mod Entities 🔧: Full support for entities from other mods!

All commands require OP level 2 (operator permissions)

• /clearlag clear: Manually clear entities immediately
• /clearlag info: Display current configuration settings
• /clearlag count: Count how many entities would be cleared
• /clearlag timer: Show time remaining until next automatic clear
• /clearlag reset: Reset the automatic clear timer
• /clearlag reload: Reload configuration from file
• /clearlag help: Display command help

Configuration File Location:
The config file is automatically generated at: config/sarosclearlag-common.toml

Key Configuration Options:

Auto-Clear Settings:

• Enable/disable automatic clearing
• Set interval between clears (30-3600 seconds)
• Configure warning messages and timing

Entity Filtering:

• Choose blacklist or whitelist mode
• Add entity types using format: minecraft:entity_type or modid:entity_type
• Examples: minecraft:zombie, minecraft:item, create:contraption

Protection Settings:

• Protect named entities
• Protect tamed animals
• Protect leashed entities
• Set protection radius around players

Message Customization:

• Customize clear messages (use {count} for entity count)
• Customize warning messages (use {time} for seconds remaining)
• Enable/disable broadcast messages

Example Use Cases:

🎮 Survival Server: Clear dropped items and hostile mobs every 5 minutes while protecting named pets and items near players.

🏗️ Creative Server: Clear only projectiles and XP orbs to prevent lag from player experiments.

⚔️ PvP Server: Clear items and mobs frequently but protect items near players with a protection radius.

Currently Supported

• Forge 1.20.1 ✅

More versions coming soon!

Join our community on Discord to give feedback and suggestions or report any bugs you find!

Project Support & Usage

Hosting: For the best performance, I recommend using BisectHosting linked in the banner.

Modpacks: You are free to include my work in any modpack. Please ensure proper credit is given by providing a link to this project page.