PlayerTracker-unimilk

插件

· 作者 X-xiaohan521

PlayerTracker 是一款易于使用的插件,供 Minecraft 服务器中的管理员(ops)了解在线玩家的坐标和状态。

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

最新 4.1.0 · 1.21.10 · Paper / Spigot

一键开服(送7天)

? PlayerTracker 插件(支持 Spigot/Paper 1.13.x ~ 1.21.x)

? PlayerTracker 是一款轻量级的 Minecraft 1.13.x ~ 1.21.x 服务器插件,允许管理员 追踪在线玩家的坐标和状态。

? 概览

? 最新版本:v4.1.0
? 支持的 Minecraft 版本:1.13.x ~ 1.21.x
? 兼容服务器:Spigot Paper


? 快速开始

1️⃣ 下载

? 点击此处下载 PlayerTracker。

2️⃣ 安装

  1. 下载 .jar 文件。
  2. 将 .jar 文件放入 Minecraft 服务器的 .\plugins 文件夹中。
  3. 停止并重启服务器。
  4. 在游戏中尝试使用 /playertracker 或 /pt 命令。

? 使用方法

? 主要命令

? /playertracker 和 /pt 均可作为有效的命令前缀。为方便起见,以下示例使用 /pt。

命令 描述 所需权限
/pt track 显示所有在线玩家的坐标和状态。 playertracker.use
/pt track <player> 显示指定玩家的坐标和状态。 playertracker.use
/pt log <on/off> 启用/禁用日志记录。 playertracker.admin
/pt log schedule <int> 设置日志记录间隔为 [int] 秒。默认值:300 playertracker.admin
/pt reload 重载配置文件。 playertracker.admin
/pt viewer add/remove <player> 添加/移除指向指定玩家的追踪器。 playertracker.view

❗ 强烈建议 将 PlayerTracker 与 权限控制插件(如 LuckPerms,点击此处了解更多信息)配合使用,以实现比 Minecraft 默认的 "OP" 更 精确的权限控制。

? 功能详情

  1. 基础追踪 /pt track

    当拥有 playertracker.use 权限的玩家或服务器控制台执行 /pt track 命令时,会在聊天栏显示所有在线玩家的坐标和状态,例如:

    ===== Online Players =====
    X_xiaohan521 - World: world - Position: [108 77 -105] - Status: Wandering
    Go_Karoo - World: world - Position: [247 62 -335] - Status: On Vehicle
    

    ? 游戏内的玩家可以点击聊天中的坐标以复制到剪贴板。请注意,Minecraft 版本 1.13.x ~ 1.15.x 不支持此功能。

    若要查询特定玩家,请使用 /pt track <player>。

  2. 日志记录

    当启用日志记录时,玩家活动将自动记录在 .\plugins\PlayerTracker\player_activities.log 中。有关日志语法的解释,请参阅 "文件语法"。

    拥有 playertracker.admin 权限的玩家或服务器控制台可以通过 /pt log on/off 切换日志记录功能。

  3. 实时追踪器 /pt viewer

    拥有 playertracker.view 权限的玩家可以在游戏中执行 /pt viewer add <player> 以在屏幕上显示实时追踪信息,例如:

    Tracking: X_xiaohan521 - World: world - Position: [96 72 34] - Status: Wandering
    

    若要停止追踪,请使用 /pt viewer remove。

    此外,BossBar 区域(屏幕顶部)将显示查看者与目标之间的相对方向和距离:

    • 水平方向:↑ ↗ → ↘ ↓ ↙ ← ↖(共 8 个)
    • 垂直方向:↑ ↓ Level(共 3 个)
    • 距离:两名玩家之间的直线距离

    ❗ 注意:一次只能追踪一个目标。添加新目标会替换之前的目标。

    ? 提示:查看器使用 ActionBar(玩家快捷栏上方的显示区域)。它可能会与其他同样使用 ActionBar 的插件发生冲突。


? 文件语法

⚙️ 配置文件 config.yml

? 首次启动时在 .\plugins\PlayerTracker 自动生成。

plugin:
  enabled: true   # 启用/禁用插件

log:
  enabled: true   # 启用/禁用日志记录
  schedule: 300   # 日志记录间隔(秒)

? 日志文件 player_activities.log

