# Statistics

**This feature is exclusive to**

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

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

## Contents

## Statistics screen[edit]

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 type 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. The General screen is sorted alphabetically.

## Namespaced ID[edit]

The namespaced IDs of statistics are unique. They are the only combination namespaced IDs in the game.

The namespaced IDs of statistics are in form of `NAMESPACE:NAME`

as well, however, in which `NAMESPACE`

is a namespaced ID of a statistic type in form of `namespace.name`

, `NAME`

is a namespaced ID of a statistic name in form of `namespace.name`

.

That means, the namespaced IDs of statistics are in form of `A.B:C.D`

, in which:

`A`

is the namespace of statistic type.`B`

is the name of statistic type.`C`

is the namespace of statistic name.`D`

is the name of statistic name.

For both two namespaces, it can be omitted if it is `minecraft`

. For example, the following four IDs work the same:

`minecraft.mined:minecraft.stone`

`mined:minecraft.stone`

`minecraft.mined:stone`

`mined:stone`

### Statistic types and names[edit]

Statistics are divided into some types. For general statistics, their type is called `minecraft:custom`

. For item statistics, their types are `minecraft:mined`

, `minecraft:broken`

, `minecraft:crafted`

, `minecraft:used`

, `minecraft:picked_up`

, and `minecraft:dropped`

. For mob statistics, their types are `minecraft:killed`

and `minecraft:killed_by`

.

Statistic type | Description | Namespaced ID |
---|---|---|

CUSTOM |
A multitude of generic statistics related to a player's actions. Players' statistics increase automatically when they perform the action relevant to the statistic names. The statistic name for CUSTOM is used to specify the action for statistics. See #List of custom statistic names below. |
minecraft:custom |

BLOCK_MINED |
Statistic related to the number of blocks a player mined. Players' statistic increases when the player mines a block of the specified type. It never increases for a player in Creative Mode. The statistic name for BLOCK_MINED is used to specify the type of blocks. It can be a namespaced ID of any block. |
minecraft:mined |

ITEM_BROKEN |
Statistics related to the number of items a player ran their durability negative. Players' statistic increases when a player runs the durability of one item of the specified type negative. Durability runs negative when the item's durability loss–condition is met and the item already has a durability of 0. The statistic name for ITEM_BROKEN is used to specify the type of items. It can be a namespaced ID of any item or block for which items exist. |
minecraft:broken |

ITEM_CRAFTED |
Statistics related to the number of items crafted, smelted, etc. Players' statistic increases by an amount equal to the number of items crafted or smelted, upon removing a block or item from the output of a furnace, crafting table, or the 2x2 inventory crafting grid. The statistic name for ITEM_CRAFTED is used to specify the type of items. It can be a namespaced ID of any item or block for which items exist. |
minecraft:crafted |

ITEM_USED |
Statistics related to the number of block or item used. Players' statistic increases 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
- For fishing rods and carrots on sticks, the use 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
- Players' statistics do not increase when a bowl becomes mushroom stew or a bucket becomes milk.
- A music disc is placed in a jukebox
Players' statistics do not increase when items are used on mobs—whether to name, tame, feed, breed, saddle, leash, shear, dye, milk, or gather stew from—when armor is equipped directly with use, when leather armor is washed in a cauldron, and instances mentioned above. The statistic name for ITEM_USED is used to specify the type of items. It can be a namespaced ID of any item or block for which items exist. |
minecraft:used |

ITEM_PICKED_UP |
Statistics related to the number of dropped items a player picked up. Players' statistic increases when the player picks up a dropped item of the specified type. The statistic name for ITEM_PICKED_UP is used to specify the type of items. It can be a namespaced ID of any item or block for which items exist. |
minecraft:picked_up |

ITEM_DROPPED |
Statistics related to the number of items that droped. Players' statistic increases when a player drops an item of the specified type from inventory. The statistic name for ITEM_DROPPED is used to specify the type of items. It can be a namespaced ID of any item or block for which items exist. |
minecraft:dropped |

ENTITY_KILLED |
Statistics related to the number of entities a player killed. Players' statistic increases when a player kills an entity of the specified type. The statistic name for ENTITY_KILLED is used to specify the type of entities. It can be a namespaced ID of any entity. |
minecraft:killed |

