Raven Cleaner
Keep your Minecraft server clean, optimized, and running smoothly!
Raven Cleaner is a powerful, highly configurable server-side optimization mod for Minecraft 1.21.1 (NeoForge), designed to reduce entity-related lag and help prevent performance issues caused by excessive dropped items, mobs, and abandoned vehicles.
Inspired by popular server cleanup solutions like ClearLag, Raven Cleaner brings automated cleanup, emergency protection, intelligent entity filtering, and customizable notifications to NeoForge servers.
๐ฆ Required Dependencies
The following mods are required for Raven Cleaner to work properly:
- FTB Chunks โ Chunk claiming and protected-area integration.
- FTB Teams โ Team management integration.
- FTB Library โ Core library for FTB mods.
- FTB XMod Compat โ Compatibility support between FTB mods and other modifications.
- Architectury API โ Cross-mod compatibility and development library.
Important: Install compatible NeoForge 1.21.1 versions of all required dependencies before starting your server.
The TAB mod is optional and only needed for scoreboard and placeholder integration.
โจ Features
๐งน Automatic Cleanup
- Automatically removes eligible dropped items, mobs, and abandoned vehicles.
- Fully configurable cleanup intervals.
- Customizable countdown announcements before each cleanup.
- Displays detailed results, including removed drops, item quantities, mobs, vehicles, and execution time.
- Supports temporary pausing and resuming.
โก Emergency Cleanup
- Detects excessive dropped items before they overwhelm the server.
- Automatically triggers emergency cleanup when configurable thresholds are reached.
- Includes cooldowns and batch processing to reduce performance spikes.
- Works inside player chunks and FTB Chunks claims, preventing overloaded mob farms from accumulating thousands of dropped items.
๐ก๏ธ Smart Mob Protection
Raven Cleaner includes safety rules designed to preserve important entities.
- Protects named mobs, tamed animals, villagers, bosses, and NPCs from other mods.
- Supports FTB Chunks protection for regular mob and vehicle cleanup.
- Detects excessive concentrations of the same mob type within individual chunks.
- Allows configurable emergency mob cleanup thresholds.
Example: If a chunk contains 10 zombies, 30 witches, and 10 skeletons, the cleaner can remove the eligible witches while preserving the other mob types.
๐ค Vehicle Cleanup
- Supports abandoned boats and minecarts.
- Configurable cleanup rules.
- Respects protected areas and player proximity settings.
๐ฌ Customizable Announcements
Keep players informed before and after every cleanup.
- Configurable countdown warnings.
- Custom completion messages and cleanup statistics.
- Minecraft color codes, HEX colors, gradients, and text formatting.
- Editable message templates and placeholders.
๐ Multi-Language Support
- English (
en_us) โ Default language. - Brazilian Portuguese (
pt_br) โ Included translation. - Fully editable language files.
- Switch languages through the configuration without restarting the server.
๐ TAB Integration
Optional integration with the TAB mod, allowing server owners to display Raven Cleaner information in scoreboards, tab lists, bossbars, and other supported displays.
Available placeholders:
%ravencleaner_status%%ravencleaner_running%%ravencleaner_next_cleanup%%ravencleaner_next_seconds%%ravencleaner_last_drops%%ravencleaner_last_units%%ravencleaner_last_mobs%%ravencleaner_last_vehicles%%ravencleaner_last_total%
โ๏ธ Commands
| Command | Description |
|---|---|
/cleaner status |
Displays the current cleaner status |
/cleaner analyze |
Analyzes entities eligible for cleanup |
/cleaner clean items |
Removes eligible dropped items |
/cleaner clean mobs |
Removes eligible mobs |
/cleaner clean vehicles |
Removes eligible vehicles |
/cleaner clean all |
Runs a complete cleanup |
/cleaner pause |
Pauses automatic cleanup |
/cleaner resume |
Resumes automatic cleanup |
/cleaner reload |
Reloads configuration and language files |
๐ง Configuration
Raven Cleaner provides a highly configurable TOML configuration file with detailed comments explaining each option.
Server administrators can customize:
- Automatic cleanup intervals.
- Emergency cleanup thresholds.
- Entity filters and protection rules.
- Mob concentration limits per chunk.
- Vehicle cleanup settings.
- Maximum entities removed per tick.
- Countdown announcements.
- Custom messages and formatting.
- Language selection.
- TAB placeholder integration.
Changes can be applied using /cleaner reload, without restarting the server.
๐จ Message Formatting
Raven Cleaner supports advanced message formatting, including:
- Traditional Minecraft color codes (
&a,&b,&c, etc.). - Bold (
&l), italic (&o), underline (&n), and reset (&r). - HEX colors (
	B30FF). - Custom gradients (
<gradient:#9B30FF:#00E5FF>Text</gradient>). - Dynamic placeholders for cleanup statistics and countdowns.
๐ฆ Compatibility
| Requirement | Details |
|---|---|
| Minecraft | 1.21.1 |
| Mod Loader | NeoForge |
| Java | 21 |
| Environment | Dedicated Server |
| Client Installation | Not required for Raven Cleaner itself |
| Required Mods | FTB Chunks, FTB Teams, FTB Library, FTB XMod Compat, Architectury API |
| Optional Integration | TAB |
๐ Built for Better Server Performance
Whether you're running a small survival server or a large modded Minecraft network, Raven Cleaner gives you greater control over entity accumulation while protecting important parts of your world.
From automatic dropped-item removal to emergency mob concentration detection, every feature is designed to help administrators maintain cleaner and more stable Minecraft worlds.
Less clutter. Better performance. More control.
Raven Cleaner โ Keep your world clean.