KTag Mine Subapp

A Jetpack Compose Android application that acts as a proximity-triggered "mine" for KTag laser tag devices. When an enemy device comes within range, the mine automatically tags it with configurable damage.

How It Works

The Mine scans for nearby KTag devices broadcasting Status packets via BLE. When a device matching the target team enters the configured RSSI threshold, the mine:

Triggers a "BOOM!" explosion animation with haptic feedback
Broadcasts a Tag packet to damage the target device
Enters a rearm countdown period
Returns to armed state, ready to tag again

State Machine

The mine operates using a three-state machine:

State	Description	Display
Armed	Ready to tag incoming devices	"ARMED" watermark
Tagging	Explosion animation playing	BOOM! animation
Rearming	Countdown before re-arming	Countdown number

Settings

Access settings via the gear icon in the app bar.

Setting	Description	Default
Minimum RSSI	Signal strength threshold for triggering (-120 = far, 0 = close)	-60 dBm
Damage Applied	Amount of damage dealt to tagged devices	100
Target Team	Which team(s) to target (Red, Blue, or All)	All
Time to Rearm	Seconds before mine can tag again after detonation	5 seconds

UI Elements

Status Bar: Shows current target team, damage, and RSSI threshold
Device List: Displays detected KTag devices with:
- Device name and BLE address
- Current RSSI signal strength
- Status: IN RANGE, OUT OF RANGE, TAGGED, or TAGGED OUT
Watermark: Large centered text showing current state (ARMED or countdown)
Explosion Animation: Full-screen animation with expanding rings and "BOOM!" text

Permissions

BLUETOOTH_SCAN / BLUETOOTH_CONNECT - BLE operations
ACCESS_COARSE_LOCATION - Required for BLE scanning on older Android versions
VIBRATE - Haptic feedback on explosion

2 KiB Raw Blame History