SMPStats

SMPStats

Comprehensive Player Statistics & Analytics for Paper 1.21.10

What This Plugin Does

SMPStats is a powerful yet lightweight statistics tracking plugin designed specifically for Paper servers running Minecraft 1.21.10+. It automatically monitors and records detailed player activity across your SMP server, providing deep insights into player behavior, achievements, and server dynamics.

Social Statistics - Social Statistics: Playtime (sessions, pauses), join/leave timestamps, first and last seen dates - Social Statistics: Player kills, mob kills, damage dealt, damage taken, deaths with detailed death causes - Social Statistics: Blocks placed and broken (tracked by type), with support for heatmap generation - Social Statistics: Distance traveled (separated by dimension: Overworld, Nether, End), biomes visited - Social Statistics: Items crafted and consumed - Social Statistics: Automatic calculation of player skill levels across categories (Mining, Combat, Exploration, Builder, Farmer) based on configurable weights - Social Statistics: Captures memorable in-game events like "first death," "diamond mining runs," "clutch plays," "TNT fails," and more through a customizable event definition system - Social Statistics: Visual activity maps showing player deaths, mining hotspots, and other activity patterns - Social Statistics: Detailed snapshots of death events including location, cause, health, nearby entities, and inventory state - Social Statistics: Tracks proximity time between players and cooperative kills (planned feature)

Why Download This Plugin

Rich Data Export - Rich Data Export: Uses SQLite database—no external database setup needed - Rich Data Export: Lightweight design with async operations and configurable autosave intervals - Rich Data Export: Optional REST API with authentication for integrating stats into websites, Discord bots, or other tools - Rich Data Export: Configure which stats to track, skill weights, moment definitions, and more - Rich Data Export: JSON export capabilities for all statistics

Leaderboard Ready - Leaderboard Ready: View comprehensive statistics through in-game commands - Leaderboard Ready: See your skill profiles and understand your playstyle strengths - Leaderboard Ready: Automatic tracking of significant achievements and events - Leaderboard Ready: Compare yourself with other players across multiple metrics

Integration Ready - Integration Ready: Understand which players are most active and in what areas - Integration Ready: Perfect for recording SMP milestones, first achievements, and server history - Integration Ready: API enables creation of stat websites, Discord integrations, and community tools

Critical Information Before Downloading

Java Version - Java Version: Paper 1.21.10+ - Java Version: Java 21 or higher

Commands: - `/sstats` - View your own statistics - `/sstats user <player>` - View another player's statistics - `/sstats reload` - Reload the Plugin & the API - `/sstats user <player> <reset|set> [value]` - Reset or set stats of a player.

Optional HTTP API: The plugin can expose a REST API for external integrations. Configure in `config.yml`: - Enable/disable the API - Set custom port (default: 8765) - Configure API key for authentication

Endpoints: - `GET /stats/<uuid>` - Retrieve individual player statistics - `GET /stats/all` - List all tracked players - `GET /online` - List currently online players

Data Storage: - All data stored locally in `plugins/SMPStats/stats.db` (SQLite) - Configurable autosave intervals - No external database required

Customization: The `config.yml` file allows you to: - Enable/disable specific tracking modules (movement, blocks, kills, biomes) - Configure skill profile weights to match your server's focus - Define custom "moments" to capture specific events (e.g., "Diamond finds within 30 seconds") - Set up heatmap parameters and hotspot regions - Configure autosave intervals and API settings

Performance Notes: - Async database operations prevent server lag - Configurable tracking granularity to balance detail vs. performance - Automatic data flushing at configurable intervals

This plugin is ideal for SMP servers that want detailed analytics, player engagement tracking, and the ability to showcase player achievements and statistics both in-game and through external platforms.