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 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 Items screen can be used to sort the list. The General and Mobs screens are sorted alphabetically.
== Resource location ==
The resource locations of statistics are unique. They are the only combination resource locations in the game.
The resource locations of statistics are in form of NAMESPACE:PATH as well, however, in which NAMESPACE is the resource location of a statistic type in form of namespace.path, NAME is the resource location of a statistic name in form of namespace.path.
That means, the resource locations of statistics are in form of A.B:C.D, in which:
* A is the namespace of statistic type.
* B is the path of statistic type.
* C is the namespace of statistic name.
* D is the path of statistic name.
For both two namespaces, it can be omitted if it is minecraft. For example, the following four locations work the same:
* minecraft.mined:minecraft.stone
* mined:minecraft.stone
* minecraft.mined:stone
* mined:stone
=== Statistic types and names ===
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	Resource location
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, only if they use a tool that would normally make the item drop (even if custom loot tables or the doTileDrops game rule being false result in no drops). 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 the resource location 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 the resource location 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 an interface, like a crafting table, a furnace, or a villager's output slot.
The statistic name for ITEM_CRAFTED is used to specify the type of items. It can be the resource location 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
*: Players' statistics do not increase when armor consumes durability. Instead, they increase when armor is equipped directly with . 
*: Players' statistics increase 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, 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
*: 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 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 the resource location 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 the resource location 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 the resource location 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 the resource location 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 the resource location of any entity.	minecraft:killed_by
=== List of custom statistic names ===
Statistic name 	Description 	Resource location
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 . 	minecraft:damage_absorbed
Damage Blocked By Shield 	The amount of damage the player has blocked with a shield in tenths of . 	minecraft:damage_blocked_by_shield
Damage Dealt 	The amount of damage the player has dealt in tenths of . Includes only melee attacks. 	minecraft:damage_dealt
Damage Dealt (Absorbed) 	The amount of damage the player has dealt that were absorbed, in tenths of . 	minecraft:damage_dealt_absorbed
Damage Dealt (Resisted) 	The amount of damage the player has dealt that were resisted, in tenths of . 	minecraft:damage_dealt_resisted
Damage Resisted 	The amount of damage the player has resisted in tenths of . 	minecraft:damage_resisted
Damage Taken 	The amount of damage the player has taken in tenths of . 	minecraft:damage_taken
Dispensers Searched 	The number of times interacted with dispensers. 	minecraft:inspect_dispenser
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 upward and forward 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
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
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 Anvil 	The number of times interacted with anvils. 	minecraft:interact_with_anvil
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 Grindstone 	The number of times interacted with Grindstones. 	minecraft:interact_with_grindstone
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. If a group of items are dropped together, eg a stack of 64, it only counts as 1. 	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
Sneak Time 	The time the player has held down the sneak button (tracked in ticks). 	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 (tracked in ticks). 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_time
Time Since Last Death 	The time since the player's last death (tracked in ticks). 	minecraft:time_since_death
Time Since Last Rest 	The time since the player's last rest (tracked in ticks). If this value is greater than 1.00 h, phantoms can spawn. 	minecraft:time_since_rest
Time with World Open 	The total amount of time the world was opened (tracked in ticks). Unlike Play Time, if the game is paused this number continues to increase, but it does not change visually while the statistics menu is open. 	minecraft:total_world_time
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 ==
Statistics are stored in .minecraft/saves/<world name>/stats/<uuid>.json (<world name>/stats/<uuid>.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 type.
**** : 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": 
 }
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 ==
== Issues ==
== Gallery ==
Statistics Items (pre-release).png|Statistics screen in the reveal video.
Statistics Items.png|The items statistics screen.
Statistics Mobs.png|The mobs statistics screen.
Statistics 1.jpg|The statistics screen after 20w14a.
Distance Crouched & Sprinted.png|The general statistics screen.
Picked Up & Dropped.png|First image of the items picked up and items dropped statistics.
== References ==
de:Statistiken
es:Estadísticas
fr:Statistiques
ja:統計
nl:Statistieken
pl:Statystyki
pt:Estatísticas
ru:Статистика
zh:统计信息