SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedQuality of life & UI

CleanMaid

by orangemarvel0401 · for Minecraft

A configurable Minecraft cleanup utility mod.

1.2KDownloads
7 mo agoLast updated
MITLicense
NeoForgeLoaders

About CleanMaid

From Modrinth

A 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
  • /cleanmaid admin commands and shortcut command /ccb
  • Configurable broadcasts via actionbar / chat
  • Hidden Easter eggs and hidden advancements

Installation

  1. Install a Minecraft 1.21.1 server.
  2. Install NeoForge 21.1.222.
  3. Place the main Mod jar from the release page into the server's mods/ directory.
  4. 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 data

Game 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

LoaderGame versionsNewest
NeoForge1.21.11.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 catalog
Listed on Modrinth as “Mods”

Quality of life & UI

Small conveniences, tweaks and interface improvements players notice straight away.

Runs on your server

From source side support

Modrinth 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

CleanMaid, answered

Generated from the mod’s own source data.

Do my players need to install CleanMaid?

Modrinth lists CleanMaid as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

NeoForge.

Is it free?

Yes. CleanMaid is free to download from Modrinth. Its license is MIT.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run CleanMaid on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add CleanMaid in one click.