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!