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_