Allow anonymous analytics?

Our cookieless analytics show us which features get used and store nothing on your device. We never sell your data or use it for advertising.

Privacy choices

Choose what ModDex may collect. You can change this anytime from Privacy choices in the footer.

Read the full privacy policy

Strictly necessary Required for the site to work: login sessions, security tokens, and abuse prevention. Always on and cannot be disabled. Always on
Analytics Cookieless analytics through PostHog's EU servers, used only to see which features get used. Nothing is stored on your device, and the anonymous visitor ID resets every day. Needs your consent because usage data goes to a third party. Never used for advertising or profiling. Off by default in the EU and UK.

Ground Item Cleaner

Quick rating

Community listing page, reviews may not be monitored by the author.

How listings work Are you the author?

Ground Item Cleaner

By Illama

No reviews yet

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.

Mod Loaders
Minecraft
Shockbyte server hosting: 35% off your first server with code MODDEX35 (opens in a new tab)

About

Description

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 mods folder. Players don't need it, and it works with vanilla clients joining a NeoForge server.
  • Singleplayer: put it in your mods folder, the integrated server runs it.
  • Requires NeoForge 21.1.x for Minecraft 1.21.1.
  • No dependencies.