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!