ENTITY_KILLED_BY |
Statistics related to the times of a player being killed by entities. Players' statistic increases when the player is killed by an entity of the specified type. The statistic name for ENTITY_KILLED is used to specify the type of entities. It can be a namespaced ID of any entity. |
minecraft:killed_by |

### List of custom statistic names[edit]

Statistic name | Description | Namespaced ID |
---|---|---|

Animals Bred | The number of times the player bred two mobs. | minecraft:animals_bred |

Armor Pieces Cleaned | The number of dyed leather armors washed with a cauldron. | minecraft:clean_armor |

Banners Cleaned | The number of banner patterns washed with a cauldron. | minecraft:clean_banner |

Barrels Opened | The number of times the player has opened a Barrel. | minecraft:open_barrel |

Bells Rung | The number of times the player has rung a Bell. | minecraft:bell_ring |

Cake Slices Eaten | The number of cake slices eaten. | minecraft:eat_cake_slice |

Cauldrons Filled | The number of times the player filled cauldrons with water buckets. | minecraft:fill_cauldron |

Chests Opened | The number of times the player opened chests. | minecraft:open_chest |

Damage Absorbed | The amount of damage the player has absorbed in tenths of 1. | minecraft:damage_absorbed |

Damage Blocked By Shield | The amount of damage the player has blocked with a shield in tenths of 1. | minecraft:damage_blocked_by_shield |

Damage Dealt | The amount of damage the player has dealt in tenths 1. Includes only melee attacks. | minecraft:damage_dealt |

Damage Dealt (Absorbed) | The amount of damage the player has dealt that were absorbed, in tenths of 1. | minecraft:damage_dealt_absorbed |

Damage Dealt (Resisted) | The amount of damage the player has dealt that were resisted, in tenths of 1. | minecraft:damage_dealt_resisted |

Damage Resisted | The amount of damage the player has resisted in tenths of 1. | minecraft:damage_resisted |

Damage Taken | The amount of damage the player has taken in tenths of 1. | minecraft:damage_taken |

Dispensers Searched | The number of times interacted with dispensers. | minecraft:inspect_dispenser |

Distance by Boat | The total distance traveled by boats. | minecraft:boat_one_cm |

Distance by Elytra | The total distance traveled by elytra. | minecraft:aviate_one_cm |

Distance by Horse | The total distance traveled by horses. | minecraft:horse_one_cm |

Distance by Minecart | The total distance traveled by minecarts. | minecraft:minecart_one_cm |

Distance by Pig | The total distance traveled by pigs via saddles. | minecraft:pig_one_cm |

Distance by Strider | The total distance traveled by striders via saddles. | minecraft:strider_one_cm |

Distance Climbed | The total distance traveled up ladders or vines. | minecraft:climb_one_cm |

Distance Crouched | The total distance walked while sneaking. | minecraft:crouch_one_cm |

Distance Fallen | The total distance fallen, excluding jumping. If the player falls more than one block, the entire jump is counted. | minecraft:fall_one_cm |

Distance Flown | Distance traveled upwards and forwards at the same time, while more than one block above the ground. | minecraft:fly_one_cm |

Distance Sprinted | The total distance sprinted. | minecraft:sprint_one_cm |

Distance Swum | The total distance covered with sprint-swimming. | minecraft:swim_one_cm |

Distance Walked | The total distance walked. | minecraft:walk_one_cm |

Distance Walked on Water | The distance covered while bobbing up and down over water. | minecraft:walk_on_water_one_cm |

Distance Walked under Water | The total distance you have walked underwater. | minecraft:walk_under_water_one_cm |

Droppers Searched | The number of times interacted with droppers. | minecraft:inspect_dropper |

Ender Chests Opened | The number of times the player opened ender chests. | minecraft:open_enderchest |

Fish Caught | The number of fish caught. | minecraft:fish_caught |

Games Quit | The number of times "Save and quit to title" has been clicked. | minecraft:leave_game |

Hoppers Searched | The number of times interacted with hoppers. | minecraft:inspect_hopper |

Interactions with Beacon | The number of times interacted with beacons. | minecraft:interact_with_beacon |

