Arbiter

模组

· 作者 KonigTX

适用于 Fabric 的服务端地面物品清理器,支持Boss栏倒计时、基于TPS感知的紧急清理以及按维度保护的规则。

0 本站下载 0 关注 更新于 7 个月前

最新 1.2.0 · 1.21.11 · Fabric

一键开服(送7天)

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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源