? 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️⃣ 安装
- 下载
.jar 文件。
- 将
.jar 文件放入 Minecraft 服务器的 .\plugins 文件夹中。
- 停止并重启服务器。
- 在游戏中尝试使用
/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" 更 精确的权限控制。
? 功能详情
-
基础追踪 /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>。
-
日志记录
当启用日志记录时,玩家活动将自动记录在 .\plugins\PlayerTracker\player_activities.log 中。有关日志语法的解释,请参阅 "文件语法"。
拥有 playertracker.admin 权限的玩家或服务器控制台可以通过 /pt log on/off 切换日志记录功能。
-
实时追踪器 /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。
-
示例日志条目
[2025-06-23 23:25:08] [X_xiaohan521] [world] [108 79 -90] [Joined Game]
格式:[时间] [玩家] [世界] [坐标] [事件]
-
日志触发条件(启用日志记录时)
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 发布。
任何人有权出于任何目的(无论是商业还是非商业),以任何方式复制、修改、发布、使用、编译、出售或分发本软件,无论是源代码形式还是编译后的二进制形式。
? 联系我
⭐ 结语
感谢您使用 PlayerTracker!
如果您觉得这个插件有帮助,请给仓库点个星 ⭐ 或留下您的反馈——您的支持对我意义重大! ?
? PlayerTracker Plugin (Capable for Spigot/Paper 1.13.x ~ 1.21.x)
? PlayerTracker is a lightweight Minecraft 1.13.x ~ 1.21.x server plugin that allows administrators to track the coordinates and status of online players.
? Overview
? Latest Version: v4.1.0
? Supported Minecraft Versions: 1.13.x ~ 1.21.x
? Compatible Servers: Spigot Paper
? Quick Start
1️⃣ Download
? Click here to download PlayerTracker.
2️⃣ Installation
- Download the
.jar file.
- Put the
.jar file in the .\plugins folder of your Minecraft server.
- Stop and restart your server.
- Try
/playertracker or /pt in game.
? How to Use
? Main Commands
? Both /playertracker and /pt work as valid command prefixes. For convenience, the examples below use /pt.
| Command |
Description |
Permission Required |
/pt track |
Display the coordinary and status of all players online. |
playertracker.use |
/pt track <player> |
Display the coordinary and status of the player specified. |
playertracker.use |
/pt log <on/off> |
Enable/Disable logging. |
playertracker.admin |
/pt log schedule <int> |
Set logging interval to [int] second. Default: 300 |
playertracker.admin |
/pt reload |
Reload the config file. |
playertracker.admin |
/pt viewer add/remove <player> |
Add/Remove the tracker pointed to the player specified. |
playertracker.view |
❗ It is highly recommended to use PlayerTracker with a permission control plugin (such as LuckPerms, click here for more information) for a more precise permission control than the "OP" by default in Minecraft.
? Feature Details
-
Basic Tracking /pt track
When a players with playertracker.use permission or server console issue /pt track command, it displays all online players' coordinates and status in chat, for example:
===== Online Players =====
X_xiaohan521 - World: world - Position: [108 77 -105] - Status: Wandering
Go_Karoo - World: world - Position: [247 62 -335] - Status: On Vehicle
? Players in game can click the coordinates in chat to copy to clipboard. (Note that Minecraft versions 1.13.x ~ 1.15.x don't support this feature.)
To query a specific player, use /pt track <player>.
-
Logging
When logging is enabled, player activities are automatically logged at .\plugins\PlayerTracker\player_activities.log. Refer to "File Syntax" for an explanation of the logging syntax.
Players with playertracker.admin permission or server console can toggle logging via /pt log on/off.
-
Live Tracker /pt viewer
Players with playertracker.view permission can issue /pt viewer add <player> in game to display real-time tracking info on-screen, for example:
Tracking: X_xiaohan521 - World: world - Position: [96 72 34] - Status: Wandering
To stop tracking, use /pt viewer remove.
Additionally, the BossBar area (on top of the screen) will show the relative direction and distance between the viewer and the target:
- Horizontal Direction:
↑ ↗ → ↘ ↓ ↙ ← ↖ (8 total)
- Vertical Direction:
↑ ↓ Level (3 total)
- Distance: the straight-line distance between both players
❗ Note: Only one target can be tracked at a time. Adding a new one replaces the previous target.
? Heads-up: The viewer uses the ActionBar (the display area above palyers' hotbar). It may conflict with other plugins that also use the ActionBar.
? File Syntax
⚙️ Configuration File config.yml
? Automatically generated at .\plugins\PlayerTracker on first launch.
plugin:
enabled: true # Enable/Disable the plugin
log:
enabled: true # Enable/Disable logging
schedule: 300 # Logging interval (seconds)
? Log File player_activities.log
? Automatically created at .\plugins\PlayerTracker when the first log entry is written.
-
Sample Log Entry
[2025-06-23 23:25:08] [X_xiaohan521] [world] [108 79 -90] [Joined Game]
Format: [Time] [Player] [World] [Coordinates] [Event]
-
Log Triggers (when logging is enabled)
a. Scheduled Logging
? The plugin records all online players' status at intervals defined in config.yml. Possible status include:
- Sleeping
- On Vehicle
- Swimming
- Gliding
- Sprinting
- Sneaking
- Wandering
b. Specific Events
? The following events automatically trigger logging:
- Player join/quit
- Player death
- Flight toggle
- Vehicle enter/exit
- Player damage
- Ender pearl usage
- Player attack
- Chet opening
?️ Technical Overview
Plugin Structure
PlayerTracker/
├── pom.xml # Parent aggregation POM
│
├── playertracker-api/ # Externally exposed API
│ └── src/main/java/unimilk/playertracker/api/
│ ├── viewer/
│ │ ├── ITrackViewer.java
│ │ └── IBossBarManager.java
│ └── util/
│ └── IMessageSender.java
│
├── playertracker-common/ # Common logic implementation, excluding version dependencies
│ └── src/main/java/unimilk/playertracker/
│ ├── PlayerTracker.java # Plugin Main Class
│ ├── command/
│ │ ├── CommandHandler.java
│ │ └── CommandTabCompleter.java
│ ├── log/
│ │ └── ActivityLogger.java
│ ├── util/
│ │ ├── DirectionDistanceCalc.java
│ │ └── EventListener.java
│ └── core/
│ └── VersionManager.java # Dynamically load different version implementations
│
├── playertracker-v1_13_15/ # Implementation dedicated to versions 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/ # Universal implementation for 1.16~1.21
│ └── src/main/java/unimilk/playertracker/impl/v1_16_21/
│ ├── viewer/
│ │ ├── TrackViewerImpl.java
│ │ └── BossBarManagerImpl.java
│ └── util/
│ └── MessageSenderImpl.java
│
└── playertracker-assembly/ # Final packaging module
└── src/main/resources/plugin.yml
Data Structure
Time
Name
Location
├── world
└──coordinary
Activity
├──status
└──event
Direction
Distance
❓ FAQ
-
Q: Will the viewer be kept after a player quit?
A: If it is the player who created the viewer quit, the viewer won't be kept, and you would have to re-add the viewer after rejoin. But if it is the target quit, the viewer will be reactivated once the target rejoin.
-
Q: Does the log file clean itself regularly?
A: Not yet. You need to clear it manually. Auto-clean is planned for future versions.
-
Q: How often does the viewer refresh?
A: It updates only when either the tracker or target moves.
-
Q: Will other game versions be supported?
A: Yes, support for more versions is planned.
? Changelog
? Only the latest version is listed here. See CHANGELOG.md for older versions.
[4.1.0] - 2025-11-12
? Improvements
- Added compatibility for Minecraft
1.13.x ~ 1.21.x.
- Reconstruct plugin structure for better organization.
- Added English
README.md.
? Bugfixes
- Fixed plugin loading issues on servers of
1.13.x~1.15.x.
- Fixed bugs when issuing
/pt track on servers of 1.13.x~1.15.x.
? Contributing
Want to help improve this plugin? Submit an Issue or Pull Request via GitHub.
? License
This plugin is released under the Unlicense.
Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.
? Contact Me
⭐ Final Words
Thank you for using PlayerTracker!
If you find this plugin helpful, please star ⭐ ths repository or leave your feedback — your support means a lot to me! ?
评论 0
登录后参与评分
还没有评论,来抢沙发吧