About CleanMaid
From ModrinthA configurable Minecraft cleanup utility mod.
CleanMaid
CleanMaid is a lightweight Minecraft server-side cleanup mod. Like a diligent maid on duty, it cleans dropped items and entities according to your configuration, reducing server load caused by entity buildup.
Supported Versions
- Minecraft
1.21.1 - NeoForge
21.1.222 - Java
21
Main Features
- Automatically clears dropped items and experience orbs on a timer
- Warning and countdown messages before cleanup
- Two-level batched cleanup: dimension-level batching + entity-type batching within each dimension
- Item blacklist/whitelist and dimension blacklist/whitelist
- Protection for newly dropped items, named items, and player death drops
/cleanmaidadmin commands and shortcut command/ccb- Configurable broadcasts via actionbar / chat
- Hidden Easter eggs and hidden advancements
Installation
- Install a Minecraft
1.21.1server. - Install NeoForge
21.1.222. - Place the main Mod jar from the release page into the server's
mods/directory. - Start the server. The configuration files will be generated in
config/cleanmaid/.
Common Commands
All commands require permission level 3 by default.
/cleanmaid help
/cleanmaid clean
/ccb
/cleanmaid status
/cleanmaid reload
/cleanmaid set interval 60
/cleanmaid set enabled true
/cleanmaid set easter_egg false
Blacklist and whitelist:
/cleanmaid item blacklist add minecraft:dirt
/cleanmaid item blacklist remove minecraft:dirt
/cleanmaid item whitelist list
/cleanmaid dimension blacklist add minecraft:the_nether
/cleanmaid dimension whitelist add minecraft:overworld
/cleanmaid dimension whitelist list
Targeted cleanup:
/cleanmaid clean dimension minecraft:the_nether
/cleanmaid clean item minecraft:cobblestone
/cleanmaid clean entity minecraft:experience_orb
/cleanmaid clean force
Configuration Files
Configuration directory:
config/cleanmaid/
Main files:
cleanmaid-server.toml
blacklist.toml
whitelist.toml
cleanmaid-server.toml controls scheduling, target entities, protection rules, display location, sounds, permissions, and the Easter egg toggle.
blacklist.toml and whitelist.toml store both items and dimensions:
{
"items": [],
"dimensions": []
}
Blacklist and Whitelist Rules
- blacklist = must be cleaned
- whitelist = protected and will not be cleaned
- blacklist has higher priority than whitelist
Default items:
- blacklist:
minecraft:cobblestone,minecraft:dirt - whitelist:
minecraft:diamond,minecraft:netherite_ingot
Build
.\\gradlew.bat build
Build artifacts are located in:
build/libs/Highlights
From source dataGame versions
Built for Minecraft 1.21.1.
Loaders
Runs on NeoForge.
Footprint
Rated a light load on a server.
CleanMaid on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- NeoForge
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.0.0, released 2026-04-27
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| NeoForge | 1.21.1 | 1.21.1 |
From 1 recorded build of CleanMaid.
Run CleanMaid on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogQuality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Runs on your server
From source side supportModrinth lists CleanMaid as required on the server. Check its Modrinth page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- NeoForge
- Runs on
- Serverrequired on the server
- Game versions
- 1.21.1
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-17Open ↗
- ✓Authororangemarvel0401, as published on Modrinth
- ✓LicenseMITFree












