What is PlayerTracker?

PlayerTracker is a plugin for Paper 1.21.x+ servers that serves as an introduction to Hoglin. It collects various common player metrics and hooks into several plugins when possible to provide extra data. It is designed to be easy to install and use, with minimal configuration required to get started. It’s also open-sourced, providing examples of how to use the Hoglin SDK as a developer.

To get started with PlayerTracker, visit the installation guide. For a detailed rundown of features, see below:

Default Visualizations

todo.

All tracked events

player_join

Recorded when a player joins the server.

Parameter	Type	Description
playerUUID	UUID	The UUID of the player who joined
hostname	String	The hostname used by the player to connect to the server, eg “play.example.com”
ip	String	The IP address of the player
clientPlatform	String	The platform the player is using, eg “JAVA” or “BEDROCK”
clientVersion	String	The client version used by the player, eg “1.21.1”
clientBrand	String	The client brand used by the player, eg “Vanilla” or “Fabric”

A note on client platform

We hook into GeyserMC to determine if the player is on Bedrock. If GeyserMC is not installed, the clientPlatform parameter will just always be “JAVA”

A note on client version

The client version is determined by PacketEvents. ViaVersion will work fine, some other solutions may also work. Notably, due to Minecraft limitations, not all versions can be differentiated - eg: 1.21.7 and 1.21.8 will both be reported as “1.21.7”. This is because the Minecraft protocol version doesn’t change between some versions, so there’s no way to tell them apart. In practice, this doesn’t matter much, but it’s worth noting to prevent confusion. A full list of protocol versions can be found here.

player_leave

Recorded when a player leaves the server.

Parameter	Type	Description
playerUUID	UUID	The UUID of the player who left

player_count

Recorded when the player count changes (join, leave), tracks new player count.

Parameter	Type	Description
playerCount	Int	The new player count on the server

player_purchase

Recorded via /playertracker purchase ... console command. This can be set up to be executed by a webstore platform when a player makes a purchase, learn more in the configuration guide

Parameter	Type	Description
playerUUID	UUID	The UUID of the player who made the purchase
productName	String	The name of the product purchased
purchaseValue	Float	The value of the purchase, in the server’s currency

afk_start and afk_stop

Recorded when a player’s afk status changes through Essentials.

Parameter	Type	Description
playerUUID	UUID	The UUID of the player who changed afk status
cause	String	The cause for the afk status changing, eg: “COMMAND”, “MOVE”

A note on afk cause

This is provided by Essentials, the full list of causes can be found here in the AfkStatusChangeEvent.Cause enum.