? 在写入第一条日志条目时,自动创建于 .\plugins\PlayerTracker。

  1. 示例日志条目

    [2025-06-23 23:25:08] [X_xiaohan521] [world] [108 79 -90] [Joined Game]
    

    格式:[时间] [玩家] [世界] [坐标] [事件]

  2. 日志触发条件(启用日志记录时)

    a. 定时日志记录

    ? 插件会按照 config.yml 中定义的间隔,记录所有在线玩家的状态。可能的状态包括:

    • 睡眠中
    • 载具上
    • 游泳
    • 滑翔
    • 疾跑
    • 潜行
    • 游荡

    b. 特定事件

    ? 以下事件会自动触发日志记录:

    • 玩家加入/离开游戏
    • 玩家死亡
    • 飞行模式切换
    • 进入/离开载具
    • 玩家受到伤害
    • 使用末影珍珠
    • 玩家攻击
    • 打开箱子

?️ 技术概览

插件结构

PlayerTracker/
├── pom.xml                      # 父级聚合 POM
│
├── playertracker-api/           # 对外暴露的 API
│   └── src/main/java/unimilk/playertracker/api/
│       ├── viewer/
│       │   ├── ITrackViewer.java
│       │   └── IBossBarManager.java
│       └── util/
│           └── IMessageSender.java
│
├── playertracker-common/        # 通用逻辑实现,不含版本依赖
│   └── src/main/java/unimilk/playertracker/
│       ├── PlayerTracker.java   # 插件主类
│       ├── command/
│       │   ├── CommandHandler.java
│       │   └── CommandTabCompleter.java
│       ├── log/
│       │   └── ActivityLogger.java
│       ├── util/
│       │   ├── DirectionDistanceCalc.java
│       │   └── EventListener.java
│       └── core/
│           └── VersionManager.java    # 动态加载不同版本的实现
│
├── playertracker-v1_13_15/      # 专为 1.13~1.15 版本实现的模块
│   └── src/main/java/unimilk/playertracker/impl/v1_13_15/
│       ├── viewer/
│       │   ├── TrackViewerImpl.java
│       │   └── BossBarManagerImpl.java
│       └── util/
│           └── MessageSenderImpl.java
│
├── playertracker-v1_16_21/      # 适用于 1.16~1.21 版本的通用实现
│   └── src/main/java/unimilk/playertracker/impl/v1_16_21/
│       ├── viewer/
│       │   ├── TrackViewerImpl.java
│       │   └── BossBarManagerImpl.java
│       └── util/
│           └── MessageSenderImpl.java
│
└── playertracker-assembly/       # 最终打包模块
    └── src/main/resources/plugin.yml

数据结构

  时间
  名称
  位置
  ├── 世界
  └── 坐标
  活动
  ├── 状态
  └── 事件

  方向
  距离

❓ 常见问题

  • Q: 玩家退出后,追踪视图会保留吗?

    A: 如果是创建该视图的玩家退出,视图将被清除,重新加入后需要重新添加。但如果被追踪的目标退出,当目标重新加入时,视图将自动恢复。

  • Q: 日志文件会自动定期清理吗?

    A: 目前不会。您需要手动清理。自动清理功能计划在未来的版本中推出。

  • Q: 追踪视图多久刷新一次?

    A: 仅在追踪者或被追踪者移动时更新。

  • Q: 会支持其他游戏版本吗?

    A: 是的,计划支持更多版本。


? 更新日志

? 此处仅列出最新版本。旧版本请参阅 CHANGELOG.md。

[4.1.0] - 2025-11-12

? 改进

  • 新增对 Minecraft 1.13.x ~ 1.21.x 的兼容支持。
  • 重构插件结构以优化组织。
  • 新增英文 README.md。

?️ 修复

  • 修复了在 1.13.x~1.15.x 版本服务器上插件加载的问题。
  • 修复了在 1.13.x~1.15.x 版本服务器上执行 /pt track 命令时的错误。

? 贡献指南

想要帮助改进此插件?请通过 GitHub 提交 Issue 或 Pull Request。


? 许可证

本插件基于 Unlicense 发布。

任何人有权出于任何目的(无论是商业还是非商业),以任何方式复制、修改、发布、使用、编译、出售或分发本软件,无论是源代码形式还是编译后的二进制形式。


? 联系我

? 邮箱: unimilk891@gmail.com

? GitHub: X-xiaohan521


⭐ 结语

感谢您使用 PlayerTracker!

如果您觉得这个插件有帮助,请给仓库点个星 ⭐ 或留下您的反馈——您的支持对我意义重大! ?

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源