仲裁者

仲裁者

Fabric 服务端地面物品清理器,带 Boss 栏倒计时、TPS 感知紧急清理和按维度保护规则。

管理

Fabric Minecraft Environment License Java

Arbiter 是什么?

Arbiter 是一款开源的、服务端运行的 Fabric 模组,可按可配置的时间计划自动清除地面物品实体——无需客户端安装,且不改变原版游戏机制。它以智能物品清除逻辑取代粗暴的 /kill @e[type=item] 脚本:定时清除、基于 TPS 的紧急清扫、按维度自动清除规则,以及一套保护系统,确保物品消失从不会带走重要的东西。

兼容性

端 状态 备注
服务端 必需 所有功能仅在服务端运行
客户端 无需安装 玩家无需安装 Arbiter 即可加入
Java 需要 21+ 同时需要 Fabric Loader + Fabric API

特性

  • 智能物品保护 — 已命名(铁砧重命名)和附魔物品永不被清除;基于稀有度的保护默认以 RARE 及以上为准(protect_rarity_minimum: "RARE")。
  • TPS 感知紧急清除 — 监控服务器 TPS,当 TPS 低于 emergency_tps_threshold(默认 15.0)时触发加速清扫,并通过 emergency_clear_cooldown_seconds(默认 60)防止频繁连续清除。
  • Bossbar 倒计时 — 颜色渐变的 Bossbar(绿 → 黄 → 红)在每次定时清除前向所有玩家(包括中途加入者)广播 warning_start_seconds(默认 30)秒的警告。
  • 按维度配置 — 每个维度都有独立的 clear_interval_seconds、item_count_threshold 和保护覆盖项;未设置的字段继承全局配置。
  • 10 条规则保护优先级链 — 物品命运由确定性链条决定:item_overrides 的 BLACKLIST 优先于 PROTECT,PROTECT 优先于 protected_items 列表,再优先于 protected_namespaces,再优先于稀有度,再优先于邻近度。不会有物品被意外清除。
  • 模组命名空间保护 — 将任意模组的注册表 ID 加入 protected_namespaces,一行即可保护该模组的全部物品;可通过 namespace_tiers 为其分配优先级层级(LOW / NORMAL / HIGH)。
  • JSON5 配置热重载 — 文件变更后通过文件监听在约 1 秒内生效;/arbiter reload 可强制立即重载。无效值会在加载时被限制到安全范围内。

快速开始模式

Arbiter 内置三种预设。使用单条命令即可应用任意预设——配置将被重写并自动热重载。

模式 间隔 物品阈值 保护级别 命令
aggressive 60 秒 0(总是清除) 仅 EPIC 稀有度;命名/附魔/命名空间保护关闭 /arbiter mode aggressive
warden 180 秒 50 个物品 命名、附魔、RARE+、命名空间列表 /arbiter mode warden
calm 600 秒 200 个物品 命名、附魔、UNCOMMON+、命名空间列表、扩展保护物品 /arbiter mode calm
custom 来自配置 来自配置 手动调整;所有值来自配置文件 /arbiter mode custom

命令

命令 效果 权限节点 默认 OP 等级
/arbiter force [dimension] 强制清除所有世界或指定维度 arbiter.force 4
/arbiter status 显示 TPS、距下次清除的时间、各世界的物品数量 arbiter.status 2
/arbiter reload 从磁盘重载配置而无需重启 arbiter.reload 4
/arbiter stats 查看会话统计(执行的清除次数、移除的物品数) arbiter.stats 2
/arbiter dryrun [dimension] 预览将被清除的内容而不实际移除任何东西 arbiter.dryrun 2
/arbiter testbar [seconds] 运行 Bossbar 倒计时测试 arbiter.testbar 4
/arbiter mode <preset> 应用预设:aggressive / warden / calm / custom arbiter.mode 4

LuckPerms 集成是自动的——若未安装 LuckPerms 则回退到 OP 等级。

dryrun 输出示例:Would CLEAR: 47 items — Would protect: 12

配置

Arbiter 开箱即用。首次运行时生成 config/arbiter.json5,并且完全带注释——每一项设置都有内联文档说明。

设置项 默认值 描述
clear_interval_seconds 300 定时清除之间的间隔
warning_start_seconds 30 Bossbar 倒计时在清除前多少秒开始
item_count_threshold 100 若物品实体数量少于此值则跳过清除
emergency_tps_threshold 15.0 当 TPS 低于此值时触发紧急清除;0 表示禁用
emergency_clear_cooldown_seconds 60 两次紧急清除之间的最小秒数
protect_named_items true 保护铁砧重命名的物品
protect_enchanted_items true 保护附魔物品
protect_rarity_minimum "RARE" 自动保护的最低原版稀有度(EPIC / RARE / UNCOMMON / COMMON)
player_proximity_radius 10 保护任何玩家 N 格范围内的物品
protected_namespaces ["mod_namespace"] 保护所列模组命名空间的所有物品
protected_items ["minecraft:nether_star", ...] 永远保护的精确物品 ID
item_overrides {"minecraft:dirt": "BLACKLIST"} 按物品的 PROTECT 或 BLACKLIST——覆盖所有其他规则
bossbar_enabled true 显示 Bossbar 倒计时
actionbar_warnings_enabled false 在 Bossbar 旁的动作栏中显示倒计时
broadcast_clear_results true 向所有玩家广播清除结果

