DocsBluetooth LE Open API

Bluetooth LE Open API

Build your own apps and integrations that talk to BattleCore taggers and headsets over Bluetooth Low Energy.

Every BattleCore tagger and headset exposes a single, open GATT service over Bluetooth LE. Through it you can read and write the device's live state, drive its audio and lighting, provision WiFi, trigger firmware updates, and subscribe to a real-time stream of events — all with a simple JSON message format. No SDK, no proprietary tooling, and no pairing key required.

This is the same interface the official BattleCore app uses. It is documented here so anyone can build companion apps, scoreboards, overlays, arena controllers, or hardware bridges.

At a glance

  • One GATT service: ba771ec0-12e1-4e78-8a49-c16503f00ae1
  • Three characteristics — write commands, receive responses, receive events.
  • UTF-8 JSON messages of the form { method, ns, prop, value, id }.
  • ~70 device-state values, readable / writable / streamable by name.

Connecting

Discover a device, connect, and find the GATT service and its three characteristics.

Protocol & Commands

The JSON request / response / event format, and the full command reference by namespace.

Device State Reference

Every device-state value you can read, write, and subscribe to — ammo, health, lives, game state and more.