Waypoint Compass 是一款小巧、无 mixin、仅客户端的 Fabric 模组,专为那些只需要一个“标记位置,找到回去的路”的工具的玩家设计——无需安装整个小地图套件。按下按键即可保存当前位置。离开后,HUD 顶部会出现一个简洁的指南针条,显示指向该位置的箭头以及你需要行走的距离。
功能
- 一键保存。 在任何地方按下 B 键,将当前的 X、Y、Z 坐标保存为新的航点。模组会在操作栏中确认(
Waypoint saved: WP 1 (123, 64, -512))。
- HUD 指南针。 屏幕正上方中央有一个小条形栏,显示箭头、航点名称以及实时距离(米/千米)。当你转身时,箭头会随之旋转,因此“↑”始终表示“航点就在正前方”。
- 循环切换已保存的位置。 按 N 键切换指南针当前跟踪的航点。非常适合拥有多个基地的设置。
- 删除当前标记。 按 K 键移除你正在跟踪的航点。无需打开菜单。
- 切换 HUD 显示。 按 H 键隐藏或重新显示指南针,而不会丢失已保存的航点。
- 维度感知。 每个航点都会记住它是在哪个维度保存的。如果你身处下界,而航点位于主世界,指南针会显示
in Overworld(在主世界),而不是显示具有误导性的距离。
- 持久化存储。 航点存储在
config/waypoints.json 文件中,重启游戏后依然存在。
- 无 mixin。无需服务器安装。 纯客户端模组——适用于任何服务器,包括原版 Realms。
默认按键
| 按键 |
动作 |
| B |
将当前位置保存为新的航点 |
| N |
切换到下一个已保存的航点 |
| K |
删除当前正在跟踪的航点 |
| H |
开启/关闭 HUD 指南针 |
按键通过 GLFW 直接从操作系统读取,因此会忽略 Minecraft 的输入路由——但在 GUI(聊天、告示牌编辑、物品栏)打开期间会被抑制,以防止在打字过程中误触发。
跨版本支持
已在 1.21.8、1.21.9、1.21.10、1.21.11 上测试。一个 JAR 文件,一次安装即可使用。
注意事项
- 指南针显示的是水平距离(XZ),也就是你实际行走的距离——高度差不会导致数值膨胀。
- 这有意不是一个迷你地图。没有世界内的 3D 标记;其核心理念是“仅一行 HUD 界面,零杂乱元素。”
Waypoint Compass is a tiny, mixin-free, client-only Fabric mod for players who just want a "drop a pin, find your way back" tool — without installing a whole minimap suite. Press a key, the spot is saved. Walk away, and a slim compass strip at the top of your HUD shows an arrow pointing back and how far you have to go.
Features
- One-key save. Press B anywhere to save your current X, Y, Z as a new waypoint. The mod confirms in the action bar (
Waypoint saved: WP 1 (123, 64, -512)).
- HUD compass. A small bar at the top center of your screen shows an arrow, the waypoint name, and the live distance in meters / km. The arrow rotates as you turn, so "↑" always means "the waypoint is straight ahead".
- Cycle through saved spots. Press N to switch which waypoint the compass is tracking. Great for multi-base setups.
- Delete the current pin. Press K to remove the waypoint you're tracking. No menu required.
- Toggle the HUD. Press H to hide or re-show the compass without losing your saved points.
- Dimension-aware. Each waypoint remembers the dimension it was saved in. If you're in the Nether and the waypoint is in the Overworld, the compass shows
in Overworld instead of a misleading distance.
- Persistent. Waypoints are stored in
config/waypoints.json and survive restarts.
- No mixins. No server install. Pure client mod — works on any server, including vanilla Realms.
Default keys
| Key |
Action |
| B |
Save current position as a new waypoint |
| N |
Cycle to next saved waypoint |
| K |
Delete the currently tracked waypoint |
| H |
Toggle the HUD compass on/off |
Keys are read directly from the OS via GLFW, so they ignore Minecraft's input routing — but they're suppressed while a GUI (chat, sign edit, inventory) is open, so they won't fire mid-type.
Cross-version
Tested on 1.21.8, 1.21.9, 1.21.10, 1.21.11. One JAR, one install.
Notes
- The compass shows horizontal distance (XZ), which is what you actually walk — height differences don't inflate the number.
- This is intentionally NOT a minimap. There's no in-world 3D marker; the whole point is "one HUD line, zero clutter."
评论 0
登录后参与评分
还没有评论,来抢沙发吧