Zzclear 是一款轻量级、高度智能的实体清理与服务器优化模组,适用于 Minecraft Fabric。 它在后台静默运行,基于高度可配置的频率计时器,自动拾取掉落的物品、废弃的实体以及导致卡顿的对象。凭借强大的内置命令系统和支持热重载的配置逻辑,它从根源上消除了服务器卡顿!
✨ 核心功能
- ? 自动化定时清理: 自定义清理周期(精确到分钟);当计时器触发时,滞留的实体将被完美清除。
- ?️ 智能白名单与过滤器: 告别“一刀切”式的清理!无论是掉落物、特定怪物还是各类实体,Zzclear 都支持通过黑名单/白名单数组进行精确绕过和明确指定。
- ? 骑手保护: 当前正被玩家骑乘的实体(如马、船、矿车等)会自动受到保护,免于被清理。
- ⏱️ 物品掉落免疫: 新掉落的物品可以设置一段宽限期,防止它们被立即拾取。
- ? 维度过滤: 完全排除特定维度(例如末地)参与清理周期。
- ? 清理阈值: 当目标实体数量低于可配置的最小值时,跳过清理周期,避免不必要的空跑。
- ? 双语配置: 配置文件注释支持中文和英文,由
language字段控制。在/zzclear reload后生效。 - ? 全实体管理:
- 标准清理: 掉落物、经验球
- 生物清理: 敌对/中立怪物、被动动物
- 载具/装饰: 船、画作、物品展示框
- 物理/投射物: 射出的箭、投掷的鱼叉、下落的方块、已点燃的 TNT、潜影贝弹丸、烟花火箭等。
- ? 热重载命令: 更改了配置文件数据?无需重启服务器!一条内置命令即可即时应用新规则。
⌨️ 游戏内命令
主要根命令为 /zzclear:
1. 配置重载 (管理员)
/zzclear reload
- 功能: 从磁盘重新读取
config/config.json文件,并立即应用所有新的清理过滤器、计时器周期,同时刷新配置注释语言。
2. 查看清理倒计时 (所有玩家)
/zzclear status
- 功能: 显示距离下一次自动清理剩余的时间(分钟和秒)。
3. 手动立即清理 (管理员)
如果您不想等待后台计时器间隔,请使用以下命令即时清除特定的实体类别:
/zzclear items— 即时清除地面上所有的掉落物。/zzclear monsters— 即时清除所有的敌对和中性怪物。/zzclear animals— 即时清除所有的友好、被动动物。/zzclear xps— 即时清除所有漂浮的经验球。/zzclear others— 即时清除杂项实体(例如:画作、船、下落的方块、投射物)。
4. 物品白名单 (管理员)
在主手中持有物品,并将其瞬间注册到白名单过滤器中,以防止清理程序消耗该物品:
/zzclear white item add— 将当前手持的物品添加到全局白名单中。/zzclear white item del— 从全局白名单中移除当前手持的物品。
5. 实体 ID 白名单 (管理员)
如果您需要细致地保护或排除特定的生物或对象(例如 minecraft:zombie),请使用这些端点:
/zzclear white entity add <Entity ID>— 将特定的实体注册表 ID 添加到白名单中。/zzclear white entity del <Entity ID>— 从白名单中注销特定的实体注册表 ID。注意:这些命令完全支持游戏内的 Tab 自动补全建议!
? 权限节点
如果没有安装 LuckPerms,管理员命令需要 OP 等级 4。如果安装了 LuckPerms,请使用以下权限节点进行细粒度控制:
| 权限 | 描述 | 默认值 |
|---|---|---|
zzclear.command.admin |
重载、白名单管理 | 仅限 OP |
zzclear.command.items |
手动清理掉落物 | 仅限 OP |
zzclear.command.monsters |
手动清理怪物 | 仅限 OP |
zzclear.command.animals |
手动清理动物 | 仅限 OP |
zzclear.command.xps |
手动清理经验球 | 仅限 OP |
zzclear.command.others |
手动清理其他实体 | 仅限 OP |
zzclear.command.status |
查看清理倒计时 | 所有玩家 |
⚙️ 配置设置
首次启动游戏后,模组会自动生成位于以下路径的配置文件:
<game root>/Zzclear/config/config.json
配置文件包含中文或英文注释(由 language 字段控制)。
常用设置
| 参数 | 默认值 | 描述 |
|---|---|---|
language |
"zh" |
配置注释语言,zh=中文,en=英文。重载后生效 |
sweepIntervalMinutes |
4 |
清理间隔(分钟) |
warningTimeSeconds |
20 |
清理前的警告时间(秒) |
finalCountdownSeconds |
5 |
最终倒计时持续时间(秒) |
countdownMessage |
中文文本 | 倒计时警告消息模板,支持 {0} 占位符 |
sweepCompleteMessage |
中文文本 | 清理完成摘要模板,支持 {0}~{3} 占位符 |
statusMessage |
中文文本 | /zzclear status 消息模板 |
ignoreNamedEntities |
true |
忽略具有自定义名称的实体 |
ignoreRiddenEntities |
true |
保护被玩家骑乘的实体 |
newItemImmunitySeconds |
0 |
物品掉落免疫时间(掉落后的秒数),0=禁用 |
minEntityCountToSweep |
0 |
触发清理所需的最小实体数量,0=无限制 |
dimensionBlacklist |
[] |
排除出清理周期的维度,例如 ["minecraft:the_end"] |
物品设置
| 参数 | 默认值 | 说明 |
|---|---|---|
sweepItems |
true |
启用物品实体收集 |
useItemWhitelist |
false |
白名单模式(仅收集列出的物品) |
useItemBlacklist |
false |
黑名单模式(不收集列出的物品) |
itemWhitelist |
[] |
物品白名单 |
itemBlacklist |
["minecraft:diamond"] |
物品黑名单 |
生物设置
| 参数 | 默认值 | 说明 |
|---|---|---|
sweepLivingEntities |
true |
启用活体实体收集 |
dropExp |
false |
击杀生物时掉落经验 |
sweepPassiveAnimals |
false |
收集被动动物 |
sweepHostileMonsters |
true |
收集敌对怪物 |
useMobWhitelist |
true |
启用生物白名单模式 |
useMobBlacklist |
false |
启用生物黑名单模式 |
mobWhitelist |
Villagers, Iron Golems, etc. | 生物白名单 |
mobBlacklist |
Villagers, Iron Golems | 生物黑名单 |
其他实体设置
| 参数 | 默认值 | 说明 |
|---|---|---|
sweepExperienceOrbs |
false |
收集经验球 |
sweepFallingBlocks |
false |
收集掉落方块(如沙子) |
sweepArrows |
false |
收集箭矢 |
sweepTridents |
false |
收集三叉戟 |
sweepProjectiles |
false |
收集投射物 |
sweepShulkerBullets |
false |
收集潜影贝子弹 |
sweepFireworks |
false |
收集烟花火箭 |
sweepItemFrames |
false |
收集物品展示框 |
sweepPaintings |
false |
收集画作 |
sweepBoats |
false |
收集船只 |
sweepPrimedTNT |
false |
收集已点燃的 TNT |
提示: 调整 JSON 配置文件后,直接返回游戏并执行
/zzclear reload。立即生效,绝对零延迟!
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
languagefield. 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.jsonfile 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:
| Permission | Description | Default |
|---|---|---|
zzclear.command.admin |
Reload, whitelist management | OP only |
zzclear.command.items |
Manual item clearing | OP only |
zzclear.command.monsters |
Manual monster clearing | OP only |
zzclear.command.animals |
Manual animal clearing | OP only |
zzclear.command.xps |
Manual XP orb clearing | OP only |
zzclear.command.others |
Manual other entity clearing | OP only |
zzclear.command.status |
View clear countdown | All players |
⚙️ 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
| Parameter | Default | Description |
|---|---|---|
language |
"zh" |
Config comment language, zh=Chinese, en=English. Takes effect after reload |
sweepIntervalMinutes |
4 |
Sweep interval in minutes |
warningTimeSeconds |
20 |
Warning time before sweep (seconds) |
finalCountdownSeconds |
5 |
Final countdown duration (seconds) |
countdownMessage |
Chinese text | Countdown warning message template, supports {0} placeholder |
sweepCompleteMessage |
Chinese text | Sweep complete summary template, supports {0}~{3} placeholders |
statusMessage |
Chinese text | /zzclear status message template |
ignoreNamedEntities |
true |
Ignore entities with custom names |
ignoreRiddenEntities |
true |
Protect entities being ridden by players |
newItemImmunitySeconds |
0 |
Item drop immunity (seconds after drop), 0=disabled |
minEntityCountToSweep |
0 |
Minimum entity count to trigger sweep, 0=no limit |
dimensionBlacklist |
[] |
Dimensions excluded from sweep, e.g. ["minecraft:the_end"] |
Item Settings
| Parameter | Default | Description |
|---|---|---|
sweepItems |
true |
Enable item entity sweeping |
useItemWhitelist |
false |
Whitelist mode (protect listed items) |
useItemBlacklist |
false |
Blacklist mode (only sweep listed items) |
itemWhitelist |
[] |
Item whitelist |
itemBlacklist |
["minecraft:diamond"] |
Item blacklist |
Mob Settings
| Parameter | Default | Description |
|---|---|---|
sweepLivingEntities |
true |
Enable living entity sweeping |
dropExp |
false |
Drop experience when killing mobs |
sweepPassiveAnimals |
false |
Sweep passive animals |
sweepHostileMonsters |
true |
Sweep hostile monsters |
useMobWhitelist |
true |
Enable mob whitelist mode |
useMobBlacklist |
false |
Enable mob blacklist mode |
mobWhitelist |
Villagers, Iron Golems, etc. | Mob whitelist |
mobBlacklist |
Villagers, Iron Golems | Mob blacklist |
Other Entity Settings
| Parameter | Default | Description |
|---|---|---|
sweepExperienceOrbs |
false |
Sweep experience orbs |
sweepFallingBlocks |
false |
Sweep falling blocks (e.g. sand) |
sweepArrows |
false |
Sweep arrows |
sweepTridents |
false |
Sweep tridents |
sweepProjectiles |
false |
Sweep projectiles |
sweepShulkerBullets |
false |
Sweep shulker bullets |
sweepFireworks |
false |
Sweep firework rockets |
sweepItemFrames |
false |
Sweep item frames |
sweepPaintings |
false |
Sweep paintings |
sweepBoats |
false |
Sweep boats |
sweepPrimedTNT |
false |
Sweep primed TNT |
Tip: After tweaking the JSON config, jump right back into the game and fire
/zzclear reload. Done instantly, with absolutely zero delays!
下载 ZzaiClear
下载 ZzaiClear
下载 ZzaiClear
下载 ZzaiClear
下载 ZzaiClear
下载 ZzaiClear
下载 ZzaiClear
下载 ZzaiClear
下载 ZzaiClear
下载 ZzaiClear
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
模组
添加全屏世界地图,显示你在世界中已探索的区域。与 Xaero's Minimap 搭配使用效果极佳。
评论 0
登录后参与评分
还没有评论,来抢沙发吧