# \ud83e\udded PlayerTracker Plugin (Capable for Spigot\/Paper 1.13.x ~ 1.21.x)<\/p>\n
\ud83d\ude80 **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**.<\/p>\n
## \ud83d\udccb Overview
\n\ud83d\udccc **Latest Version: `v4.1.0`**
\n\ud83d\udccc **Supported Minecraft Versions: `1.13.x ~ 1.21.x`**
\n\ud83d\udccc **Compatible Servers: `Spigot` `Paper`**<\/p>\n
—<\/p>\n
## \ud83d\udce5 Quick Start
\n### 1\ufe0f\u20e3 Download
\n\ud83d\udc49 Click here to download **PlayerTracker**.<\/p>\n
### 2\ufe0f\u20e3 Installation
\n1. Download the `.jar` file.
\n2. Put the `.jar` file in the `.plugins` folder of your Minecraft server.
\n3. Stop and restart your server.
\n4. Try `\/playertracker` or `\/pt` in game.<\/p>\n
—<\/p>\n
## \ud83d\udcdd How to Use
\n### \ud83d\udd39 Main Commands
\n> \ud83d\ude80 Both `\/playertracker` and `\/pt` work as valid command prefixes. For convenience, the examples below use `\/pt`.<\/p>\n
| Command | Description | Permission Required | > \u2757 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.<\/p>\n ### \ud83d\udd39 Feature Details To query a specific player, use `\/pt track **Players with `playertracker.admin` permission** or **server console** can toggle logging via `\/pt log on\/off`. Additionally, the **BossBar area** (on top of the screen) will show the relative direction and distance between the viewer and the target:<\/p>\n – Horizontal Direction: `\u2191` `\u2197` `\u2192` `\u2198` `\u2193` `\u2199` `\u2190` `\u2196` (8 total) > \u2757 Note: Only **one target** can be tracked at a time. Adding a new one replaces the previous target.<\/p>\n > \ud83d\udca1 Heads-up: The viewer **uses the `ActionBar`** (the display area above palyers’ hotbar). It may conflict with other plugins that also use the ActionBar.<\/p>\n —<\/p>\n ## \ud83d\udcc4 File Syntax log: ### \ud83e\uddfe Log File `player_activities.log` 2. #### Log Triggers (when logging is enabled) b. Specific Events —<\/p>\n ## \ud83d\udee0\ufe0f Technical Overview “` Direction —<\/p>\n ## \u2753 FAQ —<\/p>\n ## \ud83d\udcdc Changelog ### \ud83c\udf1f Improvements ### \ud83d\udee0 Bugfixes —<\/p>\n ## \ud83d\udca1 Contributing —<\/p>\n ## \ud83d\udcdc License —<\/p>\n ## \ud83d\udcde Contact Me —<\/p>\n ## \u2b50 Final Words PlayerTracker is an esay-to-use plugin for ops in Minecraft servers to get to know the coordinary and status of online players.<\/p>\n","protected":false},"featured_media":122877,"template":"","meta":{"_minecraft_slug":"playertracker-unimilk","_minecraft_project_id":"QJi6UrQm","_minecraft_author":"X-xiaohan521","_minecraft_license":"LicenseRef-Unlicense","_minecraft_downloads":72,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playertracker-unimilk.zip","_minecraft_size_bytes":49068,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:30:09.083970Z","_minecraft_date_created":"2025-10-11T06:10:48.717681Z","_minecraft_date_modified":"2025-11-12T13:46:54.527659Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playertracker-unimilk","_minecraft_icon_attachment_id":122877,"_minecraft_imported_at":"2026-06-07T05:26:43+00:00","_minecraft_import_hash":"4e6e533068fa56d61870ddbdc3be14fd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,126,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-122876","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—————–|———————–|———–|
\n| `\/pt track` | Display the coordinary and status of all players online. | `playertracker.use` |
\n| `\/pt track
\n| `\/pt log
\n| `\/pt log schedule
\n| `\/pt reload` | Reload the config file. | `playertracker.admin` |
\n| `\/pt viewer add\/remove
\n1. #### Basic Tracking `\/pt track`
\n 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:
\n “`log
\n ===== Online Players =====
\n X_xiaohan521 – World: world – Position: [108 77 -105] – Status: Wandering
\n Go_Karoo – World: world – Position: [247 62 -335] – Status: On Vehicle
\n “`
\n > \ud83d\ude80 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.)<\/p>\n
\n2. #### Logging
\n When logging is enabled, player activities are automatically logged at `.pluginsPlayerTrackerplayer_activities.log`. Refer to [“File Syntax”](#file-syntax) for an explanation of the logging syntax.<\/p>\n
\n3. #### Live Tracker `\/pt viewer`
\n **Players with `playertracker.view` permission** can issue `\/pt viewer add
\n “`log
\n Tracking: X_xiaohan521 – World: world – Position: [96 72 34] – Status: Wandering
\n “`
\n To stop tracking, use `\/pt viewer remove`.<\/p>\n
\n – Vertical Direction: `\u2191` `\u2193` `Level` (3 total)
\n – Distance: the straight-line distance between both players<\/p>\n
\n### \u2699\ufe0f Configuration File `config.yml`
\n> \ud83d\udccc Automatically generated at `.pluginsPlayerTracker` on first launch.
\n“`yml
\nplugin:
\n enabled: true # Enable\/Disable the plugin<\/p>\n
\n enabled: true # Enable\/Disable logging
\n schedule: 300 # Logging interval (seconds)
\n“`<\/p>\n
\n> \ud83d\udccc Automatically created at `.pluginsPlayerTracker` when the first log entry is written.
\n1. #### Sample Log Entry
\n “`log
\n [2025-06-23 23:25:08] [X_xiaohan521] [world] [108 79 -90] [Joined Game]
\n “`
\n Format: `[Time]` `[Player]` `[World]` `[Coordinates]` `[Event]`<\/p>\n
\n a. Scheduled Logging
\n > \ud83d\udccc The plugin records all online players’ status at intervals defined in `config.yml`. Possible status include:
\n – Sleeping
\n – On Vehicle
\n – Swimming
\n – Gliding
\n – Sprinting
\n – Sneaking
\n – Wandering<\/p>\n
\n > \ud83d\udccc The following events automatically trigger logging:
\n – Player join\/quit
\n – Player death
\n – Flight toggle
\n – Vehicle enter\/exit
\n – Player damage
\n – Ender pearl usage
\n – Player attack
\n – Chet opening<\/p>\n
\n### Plugin Structure
\n“`less
\nPlayerTracker\/
\n\u251c\u2500\u2500 pom.xml # Parent aggregation POM
\n\u2502
\n\u251c\u2500\u2500 playertracker-api\/ # Externally exposed API
\n\u2502 \u2514\u2500\u2500 src\/main\/java\/unimilk\/playertracker\/api\/
\n\u2502 \u251c\u2500\u2500 viewer\/
\n\u2502 \u2502 \u251c\u2500\u2500 ITrackViewer.java
\n\u2502 \u2502 \u2514\u2500\u2500 IBossBarManager.java
\n\u2502 \u2514\u2500\u2500 util\/
\n\u2502 \u2514\u2500\u2500 IMessageSender.java
\n\u2502
\n\u251c\u2500\u2500 playertracker-common\/ # Common logic implementation, excluding version dependencies
\n\u2502 \u2514\u2500\u2500 src\/main\/java\/unimilk\/playertracker\/
\n\u2502 \u251c\u2500\u2500 PlayerTracker.java # Plugin Main Class
\n\u2502 \u251c\u2500\u2500 command\/
\n\u2502 \u2502 \u251c\u2500\u2500 CommandHandler.java
\n\u2502 \u2502 \u2514\u2500\u2500 CommandTabCompleter.java
\n\u2502 \u251c\u2500\u2500 log\/
\n\u2502 \u2502 \u2514\u2500\u2500 ActivityLogger.java
\n\u2502 \u251c\u2500\u2500 util\/
\n\u2502 \u2502 \u251c\u2500\u2500 DirectionDistanceCalc.java
\n\u2502 \u2502 \u2514\u2500\u2500 EventListener.java
\n\u2502 \u2514\u2500\u2500 core\/
\n\u2502 \u2514\u2500\u2500 VersionManager.java # Dynamically load different version implementations
\n\u2502
\n\u251c\u2500\u2500 playertracker-v1_13_15\/ # Implementation dedicated to versions 1.13~1.15
\n\u2502 \u2514\u2500\u2500 src\/main\/java\/unimilk\/playertracker\/impl\/v1_13_15\/
\n\u2502 \u251c\u2500\u2500 viewer\/
\n\u2502 \u2502 \u251c\u2500\u2500 TrackViewerImpl.java
\n\u2502 \u2502 \u2514\u2500\u2500 BossBarManagerImpl.java
\n\u2502 \u2514\u2500\u2500 util\/
\n\u2502 \u2514\u2500\u2500 MessageSenderImpl.java
\n\u2502
\n\u251c\u2500\u2500 playertracker-v1_16_21\/ # Universal implementation for 1.16~1.21
\n\u2502 \u2514\u2500\u2500 src\/main\/java\/unimilk\/playertracker\/impl\/v1_16_21\/
\n\u2502 \u251c\u2500\u2500 viewer\/
\n\u2502 \u2502 \u251c\u2500\u2500 TrackViewerImpl.java
\n\u2502 \u2502 \u2514\u2500\u2500 BossBarManagerImpl.java
\n\u2502 \u2514\u2500\u2500 util\/
\n\u2502 \u2514\u2500\u2500 MessageSenderImpl.java
\n\u2502
\n\u2514\u2500\u2500 playertracker-assembly\/ # Final packaging module
\n \u2514\u2500\u2500 src\/main\/resources\/plugin.yml<\/p>\n
\n### Data Structure
\n“`text
\n Time
\n Name
\n Location
\n \u251c\u2500\u2500 world
\n \u2514\u2500\u2500coordinary
\n Activity
\n \u251c\u2500\u2500status
\n \u2514\u2500\u2500event<\/p>\n
\n Distance
\n“`<\/p>\n
\n– ### Q: Will the viewer be kept after a player quit?
\n #### 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.
\n– ### Q: Does the log file clean itself regularly?
\n #### A: Not yet. You need to clear it manually. Auto-clean is planned for future versions.
\n– ### Q: How often does the viewer refresh?
\n #### A: It updates only when either the tracker or target moves.
\n– ### Q: Will other game versions be supported?
\n #### A: Yes, support for more versions is planned.<\/p>\n
\n> \ud83d\udccc Only the latest version is listed here. See `CHANGELOG.md` for older versions.
\n### [4.1.0] – 2025-11-12<\/p>\n
\n– Added compatibility for Minecraft `1.13.x ~ 1.21.x`.
\n– Reconstruct plugin structure for better organization.
\n– Added English `README.md`.<\/p>\n
\n– Fixed plugin loading issues on servers of `1.13.x~1.15.x`.
\n– Fixed bugs when issuing `\/pt track` on servers of `1.13.x~1.15.x`.<\/p>\n
\n### Want to help improve this plugin? Submit an **Issue** or **Pull Request** via GitHub.
\n– \ud83d\udc1b Report issues: \ud83d\udd17 GitHub Issues
\n– \ud83d\udca1 Suggest new features: \ud83d\udd17 GitHub Issues
\n– \ud83d\udcac Join discussions: \ud83d\udd17 Github discussions
\n– \ud83e\udde9 Contribute code: Fork and submit a \ud83d\udd17 Pull Request<\/p>\n
\n### This plugin is released under the **Unlicense**.
\nAnyone is free to copy, modify, publish, use, compile, sell, or
\ndistribute this software, either in source code form or as a compiled
\nbinary, for any purpose, commercial or non-commercial, and by any
\nmeans.<\/p>\n
\n### \ud83d\udce7 Email: unimilk891@gmail.com
\n### \ud83c\udf10 GitHub: X-xiaohan521<\/p>\n
\n### Thank you for using **PlayerTracker**!
\nIf you find this plugin helpful, please star \u2b50 ths repository or leave your feedback \u2014 your support means a lot to me! \ud83d\ude80<\/p>\n","protected":false},"excerpt":{"rendered":"