注意: protect_rarity_minimum: "EPIC" 在原版中几乎不保护任何物品——附魔金苹果是唯一的 EPIC 物品。使用 "RARE" 或 "UNCOMMON" 才能实现有意义的保护。

完整配置示例(点击展开)
// Arbiter 配置 — 变更将自动热重载
{
  // ── 计时 ──────────────────────────────────────────────────
  "clear_interval_seconds": 300,
  "warning_start_seconds": 30,

  // ── 阈值 ──────────────────────────────────────────────
  "item_count_threshold": 100,
  "emergency_tps_threshold": 15.0,
  "emergency_clear_cooldown_seconds": 60,

  // ── 物品保护 ─────────────────────────────────────────
  "protect_named_items": true,
  "protect_enchanted_items": true,
  "protect_rarity_minimum": "RARE",
  "player_proximity_radius": 10,

  // ── 模组与物品列表 ────────────────────────────────────────
  "protected_namespaces": [
    "your_mod"
  ],
  "protected_items": [
    "minecraft:nether_star",
    "minecraft:elytra",
    "minecraft:dragon_egg",
    "minecraft:totem_of_undying"
  ],
  "namespace_tiers": {
    "minecraft": "NORMAL",
    "create": "NORMAL"
  },

  // 按物品覆盖 — 为特定物品设置 PROTECT 或 BLACKLIST
  // 这些会覆盖所有其他规则
  "item_overrides": {
    "minecraft:dirt": "BLACKLIST",
    "minecraft:cobblestone": "BLACKLIST",
    "minecraft:netherite_ingot": "PROTECT"
  },

  // ── 显示 ─────────────────────────────────────────────────
  "bossbar_enabled": true,
  "bossbar_style": "NOTCHED_10",
  "bossbar_yellow_threshold_seconds": 15,
  "bossbar_red_threshold_seconds": 5,
  "actionbar_warnings_enabled": false,

  // ── 按维度覆盖 ─────────────────────────────────
  "dimensions": {
    "minecraft:the_nether": {
      "clear_interval_seconds": 180,
      "item_count_threshold": 50
    },
    "minecraft:the_end": {
      "clear_interval_seconds": 120
    }
  },

  // ── 日志 ─────────────────────────────────────────────────
  "log_clears_to_console": true,
  "broadcast_clear_results": true
}

对比

特性 Arbiter ICL ClearLagg
Bossbar 倒计时 ✅ 颜色渐变 ❌ 仅聊天 ❌ 仅聊天
命名物品保护 ✅ ❌ ⚠️ 部分
附魔物品保护 ✅ ❌ ⚠️ 部分
基于稀有度的保护 ✅ ❌ ❌
模组命名空间保护 ✅ ❌ ❌
按物品 PROTECT/BLACKLIST ✅ ❌ ⚠️ 仅白名单
TPS 紧急清除 ✅ 带冷却 ❌ ⚠️ 无冷却
物品数量阈值 ✅ ❌ ❌
按维度配置 ✅ ❌ ❌
配置热重载 ✅ 文件监听 + 命令 ❌ ❌
玩家邻近保护 ✅ ❌ ❌
无 System.gc() 卡顿 ✅ ✅ ❌
静默清除(无声音) ✅ ❌ 音符盒哔声 ✅
仅服务端 ✅ ✅ ✅(Bukkit)

需求

  • Minecraft 1.21.1
  • Fabric Loader(最新版)
  • Fabric API
  • Java 21+
  • LuckPerms(可选——回退到 OP 等级)

常见问题

Arbiter 是仅服务端的吗? 是的。玩家连接运行 Arbiter 的服务器无需安装任何客户端内容。

Arbiter 会向后移植到旧版 Minecraft 吗? 目前没有向后移植的计划。请关注 GitHub 仓库以获取未来版本公告。

Arbiter 会与 ClearLagg、ICL 或其他物品清除模组冲突吗? 同时运行两个物品清除模组是多余的,不建议这样做。除此之外,Arbiter 与所有 Fabric 模组兼容。

我可以保护来自模组维度或自定义注册表的物品吗? 可以——将任意模组的注册表命名空间加入 protected_namespaces。通过 item_overrides 的按物品覆盖适用于任何物品 ID,无论来自哪个模组。


GitHub Issues | MIT License