? FindBuddy - Minecraft 玩家追踪插件
? 用附魔指南针追踪你的朋友!
⚡ 通过动作栏实时更新位置信息!
? 基于权限的安全追踪系统!
? 功能特性
- ? 智能指南针 - 可指向被追踪玩家或自定义路标的附魔指南针
- ? 实时追踪 - 在动作栏中显示实时的距离和方向更新
- ? 权限系统 - 可选的请求式追踪(类似 TPA)
- ? 跨世界支持 - 可在不同世界和维度间工作
- ⚙️ 高度可配置 - 自定义距离、冷却时间和通知设置
- ?️ 管理工具 - 用于服务器管理的清理命令
- ? 自动清理 - 自动移除指南针以防止问题发生
- ?️ 路标 - 使用指南针设置、移除和定位自定义路标
? 安装方法
- 下载 最新 JAR 文件
- 放置 到服务器的
plugins/文件夹中 - 重启 你的服务器
- 配置 使用生成的
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: "允许使用路标命令"
? 工作原理
- 玩家 A 使用
/findbuddy locate PlayerB - 系统检查 是否需要请求
- 如果是直接追踪:玩家 A 获得指南针并开始追踪
- 如果需要请求:玩家 B 收到接受/拒绝的请求
- 动作栏显示 实时距离和方向
- 指南针指向 玩家 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 消息格式化
贡献指南
- Fork 仓库
- 创建 功能分支
- 进行修改 遵循 Kotlin 规范
- 添加测试 针对新功能
- 提交 拉取请求
? 许可证
本项目采用 MIT License 许可。
⭐ 如果觉得有用,请给本仓库点赞!
? 在 GitHub 上报告问题
? 建议功能和改进
由 Mohammad Faizan 用 ❤️ 制作
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