📊 PlayerStats

PlayerStats is a lightweight plugin that automatically records important player activity on your server. It captures movement, interactions, combat, item usage, and more, giving you clear and reliable statistics while keeping the server lightweight. All data is stored locally in a SQLite database.

The plugin also imports existing player statistics on first use.
Note: Not all stats can be imported. Some stats may be missing and cannot be imported.

---

⭐ Features

• Walked, sprinted, and sneaked distances
• Imports all available player data, even from before the plugin was installed
• Jump counts
• Total blocks broken and placed
• Per-material breakdown for blocks broken and placed
• Item and block interaction frequencies
• Total playtime per player
• Death count and join count
• Entity kills per type
• Items crafted
• Items dropped
• Items picked up
• Efficient caching with asynchronous flushes to minimize server load
• Operator-only access to other players' stats, everyone can view their own
• Automatic SQLite setup in plugin data folder

---

🧾 Commands

• /playerstats
  Shows your personal summary
  (permission: playerstats.view.self default: true)

• /playerstats <player>
  Shows another player's summary (online or offline with stored data)
  (permission: playerstats.view.other default: op)

• /playerstats <player> <detail>
  Shows detailed stats for one category. Supported:
  movement, blocks_broken (blocks_destroyed), blocks_placed,
  interactions, combat, crafting (crafted), drops (dropped),
  pickups (picked_up, collected), playtime, totals
  (permission: playerstats.view.other when targeting someone else)

• /ps
  Alias for /playerstats

• /playerstats:help
  Shows the help page

• /pshelp
  Alias for help command

---

💾 Database

PlayerStats uses a local SQLite database (playerstats.db by default).

• Database setup is automatic in the plugin folder
• Tracks players by UUID, name changes handled automatically

---

📥 Installation

1. Download the latest release
2. Drop the jar into your Paper server's plugins folder
3. Start or restart the server