ZzaiClear

Zzclear is a lightweight, highly intelligent entity clearing and server optimization mod for Minecraft Fabric. It silently operates in the background to automatically sweep up dropped items, abandoned entities, and lag-inducing objects based on a highly configurable frequency timer. With a powerful in-game command system and hot-reloadable configuration logic, it eliminates server lag from its absolute source!

✨ Core Features

• 🕐 Automated Scheduled Clearing: Customize the sweeping cycles (down to the exact minute); when the timer strikes, lingering entities are flawlessly eradicated.
• 🛡️ Smart Whitelists & Filters: Say goodbye to "one-size-fits-all" wipes! Whether it's dropped items, specific monsters, or individual entity types, Zzclear supports precise bypassing and explicit targeting via its blacklist/whitelist arrays.
• 🐴 Rider Protection: Entities currently being ridden by players (horses, boats, minecarts, etc.) are automatically protected from clearing.
• ⏱️ Item Drop Immunity: Newly dropped items can be given a grace period to prevent them from being immediately swept up.
• 🌍 Dimension Filtering: Exclude specific dimensions (e.g., The End) from the sweep cycle entirely.
• 📊 Sweep Threshold: Skip the clearing cycle when the number of target entities is below a configurable minimum, avoiding unnecessary empty runs.
• 🌐 Bilingual Config: Config file comments support Chinese and English, controlled by the language field. Takes effect after /zzclear reload.
• 🪓 Total Entity Management:
  • Standard Clearing: Dropped Items, Experience Orbs
  • Mob Clearing: Hostile/Neutral Monsters, Passive Animals
  • Vehicles/Decorations: Boats, Paintings, Item Frames
  • Physics/Projectiles: Fired Arrows, Thrown Tridents, Falling Blocks, Primed TNT, Shulker Bullets, Firework Rockets, and more.
• 🔄 Hot-Reload Commands: Changing the configuration data file? No need to restart the server! A single built-in command applies the new rules instantly.

⌨️ In-Game Commands

The primary root command is /zzclear:

1. Configuration Reload (Admin)

/zzclear reload

• Function: Re-reads the config/config.json file from disk and immediately applies all new clearing filters, timer periods, and refreshes config comment language.

2. Check Clear Countdown (All Players)

/zzclear status

• Function: Shows the remaining time (minutes and seconds) until the next automatic sweep.

3. Manual Immediate Sweeping (Admin)

If you do not want to wait for the background timer intervals, use these commands to instantly wipe specific entity categories:

• /zzclear items — Instantly clears all dropped items on the ground.
• /zzclear monsters — Instantly clears all hostile and neutral monsters.
• /zzclear animals — Instantly clears all friendly, passive animals.
• /zzclear xps — Instantly clears all floating experience orbs.
• /zzclear others — Instantly clears miscellaneous entities (e.g., Paintings, Boats, Falling Blocks, Projectiles).

4. Item Whitelists (Admin)

Hold an item in your main hand and instantly register it into the whitelist filters to prevent the sweeper from ever consuming it:

• /zzclear white item add — Adds the currently held item into the global whitelist.
• /zzclear white item del — Removes the currently held item from the global whitelist.

5. Entity ID Whitelists (Admin)

If you need to meticulously protect or exclude a specific living organism or object (e.g., minecraft:zombie), utilize these endpoints:

• /zzclear white entity add <Entity ID> — Adds a specific entity registry ID into the whitelist.
• /zzclear white entity del <Entity ID> — Un-registers a specific entity registry ID from the whitelist.

Note: These commands fully support in-game Tab autocompletion suggestions!

🔑 Permission Nodes

Without LuckPerms, admin commands require OP level 4. With LuckPerms installed, use these permission nodes for fine-grained control:

⚙️ Configuration Setup

After launching the game once, the mod automatically generates the config file at:

<game root>/Zzclear/config/config.json

The config file includes comments in Chinese or English (controlled by the language field).

Common Settings

Item Settings

Mob Settings

Other Entity Settings

Tip: After tweaking the JSON config, jump right back into the game and fire /zzclear reload. Done instantly, with absolutely zero delays!