
仲裁者
Fabric 服务端地面物品清理器,带 Boss 栏倒计时、TPS 感知紧急清理和按维度保护规则。
查看大图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,无论来自哪个模组。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。