Interactions with Blast Furnace | The number of times interacted with Blast Furnaces. | minecraft:interact_with_blast_furnace |

Interactions with Brewing Stand | The number of times interacted with brewing stands. | minecraft:interact_with_brewingstand |

Interactions with Campfire | The number of times interacted with Campfires. | minecraft:interact_with_campfire |

Interactions with Cartography Table | The number of times interacted with Cartography Tables. | minecraft:interact_with_cartography_table |

Interactions with Crafting Table | The number of times interacted with crafting tables. | minecraft:interact_with_crafting_table |

Interactions with Furnace | The number of times interacted with furnaces. | minecraft:interact_with_furnace |

Interactions with Lectern | The number of times interacted with Lecterns. | minecraft:interact_with_lectern |

Interactions with Loom | The number of times interacted with Looms. | minecraft:interact_with_loom |

Interactions with Smithing Table | The number of times interacted with Smithing Tables. | minecraft:interact_with_smithing_table |

Interactions with Smoker | The number of times interacted with Smokers. | minecraft:interact_with_smoker |

Interactions with Stonecutter | The number of times interacted with Stonecutters. | minecraft:interact_with_stonecutter |

Items Dropped | The number of items dropped. This does not include items dropped upon death. | minecraft:drop |

Items Enchanted | The number of items enchanted. | minecraft:enchant_item |

Jumps | The total number of jumps performed. | minecraft:jump |

Mob Kills | The number of mobs the player killed. | minecraft:mob_kills |

Music Discs Played | The number of music discs played on a jukebox. | minecraft:play_record |

Note Blocks played | The number of note blocks hit. | minecraft:play_noteblock |

Note Blocks tuned | The number of times interacted with note blocks. | minecraft:tune_noteblock |

Number of Deaths | The number of times the player died. | minecraft:deaths |

Plants Potted | The number of plants potted onto flower pots. | minecraft:pot_flower |

Player Kills | The number of players the player killed (on PvP servers). Indirect kills do not count. | minecraft:player_kills |

Raids Triggered | The number of times the player has triggered a Raid. | minecraft:raid_trigger |

Raids Won | The number of times the player has won a Raid. | minecraft:raid_win |

Shulker Boxes Cleaned | The number of times the player has washed a Shulker Box with a cauldron. | minecraft:clean_shulker_box |

Shulker Boxes Opened | The number of times the player has opened a Shulker Box. | minecraft:open_shulker_box |

Since Last Death | The time since the player's last death. | minecraft:time_since_death |

Since Last Rest | The time since the player's last rest. This is used to spawn phantoms. | minecraft:time_since_rest |

Sneak Time | The time the player has held down the sneak button. | minecraft:sneak_time |

Talked to Villagers | The number of times interacted with villagers (opened the trading GUI). | minecraft:talked_to_villager |

Targets Hit | The number of times the player has shot a target block. | minecraft:target_hit |

Time Played | The total amount of time played. This is not necessarily displayed in minutes - it displays in seconds, minutes, hours or days whichever makes the most sense. If the game is paused this number ceases to increase. If "5.50 h" is displayed this means that you have played for 5 hours and 30 minutes (not 50 minutes). | minecraft:play_one_minute |

Times Slept in a Bed | The number of times the player has slept in a bed. | minecraft:sleep_in_bed |

Traded with Villagers | The number of times traded with villagers. | minecraft:traded_with_villager |

Trapped Chests Triggered | The number of times the player opened trapped chests. | minecraft:trigger_trapped_chest |

Water Taken from Cauldron | The number of times the player took water from cauldrons with glass bottles. | minecraft:use_cauldron |

## Storage[edit]

Statistics are stored in `.minecraft/saves/< world name>/stats/<uuid>.json` (

`<`on servers). They keep track of these stats. The file structure is JSON based and takes the following format:

*world name*>/stats/<*uuid*>.json- : The root tag.
- DataVersion: The data version of the game version the file was last saved in.
- stats: The tag that stores the actual statistics.
- <
*statisticType*>: A compound that saves all statistics of this type.- <
*statisticName*>: The value of the statistic specified in this tag's name.

- <

- <

