ClearDrops

模组

· 作者 YuWan030

一个仅适用于服务器端的 Forge 1.20 模组,可将掉落的物品清理到一个共享的回收站中。它支持自动/手动收集、通过原版箱子 GUI 进行取回、可热重载的配置、渐变色消息、物品黑名单以及预收集

0 本站下载 0 关注 更新于 1 年前

最新 1.0.1 · 1.20.4 · Forge / NeoForge

一键开服(送7天)

Cleardrops

一个仅适用于服务端的 Forge 1.20.1 模组,用于将掉落的物品清理到共享回收站中。它支持自动/手动收集、通过原版箱子 GUI 检索、可热重载的配置、渐变颜色消息、物品黑名单、收集前警告以及虚空物品保护。兼容原版客户端——无需安装客户端模组。

  • Minecraft: 1.20.1
  • Forge: 47.4.x
  • Java: 17
  • Mod ID: cleardrops
  • 客户端依赖:无(原版客户端可以加入并使用 GUI)

功能特性

  • 自动定期清理世界中的物品实体(可配置间隔和开关)
  • 通过命令手动清理
  • 回收站(54 格),通过原版 6 行容器打开
  • 配置热重载:编辑并保存 world/serverconfig/cleardrops-server.toml,或运行 /cleardrops reload
  • 完全可配置的消息(中文/英文或任何语言),支持渐变颜色
  • 可配置的秒数级收集前警告
  • 物品黑名单:
    • 黑名单上的物品不会从世界中收集
    • 黑名单上的物品在清空回收站时也会被跳过(此模组永远不会销毁它们)
  • 虚空物品保护:落入虚空的物品会被传送回安全高度

安装

  1. 将模组 jar 文件放入服务器的 mods/ 文件夹中。
  2. 启动服务器一次以生成配置文件。
  3. 根据您的需要编辑 <WORLD>/serverconfig/cleardrops-server.toml。
  4. 保存配置文件即可即时热重载;或者运行 /cleardrops reload。

命令

  • /cleardrops help — 显示帮助(使用可配置的渐变样式文本)
  • /cleardrops gui — 打开回收站(原版箱子 GUI)
  • /cleardrops status — 显示当前库存、倒计时和开关状态
  • /cleardrops collect — 立即收集掉落的物品(权限等级 ≥ 2)
  • /cleardrops purge — 立即清空回收站(权限等级 ≥ 2;黑名单物品会被跳过)
  • /cleardrops reload — 从 TOML 重新加载配置(权限等级 ≥ 2)

权限遵循服务器的标准 OP 等级 (hasPermission(2))。

配置(支持热重载)

路径:<WORLD>/serverconfig/cleardrops-server.toml

保存文件即可即时应用(热重载),或运行 /cleardrops reload。

[general]
# 启用定期自动收集掉落物品。
enableAutoCollect = true
# 自动收集之间的刻数。20 刻 = 1 秒。
ticksPerCollect = 6000
# 收集后在回收站中保留物品的刻数,之后进行清空。
ticksKeepAfterCollect = 2400
# 向在线玩家广播消息(警告、已收集、已清空等)。
announceMessages = true

[blacklist]
# 物品 ID(例如 minecraft:nether_star)。黑名单物品不会被收集,
# 并且在清空时也会被跳过(此模组永远不会销毁它们)。
items = ["minecraft:nether_star", "minecraft:totem_of_undying"]

[void_protection]
# 将落入虚空的物品拉回到世界的最低建筑高度区域。
enableVoidProtect = true
# 查找安全空气位置的最大向上步数(以方块为单位)。
raiseMaxSteps = 6
# 从虚空中救援时重置物品速度。
resetVelocity = true

[messages]
# 消息前缀(支持渐变标签)。示例:
prefix = "<gradient:#00E5FF:#00FF7F>[Cleardrops]</gradient>"
# 收集前警告秒数。
warnSeconds = [60, 30, 10, 5, 4, 3, 2, 1]

# 警告消息模板(占位符:{time})
msgPreCollect = "正在在 {time} 秒内收集掉落物品。请拾取贵重物品!"

