Ground Item Cleaner
- By
Server-side: clears dropped items lying on the ground every 5 minutes, with chat warnings at 5 min, 1 min, 30 s and a 5-4-3-2-1 countdown. Items on conveyors, belts, hoppers and funnels are left alone.
Summary:
Server-side: clears dropped items lying on the ground every 5 minutes, with chat warnings at 5 min, 1 min, 30 s and a 5-4-3-2-1 countdown. Items on conveyors, belts, hoppers and funnels are left alone.
Why
On a busy server, dropped items pile up everywhere: mob drops, broken blocks, junk thrown on the floor. Every one of them is an entity the server has to tick, and they end up costing TPS. This mod cleans them up on a fixed timer and always warns players first, so nobody loses their loot by surprise.
What it does
- Every 5 minutes, it removes item entities lying on the ground in every dimension.
- Chat warnings with a short sound:
- 5 minutes before (sent right after the previous clean, or when the server starts);
- 1 minute before;
- 30 seconds before;
- then a countdown: 5… 4… 3… 2… 1…
- Summary after each clean: « X objet(s) au sol supprimé(s) ».
What it never removes
- Items on conveyors and machines, recognised by the block they sit on or in: conveyor belts, belts, funnels, chutes, depots, tunnels, hoppers, sorters, elevators… The block list is a config regex. Items riding Create belts are not ground items at all, so they are never touched.
- Display items: items with unlimited lifetime, as used by shops and showcases.
- Protected items from a config list. By default: Nether Star, Dragon Egg and every Shulker Box.
Commands
| Command | Who | Effect |
|---|---|---|
/nettoyage |
everyone | Shows the time left before the next clean. |
/nettoyage maintenant |
operators | Cleans right now and restarts the timer. |
/nettoyage reporter |
operators | Restarts the timer without cleaning. |
Configuration
The config file is serverconfig/nettoyagesol-server.toml in your world folder:
| Option | Default | Description |
|---|---|---|
intervalleMinutes |
5 |
Minutes between two cleans (1 to 1440). |
avertissementsSecondes |
[300, 60, 30] |
Chat warnings, in seconds before the clean. A value equal to the interval is sent right after the previous clean. |
compteARebours |
5 |
Final countdown in seconds (0 = none). |
son |
true |
Short sound for warnings and countdown. |
blocsProteges |
conveyors, belts, hoppers… | Regex on block IDs: items on or inside these blocks are never removed. |
objetsProteges |
Nether Star, Dragon Egg, *shulker_box |
Items never removed (IDs, * wildcard allowed). |
messages.* |
French texts | Every chat message can be rewritten, color codes (§) included. |
The default messages are in French. Change them in the messages section to use another language.
Installation
- Server only. Put the jar in the server's
modsfolder. Players don't need it, and it works with vanilla clients joining a NeoForge server. - Singleplayer: put it in your
modsfolder, the integrated server runs it. - Requires NeoForge 21.1.x for Minecraft 1.21.1.
- No dependencies.
Ground Item Cleaner Team