For example, if a player walked only one block (statistic `minecraft.custom:minecraft.walked_one_cm`

) and broke an oak log (statistic `minecraft.mined:minecraft.oak_log`

), the player's stats would be:

{ "stats": { "minecraft:mined": { "minecraft:oak_log": 1 }, "minecraft:custom": { "minecraft:walked_one_cm": 100 } }, "DataVersion": 2580 }

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).

## History[edit]

Java Edition Beta | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|

March 18, 2011 | Notch talked about statistics (along with achievements) on his blog post:
| |||||||||||

1.5 | Added statistics. | |||||||||||

May 24, 2011 | Saving of stats online was considered for Beta 1.6, but was considered too error prone at that point. | |||||||||||

Java Edition | ||||||||||||

1.7.2 | 13w36a | Statistics are now stored per world instead of globally. | ||||||||||

Added Distance by Horse, Animals Bred, Junk Fished and Treasure Fished. | ||||||||||||

Removed Times Played, Worlds created, Saves loaded, and Multiplayer joins. | ||||||||||||

1.7.6 | pre1 | Statistics file names are now UUIDs instead of player names. The names of existing files are converted. | ||||||||||

1.8 | February 24, 2014 | Searge posts an image of Distance Crouched and Distance Sprinted. | ||||||||||

14w10a | Added Distance Crouched, Distance Sprinted and Since Last Death. | |||||||||||

14w30a | Added Talked to Villagers and Traded with Villagers. | |||||||||||

1.8.2 | pre1 | Added the following statistics: Cake Slices Eaten, Cauldrons Filled, Water Taken from Cauldron, Armor Pieces Cleaned, Banners Cleaned, Interactions with Brewing Stand, Interactions with Beacon, Droppers Searched, Hoppers Searched, Dispensers Searched, Noteblocks played, Noteblocks tuned, Plants potted, Trapped Chests Triggered, Ender Chests Opened, Items Enchanted, Records Played, Interactions with Furnace, Interactions with Crafting Table, and Chests Opened | ||||||||||

1.9 | 15w32a | Added Sneak Time. | ||||||||||

15w33a | Added statistics for items picked up and dropped. | |||||||||||

15w38a | Added Times Slept in a Bed. | |||||||||||

15w49a | Added Distance by Elytra. | |||||||||||

1.11.1 | 16w50a | Removed Junk Fished and Treasure Fished. | ||||||||||

1.13 | 17w47a | Changed statistic type and statistic name to be namespaced (snake case instead of camel case and `stat.<type>` replaced with `minecraft:<type>` to ultimately make the format A.B:C.D).
| ||||||||||

Removed Blocks section, merging it into the Items section. | ||||||||||||

The entity section has no statistics. | ||||||||||||

17w48a | Re-added entity statistics, now tracking all entities. | |||||||||||

18w07a | Added Time Since Rest statistic. | |||||||||||

1.13.1 | 18w32a | Added the following statistics: Damage Dealt (Absorbed), Damage Dealt (Resisted), Damage Blocked By Shield, Damage Absorbed, Damage Resisted, and Shulker Box Cleaned. | ||||||||||

1.14 | 18w50a | Added Barrels Opened statistic. | ||||||||||

19w02a | Added following statistics: Interactions with Blast Furnace, Interactions with Campfire, Interactions with Lectern, and Interactions with Smoker. | |||||||||||

Pre-Release 2 | Added following statistics: Bells Rung, Interactions with Cartography Table, Interactions with Loom, Interactions with Stonecutter, Raids Triggered, and Raids Won. | |||||||||||

1.16 | 20w09a | Added Targets Hit statistic. | ||||||||||

20w14a | Statistics are in alphabetical order now. | |||||||||||

20w19a | Added Distance by Strider statistic. | |||||||||||

Legacy Console Edition | ||||||||||||

? | Added a statistics section. | |||||||||||

Statistics can be compared to friends and global users on actions such as farming, traveling, and mining on each difficulty mode. | ||||||||||||

Unlike Java Edition statistics, they are counted across worlds. |

## Issues[edit]

Issues relating to "Statistics" are maintained on the bug tracker. Report issues there.

## Gallery[edit]

## References[edit]