🧭 FellowFinder Light — Server Plugin | 服务端插件
A Paper / Lophine server plugin that lets players share their location by mutual agreement. No client mod required for basic features.
一个让玩家可以互相申请位置共享的 Paper/Lophine 服务端插件。没装模组也能用基础功能。
📋 Commands | 指令
| Command | Effect | 效果 |
|---|---|---|
/ffl share <player> |
Request location sharing | 申请位置共享 |
/ffl accept <player> |
Accept a request | 接受申请 |
/ffl deny <player> |
Deny a request | 拒绝申请 |
/ffl cancel <player> |
Cancel sharing | 取消共享 |
/ffl list |
List paired friends | 查看配对好友 |
/ffl locate <player> |
Get direction and distance | 查看好友方位与距离 |
/ffl status |
Plugin status | 插件状态 |
/ffl help |
Show help | 帮助 |
🔧 Admin Commands | 管理指令
| Command | Effect | 效果 |
|---|---|---|
/ffl admin ban <player> |
Ban a player from FFL | 封禁某个玩家的 FFL 功能 |
/ffl admin unban <player> |
Unban a player | 解封 |
/ffl admin reload |
Reload config | 重载配置 |
Requires ffl.admin permission or OP status. | 需要 ffl.admin 权限或 OP 身份。
✨ Features | 功能
Location Sharing | 位置共享
- Players mutually agree to share positions via simple commands | 玩家通过简单指令互相申请位置共享
- Either party can cancel sharing at any time | 任何一方可随时取消
- Pairing data persists across server restarts | 配对数据重启不丢失
Performance Optimization | 性能优化
- AFK detection: players who haven't moved for 60s stop broadcasting (marked as "stay") | 挂机检测：60 秒无移动停止广播
- TPS throttling: broadcast frequency automatically reduces when server TPS drops | TPS 降级：服务器负载高时自动降低广播频率
- Lightweight, minimal performance impact | 轻量，几乎不影响性能
🔗 FellowFinder Light Client Mod | 客户端模组
- The companion client mod (Fabric / NeoForge) adds an on-screen compass bar that shows paired friends in real time. Download it on Modrinth: https://modrinth.com/mod/fellowfinder-light
- 配套的客户端模组（Fabric / NeoForge）会在屏幕上显示罗盘条，实时展现配对好友的位置。可在 Modrinth 下载：https://modrinth.com/mod/fellowfinder-light
Plugin-Mod Integration | 模组联动
- Works with the FellowFinder Light client mod (Fabric / NeoForge) for an on-screen compass bar | 配合客户端模组可在屏幕上显示罗盘条
- Uses Plugin Messaging Channel
ffl:positionfor real-time data | 通过插件消息通道实时传输位置数据 - Mod users see paired friends directly on the compass | 模组玩家在罗盘条上直接看到配对好友
Cross-Platform Compatibility | 跨平台兼容
- Paper, Purpur, Spigot | ✅ Supported
- Folia-based servers (Lophine, Luminol, LightingLuminol) | ✅ Automatically detected and adapted
- Fabric, NeoForge servers | ❌ Not compatible (use the mod instead)
📥 Installation | 安装方法
- Place the
.jarin your server'splugins/folder | 将.jar放入服务器plugins/文件夹 - Restart the server | 重启服务器
- Players can start using
/fflcommands immediately | 玩家即可开始使用/ffl指令 - Optional: install the FellowFinder Light client mod for the compass bar HUD | 可选：安装客户端模组获得罗盘条 HUD
Configuration file: plugins/FellowFinderLight/config.yml | 配置文件位置：plugins/FellowFinderLight/config.yml
📄 License | 许可证
Apache-2.0 © 2026 Apeiria_
