Skip to content

Whitelist

Jump to bottom
StarYearsL edited this page Jul 8, 2026 · 2 revisions

Whitelist

白名单用于保护指定物品，使其不会被自动清理或手动清理。

以下命令都支持 /xiaonuoclean 和 /xnc 两种写法。命令执行者需要控制台、OP 或管理员权限；whitelist set 只能由游戏内玩家执行。

查看白名单

/xiaonuoclean whitelist list

使用物品 ID 添加白名单

/xiaonuoclean whitelist add <item>

示例：

/xiaonuoclean whitelist add minecraft:diamond

也可以使用命令补全选择物品。

命令参数会保存为完整物品 ID，例如 minecraft:diamond。

使用主手物品添加白名单

/xiaonuoclean whitelist set

该命令会读取执行者主手物品 ID，并自动添加到白名单。

示例：

  1. 游戏内 OP / 管理员主手拿着钻石。
  2. 执行：
/xiaonuoclean whitelist set
  1. MOD 会自动添加：
minecraft:diamond

控制台限制

/xiaonuoclean whitelist set 依赖游戏内玩家的主手物品，因此控制台无法使用。

控制台执行时不会修改配置，并会返回失败提示。

空手限制

如果游戏内管理员主手为空，执行：

/xiaonuoclean whitelist set

不会修改配置，并会提示主手没有物品。

移除白名单

/xiaonuoclean whitelist remove <item>

示例：

/xiaonuoclean whitelist remove minecraft:diamond

配置文件写法

也可以直接编辑配置文件：

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

支持简写：

{
  "whitelist": [
    "diamond"
  ]
}

简写会按 Minecraft 命名空间处理为：

minecraft:diamond

配置加载时会忽略无效物品 ID，并对重复项目去重。编辑配置文件后执行：

/xiaonuoclean reload

Clone this wiki locally