Android-KTag-Apps/subapp-mine

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:

1. Triggers a "BOOM!" explosion animation with haptic feedback
2. Broadcasts a Tag packet to damage the target device
3. Enters a rearm countdown period
4. 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