Statistics

Statistics is a game feature that allows players to track certain tasks in the form of numerical data.

Statistics are present only in. has no equivalent of statistics in-game, but a part of statistics can be viewed on the Xbox Console Companion app.

Statistics screen
In statistics screen, statistics are divided into three sections:
 * General – The General screen displays a multitude of generic statistics that are listed in the table below.
 * Items – The Items screen displays the number of times different items and blocks have been depleted, crafted, used to destroy blocks, picked up and dropped.
 * Mobs – The Mob screen shows for each different types of mobs how many the player has killed, or the number of deaths caused by those mobs.

The buttons at the top of the Blocks and Items screens can be used to sort the list.

Namespaced ID
The namespace IDs of statistics are very unique. They are the only combination namespaced IDs in the game.

The namespace IDs of statistics are in form of  as well, however, in which   is an namespaced ID of a statistic type in form of ,   is an namespaced ID of a statistic name in form of.

That means, the namespace IDs of statistics are in form of, in which:
 * is the namespace of statistic type.
 * is the name of statistic type.
 * is the namespace of statistic name.
 * is the name of statistic name.

For both two namespaces, it can be omitted if it is. For example, the following four IDs work the same:

Statistic types
Statistics are divided into some types. For general statistics, their type is called. For item statistics, their types are,  ,  ,  ,  , and. For mob statistics, their types are  and.

List of statistic names
{| class="wikitable" style="width:100%" data-description="Statistic names" ! Statistic type ! Description
 * minecraft:custom
 * Players' statistics increment automatically when they perform the action relevant to the statistic names.
 * Players' statistics increment automatically when they perform the action relevant to the statistic names.

A statistic name is an item from the list: Note that "damage_dealt" does not track damage caused by player projectiles.




 * minecraft:crafted
 * Its statistic name can be any block and item. Players' statistics increment by an amount equal to the number of items crafted, smelted, etc., upon removing a block or item from the output of a furnace, crafting table, etc.

A statistic name is an item from the list:




 * minecraft:used
 * Statistic names include ID of all blocks and items. Players' statistics increment when a player uses a block or item. "Use" is defined as when:
 * A shovel, a pickaxe, an axe, flint and steel, shears, a hoe, a bow, or a sword would normally consume durability
 * Score values do not increment when armor consumes durability.
 * Score values increment even if no durability is consumed, like when a torch is destroyed with an item that takes the key to use (e.g. pickaxes).
 * For fishing rods and carrots on sticks, score values increment when the key is used.
 * A block is placed
 * A painting, item frame, snowball, egg, spawn egg, any type of minecart or boat, eye of ender, ender pearl, bow, any type of throwable potion, Bottle o' Enchanting, or fishing rod spawns an entity
 * A cocoa pod is planted on a jungle log, or bone meal is used to grow plants like crops, grass, and saplings
 * A potion, bucket of milk, or any food (save cake) is consumed
 * An empty map, empty bucket, lava bucket, water bucket, milk bucket, book and quill, or potion turns into a new item
 * Score values do not increment when a bowl becomes mushroom stew or a bucket becomes milk.
 * A music disc is placed in a jukebox
 * Note that each record has a unique sub-criterion.

Players' statistics do not increment when items are used on mobs&mdash;whether to name, tame, feed, breed, saddle, leash, shear, dye, milk, or gather stew from&mdash;when armor is equipped directly with, when leather armor is washed in a cauldron, and all instances mentioned above.

A statistic name is an item from the list:




 * minecraft:broken
 * Statistic names include IDs of items with durability (e.g. "minecraft.broken:minecraft.bow"). Player scores increment when a player runs the durability of one of these items negative. Durability runs negative when the item's durability loss–condition is met and the item already has a durability of 0.

A statistic name is an item from the list:




 * minecraft:mined
 * Statistic names include ID of blocks (such as "minecraft.mined:minecraft.stone"). Most blocks are valid, except for various indestructible or technical blocks. Player scores increment when the player mines a block. To "mine" is defined as destroying a block in a way that could/would drop an item, unless the block doesn't drop an item like glass or ice mined with an unenchanted tool. The value still increases if the doTileDrops gamerule is false, and it never increases for a player in Creative Mode.

A statistic name is a block from the list:




 * minecraft:killed
 * Statistic names include entity types. Any entity type is valid, although many such as "egg" don't seem to do anything.

Statistic name is a valid type of entity.




 * minecraft:picked_up
 * Statistic names include ID of blocks and items (e.g. "minecraft.picked_up.minecraft.stone"). Player scores increment when the player picks up a dropped item.

A statistic name is a block or item.




 * minecraft:dropped
 * Statistic names include ID of blocks and items (e.g. "minecraft.dropped:minecraft.dirt"). Player scores increment when a player drops an item by using the key.

A statistic name is a block or item.



Note that if the name of a passive mob or non-damaging entity is named, like an armor stand, player scores never increase; exceptions are rabbits and chickens if they are the Killer Bunny or a chicken jockey.
 * minecraft:killed_by
 * Statistic names include types of entities. Any entity type is valid. Player scores increment when the player is killed by an entity of that type.

A statistic name is a valid entity type.
 * style="text-align:center" | 43
 * style="text-align:center" | 43


 * }

Storage
Statistics are stored in .minecraft/saves//stats/.json ( /stats/.json on servers). They keep track of these stats. The file structure is JSON based and takes the following format:
 * : The root tag.
 * : The data version of the game version the file was last saved in.
 * : The tag that stores the actual statistics.
 * : A compound that saves all statistics of this namespace. For general statistics, this tag is called . For item statistics, it can be called ,  ,  ,  ,   or  . For mob statistics, it can be called   or.
 * : The value of the statistic specified in this tag's name.

For example, if a player was only walked one block (statistic ) and broken an oak log (statistic  ), their stats file will be this: {  "stats": { "minecraft:mined": { "minecraft:oak_log": 1 },     "minecraft:custom": { "minecraft:walked_one_cm": 100 }  },   "DataVersion": 2230 }

Statistics are stored in the stats-change section. All of these fields are empty unless they need updating. For example, until the player jumps, the number of times jumped is not recorded. Distance is stored in centimeters (where one block equals 100 centimeters), and time is stored in ticks (where one tick equals 0.05 seconds).