FellowFinderLightPlugin

🧭 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:position for 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 | 安装方法

1. Place the .jar in your server's plugins/ folder | 将 .jar 放入服务器 plugins/ 文件夹
2. Restart the server | 重启服务器
3. Players can start using /ffl commands immediately | 玩家即可开始使用 /ffl 指令
4. 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_