Telemetry: Difference between revisions

From ZeldaMods (Breath of the Wild)
Jump to navigation Jump to search
imported>BravelyPeculiar
m (clarification on Telemetry)
imported>Leoetlino
(→‎On Switch: improve formatting)
Line 6: Line 6:
=== Common report fields ===
=== Common report fields ===
==== Version info ====
==== Version info ====
* RomVer (game version)
{|class="wikitable"
* AocVer (DLC version)
! Field !! Description
|-
| RomVer || Game version
|-
| AocVer || [[DLC]] version
|}


==== Map info ====
==== Map info ====
* IsHardMode
{|class="wikitable"
* MapType: MainField, AocField, CDungeon, MainFieldDungeon
! Field !! Description
|-
| IsHardMode || Is Master Mode
|-
| MapType || MainField, AocField, CDungeon, MainFieldDungeon
|}


==== Play times ====
==== Play times ====
* PlayTime (play time since game init)
{|class="wikitable"
* AllPlayTime (cumulated play time)
! Field !! Description
|-
| PlayTime || Current play time (since the game was launched)
|-
| AllPlayTime || Cumulated play time (since the first launch)
|}


==== Position ====
==== Position ====
* PosX
{|class="wikitable"
* PosZ 
! Field !! Description
|-
| PosX || Player's position on the map
|-
| PosZ || Player's position on the map
|-
|}


=== Reports ===
=== Reports ===
* korok: whenever a hidden Korok appears. Includes: Korok ID, map info, play times, position
==== korok ====
* dungeon: when you enter a dungeon or divine beast or the Final Trial, leave it, or complete it. Includes: map info, dungeon name, event, play times
Whenever a hidden Korok appears.
* challenge: quest event. Includes: map info, Id, Name, Step, StepName, play times
* Korok ID
* gameover: obvious. Includes: map info, reason (e.g. lightning), Killer (the name of the actor that killed you), play times, position, CRC32 of map name
* Map info
* bloodymoon: includes version info, map info, Reason, RomWorkTime, SceneWorkTime, map name, play times, position
* Play times
* getitem: includes map info, CRC32 of the item name, position, play times
* Position
* options: Reports a bunch of misc things. BalloonTextOnOff, AutoSaveOnOff, options like CameraUpDownReverse, jump button change, whether you're playing in docked mode, ControllerType, PlayTimeHandheld, PlayTimeConsole, PlayTimeAll, audio mode (stereo, mono, surround), etc.
 
* emergencyheap: whenever a memory allocation is made using an emergency heap. Includes: version info, heap name, play times, position
==== dungeon ====
When the player enters a dungeon or divine beast or the Final Trial, leaves it or completes it.
* Map info
* Dungeon name
* Event
* Play times
 
==== challenge ====
Quest event.
* Map info
* Id
* Name
* Step
* StepName
* Play times
 
==== gameover ====
When the player dies.
* Map info
* Reason (e.g. lightning)
* Killer (the name of the actor that killed you)
* Play times
* Position
* CRC32 of map name
 
==== bloodymoon ====
When a [[Blood Moon]] occurs.
* Version info
* Map info
* Reason
* RomWorkTime
* SceneWorkTime
* Map name
* Play times
* Position
 
==== getitem ====
When an item is received.
* Map info
* CRC32 of the item name
* Position
* Play times
 
==== options ====
* BalloonTextOnOff
* AutoSaveOnOff
* Options like CameraUpDownReverse, jump button change, ...
* Whether the player is playing in docked mode or not
* ControllerType
* PlayTimeHandheld, PlayTimeConsole, PlayTimeAll
* Audio mode (stereo, mono, surround)
* etc.
 
==== emergencyheap ====
Whenever a memory allocation is made using an emergency heap (for example [[ActorSystem]]'s emergency heap because an actor's instSize is too low).
* Version info
* Heap name
* Play times
* Position


=== Debug reports ===
=== Debug reports ===

Revision as of 21:15, 8 October 2018

Breath of the Wild sends a significant amount of telemetry reports to Nintendo about in-game events and usage patterns.

On Switch

On the Nintendo Switch, the prepo system service is used to save these reports.

Common report fields

Version info

Field Description
RomVer Game version
AocVer Add-on content version

Map info

Field Description
IsHardMode Is Master Mode
MapType MainField, AocField, CDungeon, MainFieldDungeon

Play times

Field Description
PlayTime Current play time (since the game was launched)
AllPlayTime Cumulated play time (since the first launch)

Position

Field Description
PosX Player's position on the map
PosZ Player's position on the map

Reports

korok

Whenever a hidden Korok appears.

  • Korok ID
  • Map info
  • Play times
  • Position

dungeon

When the player enters a dungeon or divine beast or the Final Trial, leaves it or completes it.

  • Map info
  • Dungeon name
  • Event
  • Play times

challenge

Quest event.

  • Map info
  • Id
  • Name
  • Step
  • StepName
  • Play times

gameover

When the player dies.

  • Map info
  • Reason (e.g. lightning)
  • Killer (the name of the actor that killed you)
  • Play times
  • Position
  • CRC32 of map name

bloodymoon

When a Blood Moon occurs.

  • Version info
  • Map info
  • Reason
  • RomWorkTime
  • SceneWorkTime
  • Map name
  • Play times
  • Position

getitem

When an item is received.

  • Map info
  • CRC32 of the item name
  • Position
  • Play times

options

  • BalloonTextOnOff
  • AutoSaveOnOff
  • Options like CameraUpDownReverse, jump button change, ...
  • Whether the player is playing in docked mode or not
  • ControllerType
  • PlayTimeHandheld, PlayTimeConsole, PlayTimeAll
  • Audio mode (stereo, mono, surround)
  • etc.

emergencyheap

Whenever a memory allocation is made using an emergency heap (for example ActorSystem's emergency heap because an actor's instSize is too low).

  • Version info
  • Heap name
  • Play times
  • Position

Debug reports

Debug versions send additional play reports for many common in-game events, such as enemy kills, inventory items the player receives or uses, etc.

On Wii U

It is unknown whether the Wii U version includes telemetry code or not.