The SystemK USB Stick🔗

Overview🔗

This USB stick contains audio files and firmware for SystemK-based devices. The directory structure is organized into sound effect folders and platform-specific system files. The stick should be formatted as FAT32.

Structure Summary:

01/ - Game sound effects and event audio
10/ - Voiced number announcements (0-100)
ESP/ - 32ESPecial-specific configuration and firmware files

Directory: `01/` - Game Sound Effects🔗

Contains audio files for laser tag game events, UI feedback, and player interactions.

Note

The firmware only reads the first three characters of each filename (###) to identify sound files. Everything after them (such as _BigLaserBlast) is for human reference only, and can be changed without affecting functionality. Don't put two files with the same number in a directory: only one of them will be played.

Initialization & System🔗

001_.mp3 - System startup sound
010_.mp3 - Error notification
025_.mp3 - System reprogramming alert
031_.mp3 - "SystemK" (at startup, followed by 032 and the version number, such as "two point three")
032_.mp3 - "Version"

Weapon & Combat Sounds🔗

002_.mp3 - Primary weapon activated (shot fired)
003_.mp3 - Player hit confirmation
004_.mp3 - Player tagged out sound
005_.mp3 - Misfire (trigger pulled too soon after the previous shot)
018_.mp3 - Near miss alert
021_.mp3 - Friendly fire alert
026_.mp3 - Special weapon activated
028_.mp3 - Out of shots
029_.mp3 - "Reload" (followed by the number of shots, then 030 below)
030_.mp3 - "Shots"

006_.mp3 - Menu open/access sound
007_.mp3 - Selection confirmation
017_.mp3 - UI negative feedback sound ("bonk")
023_.mp3 - UI tone "boop"
024_.mp3 - UI tone "beep"

Settings Menus🔗

008_.mp3 - Health status announcement
011_.mp3 - Volume setting announcement
012_.mp3 - Right-handed mode
013_.mp3 - Left-handed mode
015_.mp3 - Hardware settings menu
016_.mp3 - Game settings menu
019_.mp3 - Player identification announcement
020_.mp3 - Team assignment announcement

Game State🔗

014_.mp3 - Game reentry
027_.mp3 - Game over

Item Transfers🔗

033_.mp3 - Transfer request (another device is asking this device to give it an item)
034_.mp3 - Item received
035_.mp3 - Item sent
036_.mp3 - Transfer failed

Music🔗

009_.mp3 - Lights and sounds test mode
022_.mp3 - "Starting Game" theme song

Directory: `10/` - Voiced Numbers🔗

Contains audio files with spoken numbers for menu navigation and settings display.

001.mp3 through 100.mp3 - Voiced numbers "one" to "one hundred"
101.mp3 - Voiced "zero"
102.mp3 - Voiced "point"

Directory: `ESP/` - ESP32-Specific Files🔗

Contains 32ESPecial-specific configuration and firmware files.

Configuration🔗

CONFIG.TXT - Saved configuration settings for the device (player preferences, hardware settings, game parameters)

Firmware🔗

Located in ESP/firmware/ subdirectory:

APP_.bin - Application firmware binary
Main program code for the 32ESPecial.
SPIFFS_.bin - SPI Flash File System binary
Embedded filesystem image corresponding to the firmware version.

Default USB Filesystem for the 32ESPecial🔗

Note

The v01.00 USB stick below predates sounds 028 to 036 and 10/102.mp3. A device plays nothing for a sound that isn't on its USB stick, so add your own files for those numbers if you'd like to hear them.

KTag 32ESPecial USB Stick v01.00

KTag 32ESPecial USB Stick v01.00 Contents

┌── 01
│   ├── 001_KTag_32ESPecial_Initialized.mp3
│   ├── 002_BigLaserBlast.mp3
│   ├── 003_YouveBeenHit.mp3
│   ├── 004_Death_Bell_2025.mp3
│   ├── 005_SciFiClick.mp3
│   ├── 006_Menu.mp3
│   ├── 007_Selected.mp3
│   ├── 008_health_remaining.mp3
│   ├── 009_party_lights.mp3
│   ├── 010_ErrorInMyProgramming.mp3
│   ├── 011_Volume.mp3
│   ├── 012_RightHanded.mp3
│   ├── 013_LeftHanded.mp3
│   ├── 014_GameOn.mp3
│   ├── 015_HardwareSettings.mp3
│   ├── 016_GameSettings.mp3
│   ├── 017_Sci-Fi_Bonk.mp3
│   ├── 018_NearMiss.mp3
│   ├── 019_PlayerID.mp3
│   ├── 020_Team.mp3
│   ├── 021_FriendlyFireAlert.mp3
│   ├── 022_KTag_Far_Horizon_02.mp3
│   ├── 023_Boop.mp3
│   ├── 024_Beep.mp3
│   ├── 025_Reprogramming_Initiated.mp3
│   ├── 026_DynamiteWithSensor.mp3
│   └── 027_GameOver.mp3
├── 10
│   ├── 001.mp3
│   ├── 002.mp3
│   ├── 003.mp3
|   ...
│   ├── 099.mp3
│   ├── 100.mp3
│   └── 101.mp3
└── ESP
    ├── CONFIG.TXT
    └── firmware
        ├── APP_2024Av01.00.bin
        └── SPIFFS_2024Av01.00.bin