Skip to content

Configuration

StarYearsL edited this page Jul 8, 2026 · 2 revisions

Configuration

XiaoNuoClean 的配置文件位于:

config/xiaonuoclean.json

首次启动后会自动生成默认配置。

Fabric 版和 NeoForge 版使用相同的配置文件格式。

默认配置

{
  "intervalSeconds": 900,
  "warningSeconds": [10, 5, 4, 3, 2, 1],
  "whitelist": []
}

配置项说明

intervalSeconds

清理间隔,单位为秒。

默认值:

900

即每 15 分钟清理一次。

该值必须大于 0。如果配置成无效值,MOD 会恢复为默认的 900 秒。

示例:每 30 分钟清理一次:

"intervalSeconds": 1800

warningSeconds

清理前提醒时间,单位为秒。

默认值:

[10, 5, 4, 3, 2, 1]

表示会在清理前 10 秒、5 秒、4 秒、3 秒、2 秒、1 秒广播提醒。

提醒秒数必须大于 0 且小于清理间隔。重复值会被去重,无效值会被忽略。

示例:改为 60 秒、30 秒、10 秒提醒:

"warningSeconds": [60, 30, 10]

如果希望关闭清理前提醒,可以设置为空数组:

"warningSeconds": []

游戏内命令 /xiaonuoclean warnings set <seconds...> 至少需要一个有效正整数;如果要完全关闭提醒,请直接编辑配置文件并执行 /xiaonuoclean reload

whitelist

不会被清理的物品白名单。

示例:

"whitelist": [
  "minecraft:diamond",
  "minecraft:netherite_ingot"
]

也支持简写:

"whitelist": [
  "diamond"
]

简写会自动按 Minecraft 命名空间处理为:

minecraft:diamond

无效物品 ID 会在配置加载时被忽略。重复项目会被去重。

配置安全

  • 如果配置文件不存在,MOD 会生成默认配置。
  • 如果配置文件 JSON 格式损坏,MOD 会使用默认配置运行,但不会覆盖原文件。
  • 加载现有配置时,MOD 不会静默重写你的配置文件。
  • 使用游戏内命令修改配置时,MOD 会保存规范化后的配置。

Clone this wiki locally