FindBuddy

插件

· 作者 hellofaizan

在 Minecraft 服务器中找到你的伙伴

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.6 · Paper / Spigot

一键开服(送7天)

? FindBuddy - Minecraft 玩家追踪插件

? 用附魔指南针追踪你的朋友!
⚡ 通过动作栏实时更新位置信息!
? 基于权限的安全追踪系统!


? 功能特性

  • ? 智能指南针 - 可指向被追踪玩家或自定义路标的附魔指南针
  • ? 实时追踪 - 在动作栏中显示实时的距离和方向更新
  • ? 权限系统 - 可选的请求式追踪(类似 TPA)
  • ? 跨世界支持 - 可在不同世界和维度间工作
  • ⚙️ 高度可配置 - 自定义距离、冷却时间和通知设置
  • ?️ 管理工具 - 用于服务器管理的清理命令
  • ? 自动清理 - 自动移除指南针以防止问题发生
  • ?️ 路标 - 使用指南针设置、移除和定位自定义路标

? 安装方法

  1. 下载 最新 JAR 文件
  2. 放置 到服务器的 plugins/ 文件夹中
  3. 重启 你的服务器
  4. 配置 使用生成的 config.yml

要求

  • Minecraft: 1.21+ (Paper/Spigot/Bukkit)
  • Java: 17 或更高版本

? 命令

玩家命令

命令 描述
/findbuddy locate <player> 开始追踪一名玩家
/findbuddy cancel 取消当前追踪
/findbuddy accept 接受追踪请求
/findbuddy decline 拒绝追踪请求
/waypoint set <name> <x> <y> <z> [world] 设置自定义路标
/waypoint remove <name> 移除自定义路标
/waypoint locate <name> 获取通往路标的指南针(靠近时消失)

管理员命令

命令 描述
/findbuddy cleanup <player> 移除某玩家的所有追踪指南针

别名: /fb, /find


?️ 路标

路标让你可以轻松保存和回访自定义地点:

  • 设置路标: /waypoint set home 100 64 200
  • 移除路标: /waypoint remove home
  • 定位路标: /waypoint locate home
    • 给予你一枚发光的附魔指南针,指向你的路标
    • 当你处于可配置的距离内时(默认:配置文件中的 stop_distance),指南针会消失
    • /waypoint set 的 Tab 补全会自动建议你所查看方块的坐标(类似于 /tp)

路标以 JSON 文件格式保存在每个玩家的 Finddata 文件夹中。


⚙️ 配置

# FindBuddy Configuration
tracking:
  stop_distance: 25          # 停止追踪的距离
  notify_target: true        # 当被追踪时通知目标玩家
  require_requests: true     # 需要权限请求
  request_timeout: 90        # 请求超时时间(秒)

compass:
  refresh_cooldown: 20       # 指南针刷新冷却时间(秒)

? 权限

# Basic permissions
findbuddy.find:
  default: true
  description: "允许使用基本 FindBuddy 命令"

# Admin permissions
findbuddy.cleanup:
  default: op
  description: "允许使用清理命令"

# All permissions
findbuddy.*:
  default: op
  children:
    findbuddy.find: true
    findbuddy.cleanup: true
    findbuddy.waypoint: true

findbuddy.waypoint:
  default: true
  description: "允许使用路标命令"

? 工作原理

  1. 玩家 A 使用 /findbuddy locate PlayerB
  2. 系统检查 是否需要请求
  3. 如果是直接追踪:玩家 A 获得指南针并开始追踪
  4. 如果需要请求:玩家 B 收到接受/拒绝的请求
  5. 动作栏显示 实时距离和方向
  6. 指南针指向 玩家 B 的位置

指南针功能

  • 右键点击 刷新位置(有冷却时间)
  • 无法丢弃 或移动至外部物品栏
  • 追踪停止时自动移除
  • 带有附魔效果发光

?️ 故障排除

问题 解决方案
指南针未移除 使用 /findbuddy cleanup <player>
权限被拒 检查 findbuddy.find 权限
玩家无法追踪 验证 require_requests 设置
指南针无效 检查玩家是否在同一世界

?‍? 开发者文档

快速开始

# 克隆并构建
git clone https://github.com/hellofaizan/FindBuddy.git
cd FindBuddy
./gradlew build

# 使用测试服务器运行
./gradlew runServer

项目结构

src/main/kotlin/in/mohammadfaizan/minecraft/
├── FindBuddy.kt                    # 主插件类
├── commands/FindBuddyCommand.kt    # 命令执行器
├── listeners/                      # 事件处理
├── managers/                       # 业务逻辑
├── models/                         # 数据模型
├── utils/                          # 工具类
└── ui/                            # UI 组件

关键组件

  • TrackingManager - 核心追踪逻辑和任务管理
  • CompassManager - 指南针物品的创建和管理
  • ConfigManager - 类型安全的配置访问
  • MessageUtils - 一致的 UI 消息格式化

贡献指南

  1. Fork 仓库
  2. 创建 功能分支
  3. 进行修改 遵循 Kotlin 规范
  4. 添加测试 针对新功能
  5. 提交 拉取请求

? 许可证

本项目采用 MIT License 许可。


⭐ 如果觉得有用,请给本仓库点赞!
? 在 GitHub 上报告问题
? 建议功能和改进

由 Mohammad Faizan 用 ❤️ 制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源