SerendiClear

模组

· 作者 Sanno

SerendiClear 是一款面向 Minecraft 26.2+ 的服务端 [Fabric] 模组,旨在保持你的世界整洁——自动移除掉落的物品并限制生物堆叠。它通过 BossBar 倒计时和便捷的垃圾桶图形界面来管理物品

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0 · 26.2 · Fabric

一键开服(送7天)

SerendiClear

SerendiClear 是一款适用于 Minecraft 26.2+ 的服务端 Fabric 模组,用于保持世界整洁——自动移除掉落物并限制生物堆叠——同时提供 BossBar 倒计时和便捷的垃圾桶图形用户界面(GUI),物品在被清除前会暂存于此。


功能特性

  • ? 自动清理 — 可配置的间隔时间(默认:每 30 分钟)扫描并清除掉落物和多余生物。
  • ⏲️ BossBar 倒计时 — 在清理开始前,向所有玩家显示可视化的 BossBar 警告(默认:60 秒)。
  • ?️ 垃圾桶 GUI — 被移除的物品会存储在分页的箱子 GUI 中(/垃圾桶),以便玩家找回。
  • ? 生物堆叠限制 — 限制配置半径内相同类型生物的数量(默认:每 16 格方块内 ≤24 个)。
  • ?️ 智能保护 — 命名实体/物品以及配置的保护物品 ID 永远不会被移除。
  • ? 多世界支持 — 可针对特定世界或一次性处理所有世界。
  • ? 手动触发 — /serendiclear clear 按需启动清理流程。
  • ⚙️ 热重载配置 — /serendiclear reload 无需重启服务器即可应用配置更改。
  • ? 纯服务端 — 无需安装客户端模组。

命令

命令 权限 描述
/serendiclear clear commands.gamemaster 手动启动清理倒计时
/serendiclear reload commands.gamemaster 从磁盘重新加载配置文件
/垃圾桶 (所有人) 打开垃圾桶 GUI 以取回收集到的物品

命令 /垃圾桶 是中文“垃圾桶”的意思。在未来的版本中可以设置别名或修改该命令。


配置

配置文件位于 config/serendiclear.json。首次运行时会根据默认值自动生成。

常规选项

选项 类型 默认值 描述
worlds string[] ["all"] 需要清理的世界。设置为 ["all"] 表示所有维度,或列出特定世界(例如 ["minecraft:overworld"])。
intervalMinutes int 30 自动清理之间的间隔时间(分钟)。最小值:1。
broadcastSeconds int 60 倒计时持续时间(秒)。设置为 0 则立即清理。
prefix string "§9SerendiClear >> " 聊天消息中使用的前缀。
bossbarTitle string "§e即将清理!倒计时: §c{time} §e秒" BossBar 标题。{time} 会被替换为剩余秒数。

物品与生物选项

选项 类型 默认值 描述
clearDrops bool true 是否移除散落的物品实体。
clearMobs bool true 是否强制执行生物堆叠限制。
maxMobStack int 24 在 mobStackRadius 范围内允许的相同生物类型的最大数量。
mobStackRadius int 16 检测生物堆叠的半径(以方块为单位)。
protectNamed bool true 是否跳过已命名的实体或重命名的物品堆栈。
protectedItems string[] [] 永不移除的物品 ID(例如 ["minecraft:diamond", "minecraft:netherite_ingot"])。

垃圾桶选项

选项 类型 默认值 描述
trashEnabled bool true 启用垃圾桶。关闭后,掉落物将被直接删除。
trashMaxPages int 5 垃圾桶的最大页数(每页是一个 54 格的箱子大小网格)。
trashTitle string "§9§l垃圾桶 §7(第{page}/{max}页)" 垃圾桶 GUI 的标题。{page} 和 {max} 是占位符。
trashOpenButton string "§e§l【点我打开垃圾桶】" 清理后发送的可点击聊天消息。
trashExcludedWorlds string[] [] 不发送垃圾桶消息的世界列表。

当垃圾桶空间不足(所有页面已满)时,它会自动清空并重新开始。发生此情况时会广播通知。


安装

  1. 为 Minecraft 26.2+ 安装 Fabric Loader。
  2. 将 SerendiClear-<version>.jar 放入服务器的 mods/ 文件夹中。
  3. 启动服务器——该模组为纯服务端,无需客户端模组。
  4. 根据需要配置 config/serendiclear.json(它会自动生成)。

依赖项

  • Fabric API(任何与你 Minecraft 版本兼容的版本)
  • Minecraft 26.2+

工作原理

  1. Tick 循环 — 每个服务器 Tick,模组检查是否已过去 intervalMinutes 分钟。
  2. 倒计时 — 触发后,出现 BossBar 并倒计时 broadcastSeconds 秒。在此期间,玩家可以使用 /垃圾桶。
  3. 清理 — 模组遍历目标世界中所有已加载的区块:
    • 掉落物:移除受保护的 ItemEntity 实例并将其存储在垃圾桶中。
    • 生物:按类型对活体实体进行分组,在 mobStackRadius 内查找集群,并移除最远的多余成员,直到集群满足 maxMobStack 的限制。
  4. 垃圾桶通知 — 清理完成后,发送一个可点击的聊天按钮,邀请玩家打开垃圾桶并找回他们的物品。

权限系统

该模组使用 Fabric API 内置的权限 API,级别为 commands.gamemaster。拥有操作员状态(或通过权限模组授予此权限)的玩家可以使用管理命令。


许可证

本项目根据 MIT License 授权。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源