# SMPStats
\n## Comprehensive Player Statistics & Analytics for Paper 1.21.10<\/p>\n
### **What This Plugin Does**<\/p>\n
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.<\/p>\n
**Core Tracking Features:**
\n– **Player Activity**: Playtime (sessions, pauses), join\/leave timestamps, first and last seen dates
\n– **Combat Statistics**: Player kills, mob kills, damage dealt, damage taken, deaths with detailed death causes
\n– **Building & Mining**: Blocks placed and broken (tracked by type), with support for heatmap generation
\n– **Movement & Exploration**: Distance traveled (separated by dimension: Overworld, Nether, End), biomes visited
\n– **Crafting & Consumption**: Items crafted and consumed
\n– **Skill Profiles**: Automatic calculation of player skill levels across categories (Mining, Combat, Exploration, Builder, Farmer) based on configurable weights
\n– **Moments System**: Captures memorable in-game events like “first death,” “diamond mining runs,” “clutch plays,” “TNT fails,” and more through a customizable event definition system
\n– **Heatmaps**: Visual activity maps showing player deaths, mining hotspots, and other activity patterns
\n– **Death Replay**: Detailed snapshots of death events including location, cause, health, nearby entities, and inventory state
\n– **Social Statistics**: Tracks proximity time between players and cooperative kills (planned feature)<\/p>\n
### **Why Download This Plugin**<\/p>\n
**For Server Owners:**
\n– **Zero Configuration Required**: Uses SQLite database\u2014no external database setup needed
\n– **Performance Optimized**: Lightweight design with async operations and configurable autosave intervals
\n– **HTTP API Included**: Optional REST API with authentication for integrating stats into websites, Discord bots, or other tools
\n– **Highly Customizable**: Configure which stats to track, skill weights, moment definitions, and more
\n– **Rich Data Export**: JSON export capabilities for all statistics<\/p>\n
**For Players:**
\n– **Detailed Personal Stats**: View comprehensive statistics through in-game commands
\n– **Skill Progression**: See your skill profiles and understand your playstyle strengths
\n– **Memorable Moments**: Automatic tracking of significant achievements and events
\n– **Leaderboard Ready**: Compare yourself with other players across multiple metrics<\/p>\n
**For Communities:**
\n– **Engagement Insights**: Understand which players are most active and in what areas
\n– **Event Tracking**: Perfect for recording SMP milestones, first achievements, and server history
\n– **Integration Ready**: API enables creation of stat websites, Discord integrations, and community tools<\/p>\n
### **Critical Information Before Downloading**<\/p>\n
**Requirements:**
\n– **Server Type**: Paper 1.21.10+
\n– **Java Version**: Java 21 or higher<\/p>\n
**Commands:** **Optional HTTP API:** **Endpoints:** **Data Storage:** **Customization:** **Performance Notes:** 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.<\/p>\n","protected":false},"excerpt":{"rendered":" SMPStats is a lightweight Paper 1.21.x plugin that tracks player stats in SQLite and provides in-game commands plus an optional authenticated JSON API.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"smpstats","_minecraft_project_id":"R40xCfnQ","_minecraft_author":"NurRobin","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":75,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"smpstats.zip","_minecraft_size_bytes":44007167,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T20:19:33.234827Z","_minecraft_date_created":"2025-12-02T04:31:28.936574Z","_minecraft_date_modified":"2025-11-28T17:13:42.066427Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/smpstats","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-08T15:08:23+00:00","_minecraft_import_hash":"631c9d159cb3cf3e8d9a26bd7cb2a56f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,123,92],"mod_loader":[132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-144413","mod","type-mod","status-publish","hentry","mod_category-management","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/sstats` – View your own statistics
\n– `\/sstats user
\n– `\/sstats reload` – Reload the Plugin & the API
\n– `\/sstats user
\nThe plugin can expose a REST API for external integrations. Configure in `config.yml`:
\n– Enable\/disable the API
\n– Set custom port (default: 8765)
\n– Configure API key for authentication<\/p>\n
\n– `GET \/stats\/
\n– `GET \/stats\/all` – List all tracked players
\n– `GET \/online` – List currently online players<\/p>\n
\n– All data stored locally in `plugins\/SMPStats\/stats.db` (SQLite)
\n– Configurable autosave intervals
\n– No external database required<\/p>\n
\nThe `config.yml` file allows you to:
\n– Enable\/disable specific tracking modules (movement, blocks, kills, biomes)
\n– Configure skill profile weights to match your server’s focus
\n– Define custom “moments” to capture specific events (e.g., “Diamond finds within 30 seconds”)
\n– Set up heatmap parameters and hotspot regions
\n– Configure autosave intervals and API settings<\/p>\n
\n– Async database operations prevent server lag
\n– Configurable tracking granularity to balance detail vs. performance
\n– Automatic data flushing at configurable intervals<\/p>\n