PlayersStats

PlayersStats

A lightweight player statistics plugin for Paper servers with MySQL/MariaDB support.

23 downloads 0 followers

PlayersStats

PlayersStats is a lightweight player statistics plugin for Paper Minecraft servers.

It automatically tracks player activity and stores statistics in a MySQL/MariaDB database, making it useful for websites, dashboards, leaderboards, player profiles, and other external services.

Tracked Statistics

PlayersStats can track:

  • Playtime
  • Distance travelled
  • Deaths
  • Player kills
  • Mob kills
  • Blocks broken
  • Blocks placed
  • Items crafted
  • Chat messages
  • Commands used
  • Damage dealt
  • Damage taken
  • Player connections and sessions
  • Online/offline status

Each statistic can be individually enabled or disabled in the configuration.

MySQL / MariaDB

Player statistics are stored directly in a MySQL/MariaDB database.

The database connection is configurable through:

plugins/PlayersStats/config.yml

You can configure:

  • Database host
  • Port
  • Database name
  • Username and password
  • SSL
  • Connection timeout
  • Socket timeout
  • Statistics table name
  • Sessions table name
  • Synchronization interval

PlayersStats keeps statistics in memory and periodically synchronizes them with the database to reduce unnecessary database queries.

Configuration

PlayersStats provides a simple YAML configuration file.

You can customize:

  • Tracking interval
  • Database synchronization frequency
  • Teleport detection distance
  • Individual statistics
  • Plugin messages
  • Debug logging

Requirements

  • Minecraft 1.21.11
  • Paper
  • Java 21
  • MySQL or MariaDB database

Installation

  1. Download PlayersStats.
  2. Place the .jar file inside your server's plugins folder.
  3. Start the server.
  4. Open plugins/PlayersStats/config.yml.
  5. Configure your MySQL/MariaDB connection.
  6. Restart the server.

PlayersStats will automatically initialize the required database tables.

Commands

Main command:

/playersstats

Alias:

/pstats

Administrative permission:

playersstats.admin

Privacy

PlayersStats does not send player statistics to an external service.

All collected data is stored only in the MySQL/MariaDB database configured by the server administrator.

Version Minecraft Loader Download

PlayersStats 1.0.1

1.0.1

1.21.11
paper
Download