CrowBar

CrowBar 是一款适用于 Minecraft 1.21-1.21.11、26.1.x、26.2 和 26.3 的客户端模组，可扩展定位栏，显示清晰易读的玩家名牌、皮肤标记、距离文本、队伍颜色圆点，并提供自拍模式。在没有定位栏的 1.21-1.21.5 版本中，它会在经验条上绘制相同的标记。Fabric 和 NeoForge 均可使用。

功能

• 在定位栏标记上方显示玩家名称。
• 可将定位圆点替换为玩家皮肤头像。
• 可选择在玩家名称旁显示距离文本。
• 如果有可用的队伍颜色，则保留该颜色。
• 提供自拍模式，方便拍摄干净的定位栏截图。
• 自拍模式启用时，隐藏生命值、饥饿值、护甲和原版定位栏。
• 在 Minecraft 1.21-1.21.5 中，将玩家标记绘制在经验条上，从而为这些版本添加玩家标记。
• 可按 \ 键打开设置界面；Fabric 版可在模组菜单中打开，NeoForge 版可在模组列表中打开。
• 每项功能都可设置为按键切换，或仅在按住按键时生效。
• 可选外观设置包括：深色标签背景、平滑抬升 HUD、隐藏重叠标签、队伍颜色皮肤边框、可配置圆点颜色和距离渐隐。默认启用“调暗其他标签”；其他外观选项默认关闭。
• 这是客户端模组：服务器和其他玩家都不需要安装 CrowBar。
• 每个 jar 文件也可作为可选的 Paper、Spigot 和 Folia 插件使用，为安装了 CrowBar 的玩家发送位置和 GriefPrevention 领地标记。请参阅 服务器插件。

Minecraft 1.21-1.21.5

Minecraft 在 1.21.6 中加入了定位栏。在 1.21-1.21.5 中，CrowBar 会改为在经验条上绘制标记，并保留相同的名称、头像、距离、颜色和设置。在没有经验条的创造模式中，它会绘制一条细轨道来放置标记。

只需你安装 CrowBar；其他玩家无需安装该客户端模组。服务器插件为可选项。由于 Minecraft 1.21-1.21.5 没有可供服务器填充的定位栏，CrowBar 会通过以下方式获取玩家位置：

• 单人游戏和局域网主机：你世界中的所有玩家，无论距离多远。
• 运行 CrowBar 插件或 Allium 的服务器：服务器共享的所有玩家，无论距离多远。
• 其他服务器：仅显示客户端已加载的玩家。这受服务器玩家追踪范围限制；Paper 和 Spigot 的默认值为 48 格，因此更远的玩家不会显示。

玩家隐藏在定位栏中的方式与 Minecraft 1.21.6 及更高版本的原版定位栏相同：潜行、隐身、戴上雕刻南瓜或生物头颅，或者处于旁观模式。

服务器插件

每个 CrowBar jar 文件也可作为服务器插件使用。将适用于服务器 Minecraft 版本的 jar 文件放入 Paper、Spigot、Purpur 或 Folia 服务器的 plugins 文件夹中；同一个文件在客户端上是 Fabric 或 NeoForge 模组，在服务器上则是 Bukkit 插件。GitHub 发布页面上的 CrowBar-plugin-<version>.jar 是独立的插件文件。

该插件为可选项，没有安装 CrowBar 的玩家不会受到影响。插件包含两个部分。

玩家定位器。向安装了 CrowBar 的玩家发送其所在世界中所有玩家的位置，让定位栏显示远超服务器追踪范围的玩家。这对 1.21-1.21.5 尤其重要，因为 CrowBar 在这些版本中原本只能看到附近玩家。隐藏玩家会完全从数据中排除，因此其位置不会发送到任何人的客户端。它还移植了 Player Locator Plus 的服务器设置：

