🧭 FellowFinder Light
An ultra-lightweight mod for sensing teammates beyond your visual range.
专注超视距队友感知的超轻量模组。
Even when friends are out of sight, you can still feel each other's direction. No maps, no waypoints — just a clean compass bar that tells you where your friends are, how far away they are, and whether they're above or below you.
✨ Features | 功能
- 🧭 Compass Bar HUD | 罗盘条 HUD — Displays other players' direction, height arrow (↑/↓/I), name, and distance at the top of the screen
- 🎨 UUID-Based Fixed Colors | UUID 固定颜色 — Each player gets a unique, consistent color generated from their UUID
- 👻 Vanilla Visibility Rules | 遵循原版可见性规则 — Sneaking, invisible, spectator, and head-covered players are automatically hidden
- 📡 LAN & Server Broadcast | 局域网与服务器广播 — Host/server auto-broadcasts positions every 2 seconds for beyond-visual-range tracking
- 🪶 Ultra Lightweight | 极致轻量 — Minimal performance impact
- ⌨️ F1 Auto-Hide | F1 一键隐藏 — Auto-hides with the vanilla HUD
🔧 New in 26.1.2 | 26.1.2 新增
- Fabric + NeoForge Dual Support | 同时支持 Fabric 和 NeoForge
- 3-Tier Broadcast Mode | 3 档广播模式 — All / Friends Only / None
- 3 Distance Display Modes | 3 种距离显示模式 — Horizontal distance / Straight-line distance / Hidden
- Cross-Dimension Conversion | 跨维度坐标换算 — Nether ↔ Overworld auto conversion (disabled by default), distances marked with
[17.3m]brackets - Local Blacklist | 本地黑名单 — Block specific players, or use
ALLto block everyone - Auto-Fade Animation | 自动上隐动画 — Compass bar smoothly fades out when no players are nearby
- Adjustable Y Position & Display Angle | 可调 Y 轴位置和显示角度 — Customize via Mod Menu (Fabric) or config file
- Test Mode | 测试模式 — Place a test marker 2 blocks in front to preview and adjust compass position
- Full Display Mode | 完全显示模式 — Bypass all visibility filters when needed
🖥️ Server Plugin Addon | 服务端插件加成
This mod can work with the FellowFinder Light server plugin (Paper / Lophine) for an enhanced experience. Download it on Modrinth: [https://modrinth.com/plugin/fellowfinder-light]
本模组可配合 FellowFinder Light 服务端插件（Paper / Lophine）获得更完整的体验。在 Modrinth 下载：[https://modrinth.com/plugin/fellowfinder-light]
| Without Plugin | With Plugin |
|---|---|
| All players are visible by default | Players must mutually agree to share positions |
| No permission control | /ffl share/accept/cancel commands |
| Basic broadcast only | AFK detection, TPS throttling, persistent pairing |
| Chat-based only for non-mod users | Cross-dimension friend tracking via compass |
No mod? No problem. Players without the mod can still use /ffl commands, they just won't see the compass bar. Everyone benefits from the plugin's location system.
没装模组？没关系。 没装模组的玩家也能用 /ffl 指令互相申请位置共享，只是看不到罗盘条而已。装了模组的玩家则可以在罗盘条上实时看到好友位置。
📥 Installation | 安装方法
- Download the
.jarfrom the version page - Place it in
.minecraft/mods/ - Ensure Fabric Loader (≥0.16.0) + Fabric API (Fabric) or NeoForge (NeoForge) are installed
- For Fabric: install Mod Menu for the config GUI
- Launch the game
For the server plugin, visit the (https://modrinth.com/plugin/fellowfinderlightplugin)
🎮 Supported Versions | 支持版本
| Minecraft | Mod Loader | Status |
|---|---|---|
| 26.1.2 | Fabric | ✅ Released |
| 26.1.2 | NeoForge | ✅ Released |
| 1.21 | Fabric | ✅ Legacy |
🧑🤝🧑 Credits | 致谢
- Apeiria_ — Author
- slkhsgvsvn (qh) — Testing
- Kaleido_Flow — Testing
- 134jijie — Testing
📄 License | 许可证
This project is licensed under Apache-2.0. You may freely use, modify, and distribute this mod, provided you retain the copyright notice.
本项目采用 Apache-2.0 许可证。你可以自由使用、修改、分发本模组，但需保留版权声明。
