小诺清理

XiaoNuoClean

XiaoNuoClean 是一款面向 Fabric/NeoForge 服务器的 Minecraft Java 版模组，旨在按计划时间自动清理掉落物。

构建过程会分别生成 Fabric 和 NeoForge 的独立 JAR 文件。请根据你服务器的模组加载器选择相应文件。单个 JAR 当前兼容的 Minecraft 版本范围为 26.1.2 至 26.2.x。

构建

默认情况下，构建不会解析 NeoForge 依赖项，这仅适用于构建 Fabric 版本：

./gradlew build

要构建 NeoForge 版本，你必须显式启用 NeoForge 模块，并确保你的网络可以访问 NeoForge Maven 仓库：

./gradlew :neoforge:build -PincludeNeoForge=true --no-parallel --max-workers=1

功能

• 默认每 15 分钟清理一次掉落物。
• 在清理前 10、5、4、3、2、1 秒广播警告消息。
• 支持通过 /xiaonuoclean clean on/off 持久化清理计划。
• 可通过 config/xiaonuoclean/config.json 配置（语言、间隔、警告时间点和白名单）。
• 服务端国际化支持。默认生成 zh-CN 和 en-US 语言文件；可添加自定义语言。
• 提供 /xiaonuoclean 命令（别名 /xnc），用于检查状态、重载配置、立即清理和修改设置。
• 白名单中的物品在清理期间会被忽略（例如 minecraft:diamond 或简写 diamond）。

默认配置

{
  "language": "zh-CN",
  "enabled": true,
  "intervalSeconds": 900,
  "warningSeconds": [10, 5, 4, 3, 2, 1],
  "whitelist": []
}

语言文件位于：

config/xiaonuoclean/lang/<language>.json

例如，将主配置文件中的 "language" 改为 "en-US"，然后运行 /xiaonuoclean reload 即可切换到英文消息。要添加新语言，请在此目录中放置一个对应名称的 JSON 文件，并在主配置中引用它。

命令

所有 /xiaonuoclean ... 命令均可缩写为 /xnc ...。

/xiaonuoclean status
/xiaonuoclean reload
/xiaonuoclean clean
/xiaonuoclean clean on
/xiaonuoclean clean off
/xiaonuoclean interval <seconds>
/xiaonuoclean warnings set <seconds...>
/xiaonuoclean whitelist set
/xiaonuoclean whitelist add <item>
/xiaonuoclean whitelist remove <item>
/xiaonuoclean whitelist list

修改命令需要 OP 权限。

/xiaonuoclean whitelist set 命令只能由游戏内的 OP/管理员玩家执行；它会从执行者的主手中读取物品 ID 并添加到白名单。此命令无法在控制台中使用。

许可证

本项目根据 GNU 通用公共许可证 v3.0 开源。

详情请参阅 LICENSE。