| 设置 | 默认值 | 作用 |
| — | — | — |
| player-locator.update-interval-ticks | 2 | 更新之间的刻数。 |
| player-locator.max-distance | 0 | 玩家仍会显示的最远距离。0 表示不限制。 |
| hide-when.sneaking / invisible / spectating / vanished | true | 哪些玩家不会显示在栏上，与原版定位栏一致。 |
| hide-when.head-items | 南瓜和生物头颅 | 能隐藏佩戴者的头部物品。 |
| precision.direction-steps | 0 | 对方向进行取整，防止玩家被三角定位。Player Locator Plus 使用 300。 |
| precision.send-distance | true | 关闭时，CrowBar 只显示玩家所在的方向；距离则显示为 ?m。 |
| precision.round-distance-beyond / round-distance-to | 200 / 0 | 将较远距离取整到指定倍数。 |
| colors.mode | team | team、unique、constant 或 custom（玩家通过 /crowbar color 选择）。 |
| colors.players | 无 | 根据玩家名称固定颜色，类似 Allium 的 player-colors。 |

认领区域标记。 安装 GriefPrevention 或 GriefPrevention3D 后，区域会以蝴蝶结标记显示在定位栏上，供其所有者及获准访问的玩家查看；标记样式与 GPExpansion 发布的相同。CrowBar 玩家无论距离多远，都能看到自己有权访问的所有区域。在 Paper 1.21.6 及更新版本上，没有安装 CrowBar 的玩家也能在原版定位栏上看到这些标记，范围为 claim-waypoints.vanilla-marker-range（默认 1000 格）。子区域和管理员区域默认关闭。

如果安装了 Allium 或 GPExpansion，对应的功能会自动停用，避免重复发送数据。GPExpansion 的区域标记支持自定义名称、颜色、区域重生点和已发布区域；此插件则以区域所有者命名，并将标记放在区域中心。

| 权限 | 默认值 | |
| — | — | — |
| crowbar.locator | 所有人 | 接收其他玩家的位置。 |
| crowbar.locator.see-hidden | 管理员 | 查看正在潜行、隐身、旁观或佩戴隐藏头部物品的玩家。相当于 Allium 的 allium.crowbar。已消失的玩家仍会对其消失插件所隐藏的对象保持隐藏。 |
| crowbar.locator.hidden | 无人 | 永远不显示在任何人的栏上。 |
| crowbar.color / crowbar.color.others | 所有人 / 管理员 | /crowbar color <#RRGGBB\|reset> [player] |
| crowbar.claims | 所有人 | /crowbar claims <own\|trusted\|off>：哪些区域会显示在你的原版定位栏上。 |
| crowbar.claims.admin | 管理员 | 当 claim-waypoints.admin-claims 开启时查看管理员区域。 |
| crowbar.reload | 管理员 | /crowbar reload |

无论使用哪一个 CrowBar JAR，插件都能在 Minecraft 1.21 至 26.3 的所有服务器上运行。原版区域标记需要 Paper 1.21.6 或更新版本；其他环境下，只有 CrowBar 玩家能看到区域。

Allium 服务器

Allium Essentials 是一款可选的 Paper 服务端插件，能够向 CrowBar 发送专用的定位数据包。安装 Allium 后，CrowBar 无需依赖原版定位路标；服务器可以发送玩家 UUID、位置、队伍颜色和可见状态，以供自定义定位栏使用。

这样一来，即使玩家处于隐藏、潜行、隐身状态，或因其他原因未出现在原版路标数据中，CrowBar 仍能显示他们。服务器也可以将 NPC 路标的传输范围保持为零，同时仍向 CrowBar 提供所需的真实玩家数据。

未安装 Allium 时，CrowBar 会回退到常规客户端可见玩家，包括局域网和集成服务器会话。

GPX-CrowBar

安装了 GPExpansion 的服务器上，领地所有者和受信任的玩家会在定位栏中看到领地名称和蝴蝶结标记。CrowBar 会读取相同的定位数据，并在路径点上方显示名称标签，让你可以直接在定位栏中清楚地查看领地名称。

运行要求

请根据你的 Minecraft 版本系列和加载器使用对应的 jar 文件：

Fabric

