CraftHub
FellowFinderLightPlugin

FellowFinderLightPlugin

A Paper / Lophine server plugin that lets players share their positions by mutual agreement.

12 downloads
1 followers

🧭 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_

No gallery available for this project.