@citedy/game-sounds 1.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "@citedy/game-sounds",
+  "version": "1.0.0",
+  "description": "Game sound effects for Claude Code — Warcraft, StarCraft, Diablo & more. Work work! 🔨",
+  "author": "Citedy <hello@citedy.com>",
+  "homepage": "https://www.citedy.com",
+  "repository": "https://github.com/citedy/game-sounds"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Citedy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# @citedy/game-sounds
+
+Game sound effects for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — hear Warcraft Peon voice lines as you code!
+
+**"Work work!"** when you submit a prompt. **"Job's done!"** when the task completes. **"Stop poking me!"** on errors.
+
+## Install
+
+```bash
+# npm
+npm install -g @citedy/game-sounds
+claude --plugin-dir $(npm root -g)/@citedy/game-sounds
+
+# Or clone locally
+git clone https://github.com/citedy/game-sounds.git
+claude --plugin-dir ./game-sounds
+```
+
+## Sound Packs
+
+### Warcraft (default)
+
+| Event | Sound Category | Example Phrases |
+|-------|---------------|-----------------|
+| Session Start | `session-start` | "Ready to work", "Something need doing?" |
+| Prompt Submit | `task-acknowledge` | "Work work", "Zug zug", "Okie dokie" |
+| Task Complete | `task-complete` | "Job's done!", "Work complete" |
+| Error | `error` | "Stop poking me!", "That was a mistake" |
+| Notification | `permission` | "What?", "What now?" |
+
+More packs coming soon: StarCraft, Diablo, Zelda, Mario...
+
+## Commands
+
+Use `/game-sounds` in Claude Code to manage settings:
+
+```
+/game-sounds              # Show current config
+/game-sounds volume 0.3   # Set volume (0.0-1.0)
+/game-sounds pack warcraft # Switch sound pack
+/game-sounds list         # List available packs
+/game-sounds toggle error # Enable/disable event category
+/game-sounds test         # Play a test sound
+```
+
+## Config
+
+Edit `config.json` to customize:
+
+```json
+{
+  "volume": 0.5,
+  "active_pack": "warcraft",
+  "enabled_events": {
+    "session-start": true,
+    "task-acknowledge": true,
+    "task-complete": true,
+    "error": true,
+    "permission": true
+  }
+}
+```
+
+## Platform Support
+
+- **macOS**: `afplay` (built-in)
+- **Linux**: `paplay` (PulseAudio), `pw-play` (PipeWire), or `ffplay` (FFmpeg)
+
+## Adding Custom Sound Packs
+
+Create a new directory under `sounds/` with the pack name:
+
+```
+sounds/
+└── my-pack/
+    ├── session-start/
+    ├── task-complete/
+    ├── task-acknowledge/
+    ├── error/
+    └── permission/
+```
+
+Add `.mp3`, `.wav`, or `.ogg` files to each category folder. Then switch:
+
+```
+/game-sounds pack my-pack
+```
+
+## Credits
+
+Sound files sourced from [PeonPing](https://github.com/PeonPing/peon-ping). Warcraft is a trademark of Blizzard Entertainment.
+
+---
+
+Made with ⚔️ by [Citedy](https://www.citedy.com) — AI platform for SEO content automation.

package/config.json

@@ -0,0 +1,11 @@
+{
+  "volume": 0.5,
+  "active_pack": "warcraft",
+  "enabled_events": {
+    "session-start": true,
+    "task-acknowledge": true,
+    "task-complete": true,
+    "error": true,
+    "permission": true
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,24 @@
+{
+  "hooks": [
+    {
+      "event": "SessionStart",
+      "command": "bash $CLAUDE_PLUGIN_ROOT/scripts/play-sound.sh session-start",
+      "timeout": 5000
+    },
+    {
+      "event": "UserPromptSubmit",
+      "command": "bash $CLAUDE_PLUGIN_ROOT/scripts/play-sound.sh task-acknowledge",
+      "timeout": 5000
+    },
+    {
+      "event": "Stop",
+      "command": "bash $CLAUDE_PLUGIN_ROOT/scripts/play-sound.sh task-complete",
+      "timeout": 5000
+    },
+    {
+      "event": "Notification",
+      "command": "bash $CLAUDE_PLUGIN_ROOT/scripts/play-sound.sh permission",
+      "timeout": 5000
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@citedy/game-sounds",
+  "version": "1.0.0",
+  "description": "Game sound effects for Claude Code — Warcraft, StarCraft & more. Work work! 🔨",
+  "keywords": [
+    "claude-code",
+    "claude-code-plugin",
+    "game-sounds",
+    "warcraft",
+    "sound-effects",
+    "developer-experience"
+  ],
+  "author": "Citedy <hello@citedy.com>",
+  "license": "MIT",
+  "homepage": "https://www.citedy.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/citedy/game-sounds"
+  },
+  "files": [
+    ".claude-plugin/",
+    "hooks/",
+    "scripts/",
+    "skills/",
+    "sounds/",
+    "config.json",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/play-sound.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# play-sound.sh — Play a random game sound for a Claude Code event
+# Usage: play-sound.sh <category>
+# Categories: session-start, task-acknowledge, task-complete, error, permission
+
+set -euo pipefail
+
+CATEGORY="${1:-}"
+if [[ -z "$CATEGORY" ]]; then
+  exit 0
+fi
+
+# Resolve plugin root
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
+CONFIG_FILE="$PLUGIN_ROOT/config.json"
+
+# Read config
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  exit 0
+fi
+
+# Parse config with built-in tools (no jq dependency)
+VOLUME=$(python3 -c "import json; print(json.load(open('$CONFIG_FILE'))['volume'])" 2>/dev/null || echo "0.5")
+ACTIVE_PACK=$(python3 -c "import json; print(json.load(open('$CONFIG_FILE'))['active_pack'])" 2>/dev/null || echo "warcraft")
+EVENT_ENABLED=$(python3 -c "import json; c=json.load(open('$CONFIG_FILE')); print(c['enabled_events'].get('$CATEGORY', True))" 2>/dev/null || echo "True")
+
+if [[ "$EVENT_ENABLED" == "False" ]]; then
+  exit 0
+fi
+
+# Find sound files
+SOUND_DIR="$PLUGIN_ROOT/sounds/$ACTIVE_PACK/$CATEGORY"
+if [[ ! -d "$SOUND_DIR" ]]; then
+  exit 0
+fi
+
+# Collect all mp3/wav/ogg files
+SOUNDS=()
+while IFS= read -r -d '' f; do
+  SOUNDS+=("$f")
+done < <(find "$SOUND_DIR" -type f \( -name "*.mp3" -o -name "*.wav" -o -name "*.ogg" \) -print0 2>/dev/null)
+if [[ ${#SOUNDS[@]} -eq 0 ]]; then
+  exit 0
+fi
+
+# No-repeat: avoid playing the same sound twice in a row
+LAST_PLAYED_FILE="/tmp/game-sounds-last-$CATEGORY"
+LAST_PLAYED=""
+if [[ -f "$LAST_PLAYED_FILE" ]]; then
+  LAST_PLAYED=$(cat "$LAST_PLAYED_FILE" 2>/dev/null || true)
+fi
+
+# Pick a random sound, avoiding last played if possible
+if [[ ${#SOUNDS[@]} -gt 1 ]]; then
+  ATTEMPTS=0
+  while true; do
+    IDX=$((RANDOM % ${#SOUNDS[@]}))
+    SOUND="${SOUNDS[$IDX]}"
+    if [[ "$SOUND" != "$LAST_PLAYED" ]] || [[ $ATTEMPTS -ge 5 ]]; then
+      break
+    fi
+    ATTEMPTS=$((ATTEMPTS + 1))
+  done
+else
+  SOUND="${SOUNDS[0]}"
+fi
+
+# Save last played
+echo "$SOUND" > "$LAST_PLAYED_FILE"
+
+# Play sound (background, non-blocking)
+if command -v afplay &>/dev/null; then
+  # macOS
+  afplay -v "$VOLUME" "$SOUND" &
+elif command -v paplay &>/dev/null; then
+  # Linux (PulseAudio) — paplay doesn't support volume flag easily, use pw-play
+  paplay "$SOUND" &
+elif command -v pw-play &>/dev/null; then
+  # Linux (PipeWire)
+  pw-play --volume "$VOLUME" "$SOUND" &
+elif command -v ffplay &>/dev/null; then
+  # Fallback: ffplay
+  ffplay -nodisp -autoexit -volume "$(python3 -c "print(int($VOLUME * 100))")" "$SOUND" &>/dev/null &
+fi
+
+exit 0

package/skills/game-sounds/SKILL.md

@@ -0,0 +1,40 @@
+---
+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, enabled events)
+- `/game-sounds volume <0.0-1.0>` — Set volume level
+- `/game-sounds pack <name>` — Switch active sound pack (e.g., warcraft, starcraft)
+- `/game-sounds list` — List available sound packs and their sounds
+- `/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. Verify the pack directory exists in `$CLAUDE_PLUGIN_ROOT/sounds/`.
+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.
+
+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, all events enabled"
+**Volume change**: "🔊 Volume set to 0.3"
+**Pack switch**: "⚔️ Switched to starcraft pack"