SerendiClear
No reviews yet
SerendiClear is a server-side [Fabric] mod for Minecraft 26.2+ that keeps your world clean — automatically removing dropped items and limiting mob stacking — all with a BossBar countdown and a convenient trash-bin GUI where items
Enhances game performance and optimizes resource usage.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Modrinth
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
SerendiClear
SerendiClear is a server-side Fabric mod for Minecraft 26.2+ that keeps your world clean — automatically removing dropped items and limiting mob stacking — all with a BossBar countdown and a convenient trash-bin GUI where items go before they vanish.
Features
- 🧹 Auto-cleanup — Configurable interval (default: every 30 minutes) sweeps item drops and excess mobs.
- ⏲️ BossBar Countdown — A visible BossBar warns all players before a cleanup (default: 60 seconds).
- 🗑️ Trash Bin GUI — Removed items are stored in a paginated chest GUI (
/垃圾桶) so players can reclaim them. - 👾 Mob Stack Limiting — Limits the number of the same mob type within a configurable radius (default: ≤24 per 16 blocks).
- 🛡️ Smart Protection — Named entities/items and configurable item IDs are never removed.
- 🌍 Multi-world — Target specific worlds or all worlds at once.
- 🎮 Manual Trigger —
/serendiclear clearstarts a cleanup on demand. - ⚙️ Hot-Reloadable Config —
/serendiclear reloadapplies config changes without a restart. - 🔌 Pure Server-Side — No client-side installation needed.
Commands
| Command | Permission | Description |
|---|---|---|
/serendiclear clear |
commands.gamemaster |
Manually start the cleanup countdown |
/serendiclear reload |
commands.gamemaster |
Reload the config file from disk |
/垃圾桶 |
(everyone) | Open the trash bin GUI to retrieve collected items |
The command
/垃圾桶is the Chinese word for "trash can." It can be aliased or changed in a future version.
Configuration
The config file is located at config/serendiclear.json. It is auto-generated with defaults on first run.
General Options
| Option | Type | Default | Description |
|---|---|---|---|
worlds |
string[] |
["all"] |
Worlds to clean. Set to ["all"] for all dimensions, or list specific ones (e.g. ["minecraft:overworld"]). |
intervalMinutes |
int |
30 |
Interval between automatic cleanups (minutes). Minimum: 1. |
broadcastSeconds |
int |
60 |
Countdown duration in seconds. Set to 0 for instant cleanup. |
prefix |
string |
"§9SerendiClear >> " |
Message prefix used in chat. |
bossbarTitle |
string |
"§e即将清理！倒计时: §c{time} §e秒" |
BossBar title. {time} is replaced with the remaining seconds. |
Item & Mob Options
| Option | Type | Default | Description |
|---|---|---|---|
clearDrops |
bool |
true |
Whether to remove loose item entities. |
clearMobs |
bool |
true |
Whether to enforce the mob stacking limit. |
maxMobStack |
int |
24 |
Maximum number of the same mob type allowed within mobStackRadius. |
mobStackRadius |
int |
16 |
Radius (in blocks) to detect stacked mobs. |
protectNamed |
bool |
true |
Whether named entities or renamed item stacks are skipped. |
protectedItems |
string[] |
[] |
Item IDs to never remove (e.g. ["minecraft:diamond", "minecraft:netherite_ingot"]). |
Trash Bin Options
| Option | Type | Default | Description |
|---|---|---|---|
trashEnabled |
bool |
true |
Enable the trash bin. When off, dropped items are simply deleted. |
trashMaxPages |
int |
5 |
Maximum number of trash bin pages (each page is a chest-size 54-slot grid). |
trashTitle |
string |
"§9§l垃圾桶 §7(第{page}/{max}页)" |
Title of the trash GUI. {page} and {max} are placeholders. |
trashOpenButton |
string |
"§e§l【点我打开垃圾桶】" |
Clickable chat message sent after a cleanup. |
trashExcludedWorlds |
string[] |
[] |
Worlds where no trash-bin message is sent. |
When the trash bin runs out of space (all pages full), it auto-clears and starts fresh. A notification is broadcast when this happens.
Installation
- Install Fabric Loader for Minecraft 26.2+.
- Place the
SerendiClear-<version>.jarinto your server'smods/folder. - Start the server — the mod is pure server-side and needs no client-side mod.
- Configure
config/serendiclear.jsonto your liking (it generates automatically).
Dependencies
- Fabric API (any version compatible with your Minecraft)
- Minecraft 26.2+
How It Works
- Tick loop — Every server tick, the mod checks if
intervalMinuteshave elapsed. - Countdown — When triggered, a BossBar appears and counts down for
broadcastSeconds. Players can use/垃圾桶in the meantime. - Cleanup — The mod iterates all loaded chunks in the target worlds:
- Drops: Removes unprotected
ItemEntityinstances and stores them in the trash bin. - Mobs: Groups living entities by type, finds clusters within
mobStackRadius, and removes the farthest excess members until the cluster meetsmaxMobStack.
- Drops: Removes unprotected
- Trash notification — After cleanup, a clickable chat button invites players to open the trash bin and reclaim their items.
Permission System
The mod uses Fabric API's built-in permission API at the commands.gamemaster level. Players with operator status (or granted this permission via a permission mod) can use the administrative commands.
License
This project is licensed under the MIT License.
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources