View source for Minecraft:Telemetry

{{Missing information|Telemetry in Bedrock Edition}}
{{Cleanup}}
[[File:Telemetry Data Collection screen.png|thumb|The telemetry data collection screen.]]
'''Telemetry Data Collection''' (formerly called '''Snooper''') is a feature that allows [[Minecraft:Mojang Studios]] to collect [[Minecraft:w:telemetry_(software)|telemetry]] data on the [[Minecraft:player]], from either the [[Minecraft:client]] or the [[Minecraft:server]]. On the telemetry data collection screen, the player can view the collected data and choose between sending a required "minimal" amount of data or an extended "all". It also includes a link to the stored data files.

This feature was removed globally in [[Minecraft:Java Edition 18w21a|18w21a]] because of the European Union's General Data Protection Regulations (GDPR).<ref>{{bug|MC-130179#comment-455305}} "''This is Working as Intended due to GDPR.''"</ref> It was re-added in [[Minecraft:Java Edition 21w38a|21w38a]] to "improve players' experience",<ref>{{snap|21w38a|September 23, 2021}}</ref> and since then it is no longer possible to disable telemetry data collection completely without client [[Minecraft:mod]]ifications.

== Telemetry Data Collection ==
=== On World Load ===
{| class="wikitable"
!Tag
!Type
!Description
!Example
|-
|type
|string
|Whether the data relates to a world being loaded, a world being unloaded or the loading time of a world.
|"world_loaded", "world_unloaded" or "world_load_times"
|-
| value
|object
|Contains the data listed below.
| ---
|-
!Tag
!Type
!Description
!Example
|-
|user_id
|string
|Contains the current user's Xbox Live ID (XUID) on decimal form.
|"0123456789012345"
|-
|client_id
|string
|A client ID that does not change when the game is restarted.
|"AB00cDef11GhIJ22kLmn33OpQR44sTuv55WxYZ"
|-
|minecraft_session_id
|string
|A session ID (UUID) that changes when the game is restarted.
|"00112233-4455-6677-8899-aabbccddeeff"
|-
|game_version
|string
|The currently played Minecraft version.
|"1.19.3", "23w05a", etc.
|-
|operating_system
|string
|The operating system in use.
|"windows"
|-
|platform
|string
|Platform used.
|"Windows 10"
|-
|client_modded 
|boolean
|Whether or not the client is modded. 
|true or false
|-
|event_timestamp_utc
|string
|Time of data collection. 
|"2023-01-25T18:35:44.123456700Z"
|-
|opt_in
| boolean
| Whether the user has given consent to full telemetry data collection.
|true or false 
|-
|world_session_id
|string
|A world session ID (UUID) that changes for every world load.
|"00112233-4455-6677-8899-aabbccddeeff"
|-
|server_modded
|boolean
|Whether or not the server is modded.
|true or false
|-
|server_type
|string
|If the world loaded is a local world or a server.
|"local" or "server"
|-
|game_mode
|string
|What gamemode the player is in at the time of entering the world.
|"adventure", "creative", "spectator" or "survival"
|}

=== On World Unload ===
{| class="wikitable"
!Tag
!Type
!Description
!Example
|-
|type
|string
|Whether the data relates to a world being loaded, a world being unloaded or the loading time of a world.
|"world_loaded", "world_unloaded" or "world_load_times"
|-
|value
|object
|Contains the data listed below.
| ---
|-
!Tag
!Type
!Description
!Example
|-
|user_id
|string
|Contains the current user's Xbox Live ID (XUID) on decimal form.
|"0123456789012345"
|-
|client_id
|string
|A client ID that does not change when the game is restarted.
|"AB00cDef11GhIJ22kLmn33OpQR44sTuv55WxYZ"
|-
|minecraft_session_id
|string
|A session ID (UUID) that changes when the game is restarted.
|"00112233-4455-6677-8899-aabbccddeeff"
|-
|game_version
|string
|The currently played Minecraft version.
|"1.19.3", "23w05a", etc.
|-
|operating_system
|string
|The operating system in use.
|"windows"
|-
|platform
|string
|Platform used.
|"Windows 10"
|-
|client_modded
|boolean
|Whether or not the client is modded.
|true or false
|-
|event_timestamp_utc
|string
|Time of data collection.
|"2023-01-25T18:35:44.123456700Z"
|-
|opt_in
|boolean
|Whether the user has given consent to full telemetry data collection.
|true or false
|-
|world_session_id
|string
|A world session ID (UUID) that changes for every world load.
|"00112233-4455-6677-8899-aabbccddeeff"
|-
|server_modded
|boolean
|Whether or not the server is modded.
|true or false
|-
|server_type
|string
|If the world loaded is a local world or a server.
|"local" or "server"
|-
|seconds_since_load
|integer
|Seconds passed since the world was loaded.
|10, 5, 3, etc.
|-
|ticks_since_load
|integer
|Ticks passed since the world was loaded.
|60, 30, 15, etc.
|}

=== World Load Time ===
{| class="wikitable"
!Tag
!Type
!Description
!Example
|-
|type
|string
|Whether the data relates to a world being loaded, a world being unloaded or the loading time of a world.
|"world_loaded", "world_unloaded" or "world_load_times"
|-
|value
|object
|Contains the data listed below.
| ---
|-
!Tag
!Type
!Description
!Example
|-
|user_id
|string
|Contains the current user's Xbox Live ID (XUID) on decimal form.
|"0123456789012345"
|-
|client_id
|string
|A client ID that does not change when the game is restarted.
|"AB00cDef11GhIJ22kLmn33OpQR44sTuv55WxYZ"
|-
|minecraft_session_id
|string
|A session ID (UUID) that changes when the game is restarted.
|"00112233-4455-6677-8899-aabbccddeeff"
|-
|game_version
|string
|The currently played Minecraft version.
|"1.19.3", "23w05a", etc.
|-
|operating_system
|string
|The operating system in use.
|"windows"
|-
|platform
|string
|Platform used.
|"Windows 10"
|-
|client_modded
|boolean
|Whether or not the client is modded.
|true or false
|-
|event_timestamp_utc
|string
|Time of data collection.
|"2023-01-25T18:35:44.123456700Z"
|-
|opt_in
|boolean
|Whether the user has given consent to full telemetry data collection.
|true or false
|-
|world_session_id
|string
|A world session ID (UUID) that changes for every world load.
|"00112233-4455-6677-8899-aabbccddeeff"
|-
|server_modded
|boolean
|Whether or not the server is modded.
|true or false
|-
|server_type
|string
|If the world loaded is a local world or a server.
|"local" or "server"
|-
|world_load_time_ms
|integer
|Time it took to fully load the world
|8765, 5432, 4321, etc.
|-
|new_world
|boolean
|Whether or not the loaded world was a newly created world.
|true or false
|}

=== Advancement Made ===
{{empty section}}

=== Game Load Times ===
{{empty section}}

== Fields ==
=== Client Fields (C) ===
{| class="wikitable"
!Name
!Type
!Notes
|-
|client_brand
|String
|
|-
|cpu_cores
|integer
|
|-
|current_action
|String
|
|-
|display_frequency
|integer
|
|-
|display_type
|String
|`windowed` or `fullscreen`
|-
|endianness
|String
|`big` or `little` [[Minecraft:wikipedia:Endianness|endianness]]
|-
|fps
|integer
|
|-
|gl_max_texture_size
|integer
|
|-
|java_version
|String
|
|-
|jvm_arg[...]
|String
|Launch arguments
|-
|jvm_args
|integer
|Number of launch arguments
|-
|launched_version
|String
|
|-
|memory_free
|integer
|
|-
|memory_max
|integer
|
|-
|memory_total
|integer
|
|-
|opengl_vendor
|String
|
|-
|opengl_version
|String
|
|-
|os_architecture
|String
|
|-
|os_name
|String
|Does not include Linux distribution name in most cases.
|-
|os_version
|String
|
|-
|resource_packs
|integer
|
|-
|run_time
|integer
|
|-
|snooper_partner
|UUID
|
|-
|snooper_token
|UUID
|
|-
|version
|String
|
|-
|vsync_enabled
|boolean
|
|}

=== Server Fields (S)===
{{empty section}}

=== GL Caps ===
{{expand section}}
OpenGL keys for the client.

== History ==
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.3.1|dev=12w30a|Added Snooper Settings screen.}}|{{HistoryLine||1.7.4|dev=13w48a|Upgraded protocol to version 2.}}
|{{HistoryLine||1.11|dev=16w35a|Changed the Snooper Setting screen's name and description.}}
|{{HistoryLine||1.13|dev=18w21a|Snooper is now forced off. The menu is still visible, but the button is disabled.}}
|{{HistoryLine||1.14|dev=19w11a|Removed the Snooper Settings screen, but it is still configurable in options.txt.}}
|{{HistoryLine||1.18|dev=21w38a|Re-added Snooper, but without its UI.}}
|{{HistoryLine||1.19.3|dev=22w46a|Added Telemetry Data screen in the options.}}
|{{HistoryLine||1.20|dev=23w18a|Added new property: {{cd|launcher_name}}, sent with every event.|Added new property {{cd|realms_map_content}} to event {{cd|world_loaded}}.|Added new optional event {{cd|advancement_made}}.|Added new optional event {{cd|game_load_times}}.}}
|{{HistoryLine||1.20.2|dev=23w31a|Added a button to the Telemetry Data Collection Screen that links to the Microsoft Privacy Statement.}}
|{{HistoryLine|java upcoming}}
|{{HistoryLine||26.2|dev=snap 4|New required events: {{cd|graphics_capabilities}}.}}
|{{HistoryLine|||dev=snap 7|New opt-in events: {{cd|p2p_connection}}.}}
|{{HistoryLine|||dev=pre1|Added {{cd|server_session_id}} - a unique identifier shared by all players in a multiplayer session.
|Removed {{cd|p2p_connection}} and associated properties.}}
}}

== Gallery ==
<gallery>
SnooperSettings.png|Snooper Settings before 1.11.
Example Snooper Settings.png|Snooper Settings before it was removed in 1.14.
</gallery>

== References ==

{{reflist}}

== Navigation ==
{{Navbox Java Edition technical|general}}

[[Category:Java Edition]]

[[Minecraft:fr:Télémétrie]]
[[Minecraft:pt:Telemetria]]
[[Minecraft:zh:遥测]]