• CrowBar-1.21-1.21.1：Minecraft 1.21–1.21.1、Java 21、Fabric Loader 0.18.4 或更高版本、Fabric API 0.100.1 或更高版本。
• CrowBar-1.21.2-1.21.5：Minecraft 1.21.2–1.21.5、Java 21、Fabric Loader 0.18.4 或更高版本、Fabric API 0.102.2 或更高版本。
• CrowBar-1.21.6-1.21.8：Minecraft 1.21.6–1.21.8、Java 21、Fabric Loader 0.18.4 或更高版本、Fabric API 0.125.0 或更高版本。
• CrowBar-1.21.x：Minecraft 1.21.9–1.21.11、Java 21、Fabric Loader 0.18.4 或更高版本、Fabric API 0.134.0 或更高版本。
• CrowBar-26.1.x：Minecraft 26.1.x、Java 25、Fabric Loader 0.19.2 或更高版本、Fabric API 0.145.1 或更高版本。
• CrowBar-26.x：Minecraft 26.2、Java 25、Fabric Loader 0.19.3 或更高版本、Fabric API 0.152.2 或更高版本。
• CrowBar-26.3.x：Minecraft 26.3、Java 25、Fabric Loader 0.19.5 或更高版本、Fabric API 0.160.7 或更高版本。

NeoForge

• CrowBar-1.21-1.21.1-neoforge：Minecraft 1.21–1.21.1、Java 21、NeoForge 21.0 或更高版本。
• CrowBar-1.21.3-1.21.5-neoforge：Minecraft 1.21.3–1.21.5、Java 21、NeoForge 21.3 或更高版本。NeoForge 从未发布过稳定版 1.21.2。
• CrowBar-1.21.6-1.21.8-neoforge：Minecraft 1.21.6–1.21.8、Java 21、NeoForge 21.6 或更高版本。
• CrowBar-1.21.9-1.21.10-neoforge：Minecraft 1.21.9–1.21.10、Java 21、NeoForge 21.9 或更高版本。
• CrowBar-1.21.x-neoforge：Minecraft 1.21.11、Java 21、NeoForge 21.11 或更高版本。
• CrowBar-26.1.x-neoforge：Minecraft 26.1.x、Java 25、NeoForge 26.1 或更高版本。
• CrowBar-26.2.x-neoforge：Minecraft 26.2、Java 25、NeoForge 26.2 或更高版本。
• CrowBar-26.3.x-neoforge：Minecraft 26.3、Java 25、NeoForge 26.3（测试版）或更高版本。

Fabric 上的模组菜单为可选项。始终可以按 \ 键打开设置界面；NeoForge 上则可以通过模组列表中的“配置”按钮打开。

控制

默认按键绑定：

• N：切换定位栏名称标签
• B：切换定位栏皮肤
• Z：切换领地路径点
• X：显示距离
• \：打开 CrowBar 设置
• 查看自身：未绑定

可以在 Minecraft 的控制菜单中 CrowBar 分类下更改按键绑定，也可以在设置界面的“控制”选项卡中点击“按键绑定”按钮进行更改。

在“控制”选项卡中，每个功能键（名称标签、皮肤、距离、查看自身）都可以设置为 切换 或 按住。选择“切换”后，每次按下按键都会切换功能状态，并记住该选择。选择“按住”后，只有按住按键时功能才会启用，例如按住 X 查看距离。

设置

设置界面分为三个选项卡。默认设置保留了 CrowBar 的原有外观：外观选项默认关闭，只有“调暗其他标签”默认开启。

常规：名称标签、皮肤、距离、查看自身和高度箭头。

外观：

| 设置 | 默认值 | 作用 |
| — | — | — |
| 标签背景 | 关闭 | 在每个标签后绘制深色底板，使其在明亮地形上也清晰可读。 |
| 抬高 HUD | 关闭 | 显示任何标签时，平滑地将生命值、饥饿值、经验等级和聊天框抬到标签上方。 |
| 淡化其他标签 | 开启 | 降低除准星最近处标签以外的所有标签的不透明度。 |
| 隐藏重叠标签 | 关闭 | 跳过会与准星附近标签重叠的标签。 |
| 皮肤边框 | 关闭 | 在玩家点的颜色边框内绘制头像，这样即使启用了皮肤，队伍颜色也能保持可见。 |
| 淡化远处标记 | 关闭 | 淡化距离在 100 到 1000 格之间的标记。 |
| 点的颜色 | 队伍 | 使用队伍颜色、为每位玩家指定独立颜色（忽略队伍），或为所有人使用同一种颜色。 |
| 单一颜色 | 白色 | “单一颜色”模式使用的颜色。 |
| 你的点颜色 | 自动 | 视角自身模式下你自己的标记颜色。不会影响其他玩家的屏幕。 |

控制：为每项功能键设置切换或按住触发方式，并可使用 Minecraft 的按键绑定快捷键。

设置保存在 config/crowbar.json。少数值仅能在文件中设置：fadeStart、fadeEnd 和 fadeEndOpacity 用于设定淡化范围；customDotColor 和 selfDotColor 则接受任意 #RRGGBB 颜色，而不局限于界面轮换显示的颜色。

在未安装 Allium 的服务器上，Minecraft 1.21.6 及更高版本会自行绘制定位栏上的点。CrowBar 仍会通过重新着色原版的点来应用点颜色，但这些点无法淡化，因此只有头像和标签会淡化，原版自身的高度箭头则始终显示。

安装

Fabric

1. 为你的 Minecraft 版本安装 Fabric Loader。
2. 安装 Fabric API。
3. 将对应版本的 CrowBar jar 放入你的 mods 文件夹。
4. 启动游戏。

NeoForge

1. 为你的 Minecraft 版本安装 NeoForge。
2. 将对应版本的 CrowBar NeoForge jar 放入你的 mods 文件夹。
3. 启动游戏。

构建

./gradlew build
# or per version/loader:
./gradlew :version21_0:fabric:build :version21_2:neoforge:build :version21_6:fabric:build

每个受支持的 Minecraft 系列都有 fabric 和 neoforge 子项目：

| 目录 | Minecraft | 加载器 |
| ————- | ——————– | —————– |
| version21_0 | 1.21 – 1.21.1 | Fabric、NeoForge |
| version21_2 | 1.21.2 – 1.21.5 (NeoForge 1.21.3 – 1.21.5) | Fabric、NeoForge |
| version21_6 | 1.21.6 – 1.21.8 | Fabric、NeoForge |
| version21_9 | 1.21.9 – 1.21.11 | Fabric、NeoForge |
| version21 | 1.21.11 | NeoForge |
| version26_1 | 26.1.x | Fabric、NeoForge |
| version26_2 | 26.2.x | Fabric、NeoForge |
| version26_3 | 26.3.x | Fabric、NeoForge |

bukkit/ 存放服务器插件。每个加载器 jar 都会将其打包在内（参见 gradle/universal-jar.gradle），而 bukkit/build/libs/CrowBar-plugin-<version>.jar 是独立的插件。

构建好的 jar 会输出到 versionXX/<loader>/build/libs/。所有 jar 共用、与加载器无关的逻辑位于 common/，并会打包进每个 jar 中，包括设置模型及其文件、按住/切换按键处理、HUD 抬升动画、标签重叠规则、点颜色和淡化。每个 jar 都包含一份独立的 assets/crowbar/lang/en_us.json；如果这些副本不一致，或缺少设置界面使用的按键，共用测试就会失败。

NeoForge 说明：NeoForge 的 JAR 使用 ModDevGradle，并基于官方映射编译；26.x 的 NeoForge 子项目面向 Java 25（对应的 Minecraft 版本线要求使用该版本），其他版本均面向 Java 21。NeoForge 构建按 Minecraft 版本线拆分，因为 Mojang 的类名重映射（例如在 1.21.11 中，ResourceLocation → Identifier）会改变 API 接口。26.3 还将 GLFW 替换为 SDL3，因此按键绑定和修饰键检查改为通过 InputConstants 实现，而非使用 LWJGL 的 GLFW 绑定。

链接

• 网站：https://castled.codes
• 问题反馈：https://github.com/castledking/CrowBar/issues
• 上游灵感来源：https://github.com/MCRcortex/headlocatorbar
• 经验条标记、标签板、HUD 抬升和距离渐隐效果的灵感来自 Player Locator Plus：https://github.com/timas130/PlayerLocatorPlus