Player Statistics Utils

Player Statistics

A Minecraft 1.20.6 Fabric mod that tracks per-player statistics and provides a
lightweight in-game economy. All persistence is delegated to the
Custom Player Data framework.

Requirements

The custom-player-data-1.0.3 mod must be installed.

Currently available features

Tracking

• First join — recorded once on the player’s very first connection.
• Last join — refreshed on every connection.
• Play time — accumulated in seconds. The session start time is held in memory and added to the persisted total on disconnect (or on SERVER_STOPPING as a safety net). /playerinfo and /leaderboard play_time add the in-progress session to the displayed value so the number is always current.

Commands

| Command | Permission | Description |
|——————|:———-:|————————————————————–|
| /playerinfo | everyone | Show your own statistics. Play time is formatted as X jours, Y heures, Z min. |
| /playerinfo <player> | op (lvl 2) | Show another player’s statistics. |
| /leaderboard <stat> | everyone | Top 10 leaderboard. Built from currently connected players (the framework does not expose offline data). |

Connection counter — join_count

• Increments join_count on every successful login.
• Adds a line to /playerinfo.

Death tracking — death_count

• Listens to ServerLivingEntityEvents.AFTER_DEATH and increments death_count whenever a ServerPlayerEntity dies.
• Exposes a death_count leaderboard via /leaderboard death_count.
• Adds a line to /playerinfo.

Player kill tracking — player_kills

• Increments player_kills on the attacker when one player kills another. Self-kills are filtered out.
• Exposes a player_kills leaderboard via /leaderboard player_kills.
• Adds a line to /playerinfo.

Hostile mob kill tracking — mob_kills_hostile

• Increments mob_kills_hostile whenever a player kills an hostile entity.
• Exposes a mob_kills_hostile leaderboard via /leaderboard mob_kills_hostile.
• Adds a line to /playerinfo.

Passive mob kill tracking — mob_kills_passive

• Increments mob_kills_passive whenever a player kills an passive entity.
• Adds a “Mobs passifs tues” line to /playerinfo.

Economy — balance

The whole economy module is gated behind the BALANCE stat. Activating it
unlocks the following commands:

| Command | Permission | Description |
|————————————————–|:———-:|——————————————————————————|
| /balance | everyone | Show your own balance. |
| /balance <player> | op (lvl 2) | Show another player’s balance. |
| /pay <player> <amount> | everyone | Transfer money. Refused if the source balance is insufficient or the target is yourself. |
| /money <player> give <amount> | op (lvl 2) | Add money to a player’s balance. |
| /money <player> take <amount> | op (lvl 2) | Remove money — clamped at zero, never negative. |
| /money <player> set <amount> | op (lvl 2) | Set a player’s balance to a specific value. |

Activating balance also adds a styled “Solde” line to /playerinfo and a
balance entry to /leaderboard.

Language support

• English
• French

Installation

1. Install Fabric Loader for Minecraft 1.20.6: https://fabricmc.net/use/installer/
2. Download Fabric API for 1.20.6 and drop the .jar into your mods/ folder.
3. Drop player-statistics.jar into the same mods/ folder.
4. Launch the game!