Record various gameplay stats on a Minecraft server to better track the activity of the players. This is logged to a MySQL database and can then be used for other purposes like finding sources of griefing, grant rewards for completing tasks, build player profiles, or anything of your choosing. Multiple servers on a network can share the same database.<\/p>\n
No visualisation tools are included, this is left up to the server owner.<\/p>\n
This plugin was developed out of a growing frustration from other plugins no longer getting updated, or giving inaccurate results.<\/p>\n
# Basic table format
\n`uuid`: The player’s unique ID
\n`amount`: The amount of times this task was completed
\n`world`: The name of the world the action took place in, automatically read from the server. <\/p>\n
Additional fields are added on the tables to record relevant data, while some others have a different format.<\/p>\n
For example, the more complex `stats_io_deaths`:
\n`source`: the source of the death (player or entity)
\n`target`: the target of the death (player or entity)
\n`world`: the world where the action took place
\n`cause`: the cause of the death (which weapon or item)
\n`weapon_name`: the weapon’s custom name, if set
\n`amount`: the amount of deaths matching all of the above
\n`player_source`: if the player was the cause of the death
\n`player_target`: if it was a player that died <\/p>\n
`stats_io_maxes` has a slightly different format: it will store the maximum value of various stats for each player.<\/p>\n
# Database tables and tracked values
\nAll table names are prefixed with `stats_io_` to avoid naming conflicts with other plugins.<\/p>\n
`arrows`
\n`beds_entered`
\n`blocks_broken`
\n`blocks_placed`
\n`buckets_emptied`
\n`buckets_filled`
\n`change_world`
\n`chat_words`
\n`commands`
\n`consumed`
\n`crafted`
\n`damage`
\n`deaths`
\n`eggs_thrown`
\n`enchants`
\n`enderpearls`
\n`fish_caught`
\n`heals`
\n`hunger_refills`
\n`inventories`
\n`item_broken`
\n`item_dropped`
\n`item_picked_up`
\n`joins`
\n`kicks`
\n`lighters`
\n`maxes`
\n`milk`
\n`move`
\n`pvp_streak`
\n`shears`
\n`splashes`
\n`tamings`
\n`teleports`
\n`trades`
\n`xp_gained` <\/p>\n
# Installation
\n1. Download the plugin and place it in your plugins\/ directory.
\n2. Start and stop the server to generate the configuration file.
\n3. Edit config.yml with your MySQL database information.
\n4. Start your server. After a minute, the MySQL table will start getting results.<\/p>\n
# Configuration
\n`database.host`: Database host
\n`database.port`: Database port
\n`database.base`: Database name
\n`database.username`: Database username
\n`database.password`: Database password <\/p>\n
# Commands
\n`givehead PLAYER`: Obtain the skull of the specified player<\/p>\n
# Permissions
\n`iobattlestats.track`: Add to any player or group to be logged
\n`iobattlestats.givehead`: Determine who is allowed to use the `\/givehead` command<\/p>\n
# Why is this plugin reliable?
\nI use all of my plugins on my own servers, and I like my plugins to be stable, reliable and low maintenance. Breaks on version upgrades are not expected, but should they happen, they will be quickly fixed.<\/p>\n
# Support my work
\nIf you enjoy my work, I welcome sponsors! I’ve been running Minecraft servers since 2011, developed several plugins and tools for server owners, and I’m now working my way through releasing many of them. Your support would go a long way toward encouraging me to put more time and effort into this, plus fix any issues that might be discovered over time!<\/p>\n
  <\/p>\n","protected":false},"excerpt":{"rendered":"
Track all kinds of player gameplay statistics, not only from battles!<\/p>\n","protected":false},"featured_media":86218,"template":"","meta":{"_minecraft_slug":"iobattlestats","_minecraft_project_id":"QU2Cl42H","_minecraft_author":"Doctacosa","_minecraft_license":"MIT","_minecraft_downloads":298,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"iobattlestats.zip","_minecraft_size_bytes":148251,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T11:45:33.737146Z","_minecraft_date_created":"2022-12-07T00:35:48.321492Z","_minecraft_date_modified":"2025-10-19T21:38:49.513782Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/iobattlestats","_minecraft_icon_attachment_id":86218,"_minecraft_imported_at":"2026-06-04T22:14:13+00:00","_minecraft_import_hash":"b482db1cbdacfcbb685e9387fde80a98","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129,92],"mod_loader":[132,134],"minecraft_version":[438,110,115,118,49,51,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-86217","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-14","minecraft_version-1-15","minecraft_version-1-16","minecraft_version-1-17","minecraft_version-1-18","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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