
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 的 Mod Menu 中或 NeoForge 的模组列表中均可访问。
- 每个功能按键都可以设置为点击切换或按住生效。
- 可选的外观设置:深色标签背景、平滑悬浮的 HUD、重叠隐藏、带队伍颜色的皮肤边框、可配置的圆点颜色以及距离渐隐效果。“Dim other labels”(淡化其他标签)默认开启;其他外观选项默认关闭。
- 作为纯客户端模组运行:服务器或其他玩家无需安装 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 格,因此更远的玩家不会显示。
玩家从栏中隐藏的方式与在 1.21.6 及更高版本的原版定位器栏中相同:通过潜行、隐身、佩戴雕刻南瓜或生物头颅,或处于旁观模式。
Server Plugin
每个 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 |
pumpkin and mob heads |
佩戴后使玩家隐藏的头部物品。 |
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 |
none |
按玩家名称固定的颜色,类似于 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 |
op |
看到正在潜行、隐形、旁观或佩戴隐藏头部物品的玩家。相当于 Allium 的 allium.crowbar。隐身插件隐藏的玩家会对任何被其插件隐藏的人保持隐藏状态。 |
crowbar.locator.hidden |
无人 |
永远不出现在任何人的状态栏上。 |
crowbar.color / crowbar.color.others |
所有人 / op |
/crowbar color <#RRGGBB|reset> [player] |
crowbar.claims |
所有人 |
/crowbar claims <own|trusted|off>:决定哪些领地在你的原版状态栏中显示。 |
crowbar.claims.admin |
op |
当 claim-waypoints.admin-claims 开启时,查看管理员领地。 |
crowbar.reload |
op |
/crowbar reload |
该插件适用于从 Minecraft 1.21 到 26.3 的任何服务器,无论哪个 CrowBar jar 文件承载它。原版领地标记需要 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 (beta) 或更高版本。
在 Fabric 上,Mod Menu 是可选的。设置屏幕始终可以通过 \ 键访问,在 NeoForge 上则通过模组列表中的 Config 按钮访问。
控制
默认按键绑定:
N: 切换定位器名称标签
B: 切换定位器皮肤
Z: 切换领地路标
X: 显示距离
\: 打开 CrowBar 设置
- 查看自身:未绑定
可以从 Minecraft 的控制菜单下的 CrowBar 类别更改按键绑定,也可以从设置屏幕的 Controls(控制)选项卡上的 Key Binds(按键绑定)按钮进行更改。
每个功能键(名称标签、皮肤、距离、查看自身)都可以在 Controls(控制)选项卡上设置为 Toggle(切换)或 Hold(按住)。Toggle 每次按下都会翻转功能状态并记住选择。Hold 仅在按住按键时显示功能,例如按住 X 来检查距离。
设置
设置屏幕有三个选项卡。默认设置保持了 CrowBar 的原始外观:外观选项默认关闭,除了 Dim other labels(淡化其他标签),它默认保持开启。
General(常规): 名称标签、皮肤、距离、查看自身和高度箭头。
Appearance(外观):
| 设置项 |
默认值 |
功能说明 |
| 标签背景 |
关闭 |
在每个标签后方绘制深色底板,使其在明亮地形上保持可读性。 |
| 提升 HUD |
关闭 |
当显示任何标签时,平滑地将生命值、饥饿值、经验等级和聊天窗口抬升至标签上方。 |
| 淡化其他标签 |
开启 |
除准星最近的标签外,以较低透明度绘制所有其他标签。 |
| 隐藏重叠标签 |
关闭 |
跳过会与更靠近准星的标签发生重叠的标签。 |
| 皮肤框架 |
关闭 |
以玩家团队颜色在框架内绘制面部头像,确保佩戴皮肤时团队颜色依然可见。 |
| 淡化远处标记 |
关闭 |
在 100 至 1000 格距离之间对标记进行淡入/淡出处理。 |
| 点颜色 |
团队 |
团队颜色或每个玩家独立的颜色;忽略团队的单玩家独立颜色;或所有人统一使用单一颜色。 |
| 单一颜色 |
白色 |
“单一颜色”模式所使用的颜色。 |
| 你的点颜色 |
自动 |
在“查看自身”模式下你自身标记的颜色。不会影响其他玩家的屏幕。 |
控制: 为每个功能特性切换或按住按键,并支持 Minecraft 快捷键绑定。
设置保存于 config/crowbar.json。文件中仅包含少数几个值:fadeStart、fadeEnd 和 fadeEndOpacity 用于设置淡入淡出的范围,而 customDotColor 和 selfDotColor 接受任意 #RRGGBB 格式的颜色,不限于屏幕循环显示的颜色。
在没有 Allium 的服务器上,Minecraft 1.21.6 及更高版本会自行绘制定位栏的点。CrowBar 仍通过重绘原版点来应用点颜色,但这些点无法淡化,因此只有面部头像和标签会淡化,原版的箭头始终显示高度信息。
安装
Fabric
- 为你的 Minecraft 版本安装 Fabric Loader。
- 安装 Fabric API。
- 将匹配的 CrowBar jar 文件放入
mods 文件夹。
- 启动游戏。
NeoForge
- 为你的 Minecraft 版本安装 NeoForge。
- 将匹配的 CrowBar NeoForge jar 文件放入
mods 文件夹。
- 启动游戏。
构建
./gradlew build
# 或按版本/加载器分别构建:
./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 绑定进行。
链接
- 官网:
- 问题反馈:
- 上游灵感来源:
- 经验条标记、标签底板、HUD 抬升和距离淡化效果受 Player Locator Plus 启发:

CrowBar is a client mod for Minecraft 1.21-1.21.11, 26.1.x, 26.2, and 26.3 that extends the locator bar with readable player name tags, skin markers, distance text, team-colored dots, and a self-view capture mode. On 1.21-1.21.5, which have no locator bar, it draws the same markers over the experience bar. Available for both Fabric and NeoForge.
Features
- Renders player names above locator bar markers.
- Can replace locator dots with player skin faces.
- Shows optional distance text next to player names.
- Preserves team colors when a team color is available.
- Adds a self-view mode for clean locator bar screenshots.
- Hides hearts, hunger, armor, and the vanilla locator bar while self-view mode is active.
- Brings player markers to Minecraft 1.21-1.21.5 by drawing them over the experience bar.
- Settings screen on the
\ key, in Mod Menu on Fabric, and in the mod list on NeoForge.
- Every feature key can toggle or work only while held.
- Optional appearance settings: dark label backgrounds, a smoothly lifted HUD, overlap hiding, team-colored skin frames, configurable dot colors, and distance fading. Dim other labels remains on by default; the other appearance options are off by default.
- Works as a client-side mod: neither the server nor other players need to install CrowBar.
- Every jar is also an optional Paper, Spigot and Folia plugin that sends CrowBar players' positions and GriefPrevention claim markers. See Server Plugin.
Minecraft 1.21-1.21.5
Minecraft added the locator bar in 1.21.6. On 1.21-1.21.5 CrowBar draws its markers over the experience bar instead, with the same names, faces, distances, colors and settings. In creative, where there is no experience bar, it draws a thin track for the markers to sit on.
Only you need CrowBar; other players do not need the client mod. A server plugin is optional. Because Minecraft 1.21-1.21.5 has no locator bar for the server to fill, CrowBar gets positions this way:
- Singleplayer and LAN hosts: every player in your world, at any distance.
- Servers running the CrowBar plugin or Allium: every player the server shares, at any distance.
- Any other server: only the players your client already has loaded. That ends at the server's player tracking range, 48 blocks by default on Paper and Spigot, so farther players do not appear.
Players hide from the bar the same way they do from vanilla's locator bar on 1.21.6 and later: by sneaking, being invisible, wearing a carved pumpkin or mob head, or spectating.
Server Plugin
Every CrowBar jar is also a server plugin. Drop the jar for your server's Minecraft version into a Paper, Spigot, Purpur or Folia server's plugins folder; the same file that is a Fabric or NeoForge mod on a client is a Bukkit plugin on a server. CrowBar-plugin-<version>.jar on the GitHub release is the plugin on its own.
The plugin is optional, and players without CrowBar are unaffected by it. It has two parts.
Player locator. Sends CrowBar players the positions of everyone in their world, so the bar shows players far beyond the server's tracking range. That matters most on 1.21-1.21.5, where CrowBar otherwise only sees nearby players. Hidden players are left out of the data entirely, so their position never reaches anyone's client. It brings over the server settings from Player Locator Plus:
| Setting |
Default |
What it does |
player-locator.update-interval-ticks |
2 |
Ticks between updates. |
player-locator.max-distance |
0 |
Farthest a player can be and still appear. 0 is unlimited. |
hide-when.sneaking / invisible / spectating / vanished |
true |
Who stays off the bar, matching vanilla's locator bar. |
hide-when.head-items |
pumpkin and mob heads |
Head items that hide whoever wears them. |
precision.direction-steps |
0 |
Rounds directions so players cannot be triangulated. Player Locator Plus uses 300. |
precision.send-distance |
true |
When off, CrowBar shows only which way players are, with ?m for the distance. |
precision.round-distance-beyond / round-distance-to |
200 / 0 |
Rounds far distances to a multiple. |
colors.mode |
team |
team, unique, constant, or custom (players pick with /crowbar color). |
colors.players |
none |
Fixed colors by player name, like Allium's player-colors. |
Claim waypoints. With GriefPrevention or GriefPrevention3D installed, claims appear on the locator bar as bowtie markers to their owner and anyone trusted on them, the same markers GPExpansion publishes. CrowBar players see every claim they have access to at any distance. On Paper 1.21.6 and newer, players without CrowBar get the markers on their vanilla locator bar too, within claim-waypoints.vanilla-marker-range (1000 blocks by default). Subdivisions and admin claims are off by default.
If Allium or GPExpansion is installed, the matching part steps aside so nothing is sent twice. GPExpansion's claim markers add custom names, colors, claim spawns and published claims; this plugin names claims after their owner and anchors them at their center.
| Permission |
Default |
|
crowbar.locator |
everyone |
Receive other players' positions. |
crowbar.locator.see-hidden |
op |
See players who are sneaking, invisible, spectating or wearing a hiding head item. The equivalent of Allium's allium.crowbar. Vanished players stay hidden from anyone their vanish plugin hides them from. |
crowbar.locator.hidden |
nobody |
Never appear on anyone's bar. |
crowbar.color / crowbar.color.others |
everyone / op |
/crowbar color <#RRGGBB|reset> [player] |
crowbar.claims |
everyone |
/crowbar claims <own|trusted|off>: which claims show on your vanilla bar. |
crowbar.claims.admin |
op |
See admin claims when claim-waypoints.admin-claims is on. |
crowbar.reload |
op |
/crowbar reload |
The plugin runs on any server from Minecraft 1.21 to 26.3 regardless of which CrowBar jar carries it. Vanilla claim markers need Paper on 1.21.6 or newer; elsewhere only CrowBar players see claims.
Allium Servers
Allium Essentials is an optional Paper server plugin that can send CrowBar a dedicated locator payload. When Allium is installed, CrowBar does not have to rely on vanilla locator waypoints: the server can send the player UUID, position, team color, and visibility state needed for the custom locator bar.
That lets CrowBar keep rendering players who are hidden, sneaking, invisible, or otherwise missing from vanilla waypoint data. It also lets the server keep NPC waypoint transmit range at zero while still giving CrowBar the real player data it needs.
Without Allium, CrowBar falls back to normal client-visible players, including LAN and integrated-server sessions.
GPX-CrowBar
When GPExpansion is installed on the server, claim waypoints display the claim name and a bowtie marker on the locator bar to the claim owner and trusted players. CrowBar reads the same locator data and renders the name tag above the waypoint, giving you readable claim labels right on the locator bar.

Requirements
Use the jar that matches your Minecraft line and loader:
Fabric
CrowBar-1.21-1.21.1: Minecraft 1.21-1.21.1, Java 21, Fabric Loader 0.18.4 or newer, Fabric API 0.100.1 or newer.
CrowBar-1.21.2-1.21.5: Minecraft 1.21.2-1.21.5, Java 21, Fabric Loader 0.18.4 or newer, Fabric API 0.102.2 or newer.
CrowBar-1.21.6-1.21.8: Minecraft 1.21.6-1.21.8, Java 21, Fabric Loader 0.18.4 or newer, Fabric API 0.125.0 or newer.
CrowBar-1.21.x: Minecraft 1.21.9-1.21.11, Java 21, Fabric Loader 0.18.4 or newer, Fabric API 0.134.0 or newer.
CrowBar-26.1.x: Minecraft 26.1.x, Java 25, Fabric Loader 0.19.2 or newer, Fabric API 0.145.1 or newer.
CrowBar-26.x: Minecraft 26.2, Java 25, Fabric Loader 0.19.3 or newer, Fabric API 0.152.2 or newer.
CrowBar-26.3.x: Minecraft 26.3, Java 25, Fabric Loader 0.19.5 or newer, Fabric API 0.160.7 or newer.
NeoForge
CrowBar-1.21-1.21.1-neoforge: Minecraft 1.21-1.21.1, Java 21, NeoForge 21.0 or newer.
CrowBar-1.21.3-1.21.5-neoforge: Minecraft 1.21.3-1.21.5, Java 21, NeoForge 21.3 or newer. NeoForge never had a stable 1.21.2 release.
CrowBar-1.21.6-1.21.8-neoforge: Minecraft 1.21.6-1.21.8, Java 21, NeoForge 21.6 or newer.
CrowBar-1.21.9-1.21.10-neoforge: Minecraft 1.21.9-1.21.10, Java 21, NeoForge 21.9 or newer.
CrowBar-1.21.x-neoforge: Minecraft 1.21.11, Java 21, NeoForge 21.11 or newer.
CrowBar-26.1.x-neoforge: Minecraft 26.1.x, Java 25, NeoForge 26.1 or newer.
CrowBar-26.2.x-neoforge: Minecraft 26.2, Java 25, NeoForge 26.2 or newer.
CrowBar-26.3.x-neoforge: Minecraft 26.3, Java 25, NeoForge 26.3 (beta) or newer.
Mod Menu is optional on Fabric. The settings screen is always available on the \ key, and on NeoForge through the mod list's Config button.
Controls
Default keybinds:
N: Toggle locator name tags
B: Toggle locator skins
Z: Toggle claim waypoints
X: Show distance
\: Open CrowBar settings
- View self: unbound
Keybinds can be changed from Minecraft's controls menu under the CrowBar category, or from the Key Binds button on the settings screen's Controls tab.
Each feature key (name tags, skins, distance, view self) can be set to Toggle or Hold on the Controls tab. Toggle flips the feature with each press and remembers the choice. Hold shows the feature only while the key is down, for example holding X to check distances.
Settings
The settings screen has three tabs. The defaults keep CrowBar's original look: appearance options are off by default, except Dim other labels, which stays on.
General: name tags, skins, distance, view self, and height arrows.
Appearance:
| Setting |
Default |
What it does |
| Label background |
Off |
Draws a dark plate behind each label so it stays readable over bright terrain. |
| Raise HUD |
Off |
Smoothly lifts hearts, hunger, the experience level and chat above the labels while any label is showing. |
| Dim other labels |
On |
Draws every label except the one nearest your crosshair at reduced opacity. |
| Hide overlapping labels |
Off |
Skips labels that would overlap one nearer your crosshair. |
| Skin frame |
Off |
Draws faces inside a frame in the player's dot color, so team colors stay visible with skins on. |
| Fade distant markers |
Off |
Fades markers between 100 and 1000 blocks. |
| Dot colors |
Team |
Team color or a color unique to each player, a color per player ignoring teams, or one single color for everyone. |
| Single color |
White |
The color used by the Single color mode. |
| Your dot color |
Automatic |
Your own marker's color in view-self mode. Other players' screens are not affected. |
Controls: Toggle or Hold for each feature key, and a shortcut to Minecraft's key binds.
Settings are saved to config/crowbar.json. A few values only live in the file: fadeStart, fadeEnd and fadeEndOpacity set the fade range, and customDotColor and selfDotColor accept any #RRGGBB color, not just the colors the screen cycles through.
On servers without Allium, Minecraft 1.21.6 and later draw the locator bar dots themselves. CrowBar still applies dot colors there by repainting vanilla's dots, but those dots cannot fade, so only faces and labels fade, and vanilla's own height arrows always show.
Installation
Fabric
- Install Fabric Loader for your Minecraft version.
- Install Fabric API.
- Put the matching CrowBar jar into your
mods folder.
- Launch the game.
NeoForge
- Install NeoForge for your Minecraft version.
- Put the matching CrowBar NeoForge jar into your
mods folder.
- Launch the game.
Building
./gradlew build
# or per version/loader:
./gradlew :version21_0:fabric:build :version21_2:neoforge:build :version21_6:fabric:build
Each supported Minecraft line has fabric and neoforge subprojects:
| Directory |
Minecraft |
Loaders |
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/ holds the server plugin. Every loader jar bundles it (see gradle/universal-jar.gradle), and bukkit/build/libs/CrowBar-plugin-<version>.jar is the plugin on its own.
The built jars are written to versionXX/<loader>/build/libs/. Loader-agnostic logic shared by all jars lives in common/ and is bundled into each jar: the settings model and its file, hold/toggle key handling, the HUD lift animation, label overlap rules, dot colors and fading. Every jar ships its own copy of assets/crowbar/lang/en_us.json; the common tests fail if the copies drift apart or miss a key the settings screen uses.
NeoForge notes: the NeoForge jars use ModDevGradle and compile against official mappings; the 26.x NeoForge subprojects target Java 25 (their Minecraft line requires it), everything else targets Java 21. NeoForge builds are split per Minecraft line because Mojang's class renames (e.g. ResourceLocation → Identifier in 1.21.11) change the API surface. 26.3 also replaced GLFW with SDL3, so its keybinds and modifier checks go through InputConstants instead of LWJGL's GLFW bindings.
Links
- Website:
- Issues:
- Upstream inspiration:
- Experience bar markers, label plates, HUD lift and distance fading were inspired by Player Locator Plus:
评论 0
登录后参与评分
还没有评论,来抢沙发吧