A lightweight Spigot plugin for Minecraft 1.21.1+ that tracks per-player statistics:
| Metric | Description |
|---|---|
| ⏱ Online time | Total time spent on the server (hours, minutes, seconds) |
| ⚔️ Mobs killed | Number of mobs killed by the player |
| 🧱 Blocks placed | Number of blocks placed |
| ⛏ Blocks broken | Number of blocks broken |
Data is persisted to YAML files (plugins/PlayerStats/data/<uuid>.yml) and auto-saved on a configurable interval.
- Java 21+
- Spigot / Paper 1.21.1 or newer
- Maven 3.8+ (to build)
git clone https://github.com/Ivan3310/PlayerStats.git
cd PlayerStats
mvn clean package
# Jar is at: target/PlayerStats-1.0.0.jarCopy the jar to your server's plugins/ folder and restart.
| Command | Permission | Description |
|---|---|---|
/stats [player] | playerstats.stats | Show statistics (defaults to self) |
/statsreset <player> | playerstats.reset (op) | Reset a player's statistics |
/statstop <online|mobs|placed|broken> | playerstats.top | Show top-10 leaderboard |
Aliases for /stats: /playerstats, /ps
| Permission | Default | Description |
|---|---|---|
playerstats.stats | true | View statistics |
playerstats.reset | op | Reset statistics |
playerstats.top | true | View leaderboards |
playerstats.bypass | false | Stats are not tracked for this player |
config.yml:
auto-save-interval: 300# seconds between auto-savesprefix: '&8[&aPlayerStats&8] 'track-bypassed-players: falsetop-size: 10All player-facing strings are in messages.yml and support & colour codes.
src/main/java/dev/ivan3310/playerstats/
├── PlayerStatsPlugin.java # Main plugin class
├── PlayerData.java # Data model
├── Messages.java # Message helper
├── storage/
│ └── StatsStorage.java # YAML persistence + session tracking
├── listeners/
│ ├── PlayerListener.java # Join/quit → session start/end
│ ├── BlockListener.java # BlockPlace / BlockBreak
│ └── EntityListener.java # EntityDeath (mobs killed by player)
└── commands/
├── StatsCommand.java
├── StatsResetCommand.java
└── StatsTopCommand.java
MIT — see LICENSE.