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 倒计时 —— 在每次定时清理前,通过颜色渐变的 Boss 条(绿 → 黄 → 红)向所有玩家(包括后加入者)广播
warning_start_seconds(默认值:30)秒的警告。
- 按维度配置 —— 每个维度拥有独立的
clear_interval_seconds、item_count_threshold 和保护覆盖设置;未设置的字段将继承自全局配置。
- 10 层保护优先级链 —— 物品的命运由确定性链条决定:
item_overrides 黑名单优先于 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] |
运行 Boss 条倒计时测试 |
arbiter.testbar |
4 |
/arbiter mode <preset> |
应用预设:aggressive / warden / calm / custom |
arbiter.mode |
4 |
LuckPerms 集成是自动的——如果未安装 LuckPerms,则回退到 OP 等级判断。
dryrun 输出示例:Would CLEAR: 47 items — Would protect: 12 (即将清理:47 个物品 — 将保护:12 个)
配置
Arbiter 开箱即用。首次运行时生成 config/arbiter.json5,且带有完整注释——每项设置均在行内进行了文档说明。
| 设置项 |
默认值 |
描述 |
clear_interval_seconds |
300 |
定时清理之间的间隔时间 |
warning_start_seconds |
30 |
Boss 条倒计时在此秒数前开始 |
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 |
显示 Boss 条倒计时 |
actionbar_warnings_enabled |
false |
在动作栏中与 Boss 条同时显示倒计时 |
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
What is Arbiter?
Arbiter is an open-source, server-side Fabric mod that automatically clears ground item entities on a configurable schedule — no client install required and vanilla game mechanics unchanged. It replaces blunt /kill @e[type=item] scripts with intelligent item clear logic: scheduled clears, TPS-aware emergency sweeps, per-dimension auto clear rules, and a protection system that ensures item despawn never takes something that matters.
Compatibility
| Side |
Status |
Notes |
| Server |
Required |
All features run server-side only |
| Client |
Not needed |
Players do not need to install Arbiter to join |
| Java |
21+ required |
Fabric Loader + Fabric API also required |
Features
- Smart Item Protection — Named (anvil-renamed) and enchanted items are never cleared; rarity-based protection defaults to RARE and above (
protect_rarity_minimum: "RARE").
- TPS-Aware Emergency Clear — Monitors server TPS and triggers an accelerated sweep when TPS drops below
emergency_tps_threshold (default: 15.0), with a emergency_clear_cooldown_seconds (default: 60) to prevent rapid-fire clearing.
- Bossbar Countdown — Color-graduated bossbar (green → yellow → red) broadcasts a
warning_start_seconds (default: 30) warning to all players, including late joiners, before each scheduled clear.
- Per-Dimension Configuration — Each dimension carries independent
clear_interval_seconds, item_count_threshold, and protection overrides; unset fields inherit from global config.
- 10-Rule Protection Priority Chain — Item fate is resolved by a deterministic chain:
item_overrides BLACKLIST beats PROTECT beats protected_items list beats protected_namespaces beats rarity beats proximity. No item is cleared unexpectedly.
- Mod Namespace Protection — Add any mod's registry ID to
protected_namespaces to protect all of its items with one line; assign priority tiers (LOW / NORMAL / HIGH) via namespace_tiers.
- Hot-Reload JSON5 Config — File changes apply within ~1 second via file-watch;
/arbiter reload forces an immediate reload. Invalid values are clamped to safe ranges on load.
Quick Start Modes
Arbiter ships with three built-in presets. Apply any preset with a single command — the config is rewritten and hot-reloaded automatically.
| Mode |
Interval |
Item Threshold |
Protection Level |
Command |
aggressive |
60 s |
0 (always clear) |
EPIC rarity only; named/enchanted/namespace disabled |
/arbiter mode aggressive |
warden |
180 s |
50 items |
Named, enchanted, RARE+, namespace list |
/arbiter mode warden |
calm |
600 s |
200 items |
Named, enchanted, UNCOMMON+, namespace list, extended protected items |
/arbiter mode calm |
custom |
from config |
from config |
Hand-tuned; all values from config file |
/arbiter mode custom |
Commands
| Command |
Effect |
Permission Node |
Default OP Level |
/arbiter force [dimension] |
Force-clear all worlds or a specific dimension |
arbiter.force |
4 |
/arbiter status |
Show TPS, time until next clear, item counts per world |
arbiter.status |
2 |
/arbiter reload |
Reload config from disk without restarting |
arbiter.reload |
4 |
/arbiter stats |
View session statistics (clears run, items removed) |
arbiter.stats |
2 |
/arbiter dryrun [dimension] |
Preview what would be cleared without removing anything |
arbiter.dryrun |
2 |
/arbiter testbar [seconds] |
Run a bossbar countdown test |
arbiter.testbar |
4 |
/arbiter mode <preset> |
Apply a preset: aggressive / warden / calm / custom |
arbiter.mode |
4 |
LuckPerms integration is automatic — falls back to OP level if LuckPerms is not installed.
dryrun output example: Would CLEAR: 47 items — Would protect: 12
Configuration
Arbiter works out of the box. config/arbiter.json5 is generated on first run and is fully annotated — every setting is documented inline.
| Setting |
Default |
Description |
clear_interval_seconds |
300 |
Time between scheduled clears |
warning_start_seconds |
30 |
Bossbar countdown starts this many seconds before clear |
item_count_threshold |
100 |
Skip clear if fewer item entities than this exist |
emergency_tps_threshold |
15.0 |
Trigger emergency clear when TPS drops below this; 0 disables |
emergency_clear_cooldown_seconds |
60 |
Minimum seconds between emergency clears |
protect_named_items |
true |
Protect anvil-renamed items |
protect_enchanted_items |
true |
Protect enchanted items |
protect_rarity_minimum |
"RARE" |
Minimum vanilla rarity to auto-protect (EPIC / RARE / UNCOMMON / COMMON) |
player_proximity_radius |
10 |
Protect items within N blocks of any player |
protected_namespaces |
["mod_namespace"] |
Protect all items from listed mod namespaces |
protected_items |
["minecraft:nether_star", ...] |
Exact item IDs always protected |
item_overrides |
{"minecraft:dirt": "BLACKLIST"} |
Per-item PROTECT or BLACKLIST — overrides all other rules |
bossbar_enabled |
true |
Show bossbar countdown |
actionbar_warnings_enabled |
false |
Show countdown in actionbar alongside bossbar |
broadcast_clear_results |
true |
Announce clear results to all players |
Note: protect_rarity_minimum: "EPIC" protects almost nothing in vanilla — enchanted golden apple is the only EPIC item. Use "RARE" or "UNCOMMON" for meaningful protection.
Full Example Config (click to expand)
// Arbiter configuration — changes are hot-reloaded automatically
{
// ── Timing ──────────────────────────────────────────────────
"clear_interval_seconds": 300,
"warning_start_seconds": 30,
// ── Thresholds ──────────────────────────────────────────────
"item_count_threshold": 100,
"emergency_tps_threshold": 15.0,
"emergency_clear_cooldown_seconds": 60,
// ── Item Protection ─────────────────────────────────────────
"protect_named_items": true,
"protect_enchanted_items": true,
"protect_rarity_minimum": "RARE",
"player_proximity_radius": 10,
// ── Mod & Item Lists ────────────────────────────────────────
"protected_namespaces": [
"your_mod"
],
"protected_items": [
"minecraft:nether_star",
"minecraft:elytra",
"minecraft:dragon_egg",
"minecraft:totem_of_undying"
],
"namespace_tiers": {
"minecraft": "NORMAL",
"create": "NORMAL"
},
// Per-item overrides — PROTECT or BLACKLIST specific items
// These override ALL other rules
"item_overrides": {
"minecraft:dirt": "BLACKLIST",
"minecraft:cobblestone": "BLACKLIST",
"minecraft:netherite_ingot": "PROTECT"
},
// ── Display ─────────────────────────────────────────────────
"bossbar_enabled": true,
"bossbar_style": "NOTCHED_10",
"bossbar_yellow_threshold_seconds": 15,
"bossbar_red_threshold_seconds": 5,
"actionbar_warnings_enabled": false,
// ── Per-Dimension Overrides ─────────────────────────────────
"dimensions": {
"minecraft:the_nether": {
"clear_interval_seconds": 180,
"item_count_threshold": 50
},
"minecraft:the_end": {
"clear_interval_seconds": 120
}
},
// ── Logging ─────────────────────────────────────────────────
"log_clears_to_console": true,
"broadcast_clear_results": true
}
How It Compares
| Feature |
Arbiter |
ICL |
ClearLagg |
| Bossbar countdown |
✅ Color-graduated |
❌ Chat only |
❌ Chat only |
| Named item protection |
✅ |
❌ |
⚠️ Partial |
| Enchanted item protection |
✅ |
❌ |
⚠️ Partial |
| Rarity-based protection |
✅ |
❌ |
❌ |
| Mod namespace protection |
✅ |
❌ |
❌ |
| Per-item PROTECT/BLACKLIST |
✅ |
❌ |
⚠️ Whitelist only |
| TPS emergency clear |
✅ With cooldown |
❌ |
⚠️ No cooldown |
| Item count threshold |
✅ |
❌ |
❌ |
| Per-dimension config |
✅ |
❌ |
❌ |
| Hot-reload config |
✅ File watch + command |
❌ |
❌ |
| Player proximity protection |
✅ |
❌ |
❌ |
No System.gc() stutter |
✅ |
✅ |
❌ |
| Silent clears (no sounds) |
✅ |
❌ Noteblock beep |
✅ |
| Server-side only |
✅ |
✅ |
✅ (Bukkit) |
Requirements
- Minecraft 1.21.1
- Fabric Loader (latest)
- Fabric API
- Java 21+
- LuckPerms (optional — falls back to OP levels)
FAQ
Is Arbiter server-side only?
Yes. Players connect to a server running Arbiter without installing anything client-side.
Will Arbiter be backported to older Minecraft versions?
No backport is currently planned. Watch the GitHub repository for future version announcements.
Does Arbiter conflict with ClearLagg, ICL, or other item-clearing mods?
Running two item-clearing mods simultaneously is redundant and not recommended. Arbiter is otherwise compatible with all Fabric mods.
Can I protect items from modded dimensions or custom registries?
Yes — add any mod's registry namespace to protected_namespaces. Per-item overrides via item_overrides work for any item ID regardless of mod.
GitHub Issues | MIT License
评论 0
登录后参与评分
还没有评论,来抢沙发吧