Skip to content

Game telemetry: Minecraft data on physical hardware ​

SerialCraft 0.4.6-beta can send game state and events to a connected device using reserved channels beginning with mc_. They are independent of a specific I/O Module and can be switched on in the Laptop Events tab.

text
mc_health:18
mc_hunger:14
mc_weather:1

These are illustrative protocol messages, not actual recorded measurements.

ChannelMeaningRange
mc_healthRounded health points0–1024
mc_hungerCurrent food level0–20
mc_timeDay time in ticks0–23999
mc_weatherClear, rain or thunderstorm0–2
mc_damageDamage event1–32767
mc_deathDeath event1

The protocol reference lists every supported channel, including air, saturation and experience level.

Try it ​

  1. Connect Arduino or ESP32 using USB or trusted local TCP.
  2. Open the Laptop and enable a channel under Events.
  3. Observe mc_ messages in the console or Visualize tab.
  4. Parse complete lines in your firmware and ignore unknown channel names.

Telemetry is disabled by default to avoid surprising older firmware.

States versus events ​

States such as hunger can be safely replaced by the latest measurement and periodically resent. Events such as death represent a particular occurrence and should not be replayed as if they happened again.

There is no guaranteed physical acknowledgement for events. Lost connections can lose events, and sending multiple channels shares capacity with I/O commands and waveforms.

Use bounded firmware buffers and never use the reserved mc_ prefix for your own I/O Module channel. Wi-Fi messages are not encrypted. See Visualize for observing incoming and outgoing signals.