Raven Cleaner

Raven Cleaner is a server-side optimization mod for NeoForge 1.21.1, featuring automatic, manual, and emergency cleanup of dropped items, mobs, and vehicles, with customizable settings, smart entity protection, and TAB integration.

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 (&#9B30FF).
  • 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.

Raven Cleaner Team

profile avatar
  • 6
    Projects
  • 1.1K
    Downloads

More from MaahzukaView all