| name | game-sounds |
| description | Manage game sound effects โ change volume, switch sound packs, list available sounds |
| user_invocable | true |
/game-sounds โ Game Sound Manager
Manage your game sound effects for Claude Code.
Usage
When the user invokes /game-sounds, parse their arguments and execute the appropriate action:
Commands
/game-sounds โ Show current config (active pack, volume, rotation, enabled events)
/game-sounds volume <0.0-1.0> โ Set volume level
/game-sounds pack <name> โ Switch active sound pack (clears rotation)
/game-sounds list โ List available sound packs and their sounds
/game-sounds rotation add <pack> โ Add a pack to the session rotation list
/game-sounds rotation remove <pack> โ Remove a pack from the rotation list
/game-sounds rotation โ Show the current rotation list
/game-sounds rotation clear โ Clear rotation (reverts to single active_pack)
/game-sounds toggle <event> โ Enable/disable a specific event category
/game-sounds test [category] โ Play a test sound from the given category (default: session-start)
Implementation
Read and modify the config file at $CLAUDE_PLUGIN_ROOT/config.json.
For volume: Update the volume field (float 0.0 to 1.0).
For pack: Update active_pack field and set pack_rotation to []. Verify the pack directory exists in $CLAUDE_PLUGIN_ROOT/sounds/.
For rotation add: Append pack name to the pack_rotation array (if not already present). Verify the pack exists.
For rotation remove: Remove pack name from the pack_rotation array.
For rotation clear: Set pack_rotation to [].
For rotation (no subcommand): Display the current pack_rotation list.
For toggle: Flip the boolean in enabled_events.<event>.
For test: Run bash $CLAUDE_PLUGIN_ROOT/scripts/play-sound.sh <category>.
For list: Scan $CLAUDE_PLUGIN_ROOT/sounds/ directories and list packs with file counts.
When pack_rotation is non-empty, each new Claude Code session randomly picks one pack from the list for the entire session. Use the Bash tool to read/write config.json and the Read tool to display current settings.
Example responses
Status: "๐ฎ Game Sounds: Warcraft pack, volume 0.5, rotation: [mario, zelda, starcraft]"
Volume change: "๐ Volume set to 0.3"
Pack switch: "โ๏ธ Switched to starcraft pack (rotation cleared)"
Rotation add: "๐ฒ Added mario to rotation (now: mario, zelda)"
Rotation remove: "๐ฒ Removed mario from rotation (now: zelda)"