Starcraft

StarCraft sound effects plugin for OpenCode. Plays iconic Protoss and Terran voice lines when things happen in your coding session.

Install

From npm (recommended)

Add opencode-starcraft to the plugin array in your OpenCode config file.

The config file is at ~/.config/opencode/opencode.json (global) or opencode.json (project-level).

{
  "plugin": ["opencode-starcraft"]
}

OpenCode installs npm plugins automatically at startup. No other steps needed.

From source

Clone this repo and copy index.js into your OpenCode plugins directory:

git clone https://github.com/spartandingo/opencode-starcraft.git
cp opencode-starcraft/index.js ~/.config/opencode/plugins/starcraft-sounds.js

How it works

Sound files are downloaded automatically on first run from The Sounds Resource and cached in ~/.config/opencode/sounds/starcraft/. No sound files are distributed with this package.

Audio playback uses child_process.spawn with platform-native commands (afplay on macOS, paplay on Linux) -- no additional dependencies required.

Mute / Unmute

You can mute sound effects at any time. There are two ways:

Slash command: Type /mute in the TUI to toggle sounds on/off. No setup required -- the command is registered automatically by the plugin.

Ask the LLM: Say "mute sounds" or "unmute sounds" in your session. The plugin registers an rts_mute_toggle tool that the LLM will call.

Mute state is persisted across sessions. When you unmute, a confirmation sound plays.

Events

OpenCode Event	Sound	Quote
session.created	scv-ready.wav	"SCV good to go, sir"
session.idle	scv-yes-sir.wav / scv-affirmative.wav	"Yes sir" / "Affirmative"
session.compacted	additional-pylons.wav	"You must construct additional pylons!"
session.error	not-enough-minerals-*.wav / not-enough-vespene-gas.wav	"Not enough minerals" / "Insufficient vespene gas"
permission.asked	scv-whaddya-want.wav / scv-im-not-listening.wav	"Whaddya want?"

Platform support

Platform	Audio command	Status
macOS	afplay (built-in)	Tested
Linux	paplay (PulseAudio)	Should work

Credits

• Sound files from StarCraft (Blizzard Entertainment) via The Sounds Resource
• Sounds are downloaded on demand and not distributed with this package
• StarCraft is a trademark of Blizzard Entertainment, Inc.

License

MIT