# CleanMaid<\/p>\n
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.<\/p>\n
## Supported Versions<\/p>\n
– Minecraft `1.21.1`
\n– NeoForge `21.1.222`
\n– Java `21`<\/p>\n
## Main Features<\/p>\n
– Automatically clears dropped items and experience orbs on a timer
\n– Warning and countdown messages before cleanup
\n– Two-level batched cleanup: dimension-level batching + entity-type batching within each dimension
\n– Item blacklist\/whitelist and dimension blacklist\/whitelist
\n– Protection for newly dropped items, named items, and player death drops
\n– `\/cleanmaid` admin commands and shortcut command `\/ccb`
\n– Configurable broadcasts via actionbar \/ chat
\n– Hidden Easter eggs and hidden advancements<\/p>\n
## Installation<\/p>\n
1. Install a Minecraft `1.21.1` server.
\n2. Install NeoForge `21.1.222`.
\n3. Place the main Mod jar from the release page into the server’s `mods\/` directory.
\n4. Start the server. The configuration files will be generated in `config\/cleanmaid\/`.<\/p>\n
## Common Commands<\/p>\n
All commands require permission level `3` by default.<\/p>\n
“`text
\n\/cleanmaid help
\n\/cleanmaid clean
\n\/ccb
\n\/cleanmaid status
\n\/cleanmaid reload
\n\/cleanmaid set interval 60
\n\/cleanmaid set enabled true
\n\/cleanmaid set easter_egg false
\n“`<\/p>\n
Blacklist and whitelist:<\/p>\n
“`text
\n\/cleanmaid item blacklist add minecraft:dirt
\n\/cleanmaid item blacklist remove minecraft:dirt
\n\/cleanmaid item whitelist list
\n\/cleanmaid dimension blacklist add minecraft:the_nether
\n\/cleanmaid dimension whitelist add minecraft:overworld
\n\/cleanmaid dimension whitelist list
\n“`<\/p>\n
Targeted cleanup:<\/p>\n
“`text
\n\/cleanmaid clean dimension minecraft:the_nether
\n\/cleanmaid clean item minecraft:cobblestone
\n\/cleanmaid clean entity minecraft:experience_orb
\n\/cleanmaid clean force
\n“`<\/p>\n
## Configuration Files<\/p>\n
Configuration directory:<\/p>\n
“`text
\nconfig\/cleanmaid\/
\n“`<\/p>\n
Main files:<\/p>\n
“`text
\ncleanmaid-server.toml
\nblacklist.toml
\nwhitelist.toml
\n“`<\/p>\n
`cleanmaid-server.toml` controls scheduling, target entities, protection rules, display location, sounds, permissions, and the Easter egg toggle.<\/p>\n
`blacklist.toml` and `whitelist.toml` store both items and dimensions:<\/p>\n
“`json
\n{
\n “items”: [],
\n “dimensions”: []
\n}
\n“`<\/p>\n
## Blacklist and Whitelist Rules<\/p>\n
– blacklist = must be cleaned
\n– whitelist = protected and will not be cleaned
\n– blacklist has higher priority than whitelist<\/p>\n
Default items:<\/p>\n
– blacklist: `minecraft:cobblestone`, `minecraft:dirt`
\n– whitelist: `minecraft:diamond`, `minecraft:netherite_ingot`<\/p>\n
## Build<\/p>\n
“`powershell
\n.\\gradlew.bat build
\n“`<\/p>\n
Build artifacts are located in:<\/p>\n
“`text
\nbuild\/libs\/
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
A configurable Minecraft cleanup utility mod.<\/p>\n","protected":false},"featured_media":41051,"template":"","meta":{"_minecraft_slug":"cleanmaid","_minecraft_project_id":"rvq3ytpo","_minecraft_author":"orangemarvel0401","_minecraft_license":"MIT","_minecraft_downloads":40,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"cleanmaid.zip","_minecraft_size_bytes":1703865,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T13:49:21.000964Z","_minecraft_date_created":"2026-05-03T17:20:32.242519Z","_minecraft_date_modified":"2026-04-27T11:42:04.069153Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/cleanmaid","_minecraft_icon_attachment_id":41051,"_minecraft_imported_at":"2026-06-01T22:24:30+00:00","_minecraft_import_hash":"6f3fb6991b5fcdbbf98d8713f23fd66b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,158,90],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-41050","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-neoforge","mod_category-optimization","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n