# 自动收集完成(占位符:{entities}, {keep})
msgCollected = "已收集 {entities} 个物品实体。请使用 /cleardrops gui 进行检索。将在 {keep} 秒后清空。"

# 清空完成(占位符:{slots})
msgPurged = "回收站已清空。清除了 {slots} 个槽位。"

# 状态(占位符:{slotsUsed}, {slotsTotal}, {items}, {keep}, {auto}, {interval}, {keepCfg}, {announce})
msgStatus = "回收站:{slotsUsed}/{slotsTotal} 个槽位,{items} 个物品;将在 {keep} 后清空;自动={auto},间隔={interval}秒,保留={keepCfg}秒,广播={announce}。"

# 帮助(支持渐变和 \n 换行)
msgHelp = "<gradient:#7AD7F0:#4FC3F7>Cleardrops 帮助</gradient>\n<gradient:#A8FF78:#78FFD6>/cleardrops gui</gradient> - 打开回收站\n<gradient:#A8FF78:#78FFD6>/cleardrops status</gradient> - 显示状态\n<gradient:#FFD54F:#FF8A00>/cleardrops collect</gradient> - 立即收集 (权限 2)\n<gradient:#FFD54F:#FF8A00>/cleardrops purge</gradient> - 立即清空 (权限 2)\n<gradient:#B388FF:#7C4DFF>/cleardrops reload</gradient> - 重载配置 (权限 2)"

# 手动命令反馈
# /cleardrops collect(占位符:{entities}, {keep})
msgCmdCollect = "已收集 {entities} 个物品实体。您有 {keep} 秒时间从回收站中取回它们。"

# /cleardrops purge(占位符:{slots})
msgCmdPurge = "回收站已清空:清除了 {slots} 个槽位。黑名单物品已被跳过。"

消息格式

  • 渐变标签:
    • 语法:<gradient:#RRGGBB:#RRGGBB>文本</gradient>
    • 颜色通过线性插值逐字符应用。
    • 适用于 prefix、msgHelp 和任何消息模板。
  • 占位符:
    • 警告:{time}
    • 已收集:{entities}, {keep}
    • 已清空:{slots}
    • 状态:{slotsUsed}, {slotsTotal}, {items}, {keep}, {auto}, {interval}, {keepCfg}, {announce}(如果添加到模板中,还可以选择性地使用 {blacklistedStacks})

黑名单与虚空保护

  • 黑名单:
    • 列表中的物品在清理期间不被收集(留在世界中)。
    • 回收站中处于黑名单的物品不被清空(此模组永远不会销毁它们)。
  • 虚空保护:
    • 检测低于最低建筑高度的物品实体,并将它们传送到安全的空气位置。
    • 可配置最大提升步数以及是否归零速度。

常见问题

  • 客户端需要安装该模组吗?
    • 不需要。这是服务端专用模组。其用户界面使用原版的箱子容器。
  • 与其他清理类模组冲突吗?
    • 多个清理系统可能会重叠。建议只保留一个主要的清理模组,或错开它们的执行时间。
  • 配置更改未生效?
    • 请确保编辑当前世界的 serverconfig/cleardrops-server.toml 文件。保存即可热重载,或者运行 /cleardrops reload 命令。

开发

  • JDK 17, Forge 1.20.1 (47.4.x)
  • 构建:./gradlew build(构建产物位于 build/libs/ 目录下)
  • 核心包:
    • cn.alini.cleardrops.server.ServerScheduler — 核心调度、收集/清除、警告、虚空保护、黑名单
    • cn.alini.cleardrops.config.CDConfig — 配置规范与热重载
    • cn.alini.cleardrops.command.CleardropsCommands — 命令注册与处理
    • cn.alini.cleardrops.util.MessageUtil — 渐变色渲染与占位符
    • cn.alini.cleardrops.storage.TrashStorage — 回收站存储

许可

本项目遵循 Creative Commons Attribution 4.0 International (CC BY 4.0) 许可证。详见 LICENSE。

只要您提供适当的署名,您可以复制、修改和分发本项目。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源