FellowFinder Light

🧭 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 ALL to 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 | 安装方法

1. Download the .jar from the version page
2. Place it in .minecraft/mods/
3. Ensure Fabric Loader (≥0.16.0) + Fabric API (Fabric) or NeoForge (NeoForge) are installed
4. For Fabric: install Mod Menu for the config GUI
5. 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 许可证。你可以自由使用、修改、分发本模组，但需保留版权声明。