Stats
Links
Categories
Marketplace
mcsound
$
npx claudepluginhub andrewgazelka/mcsoundREADME
1 Plugin
mcsound
7·
Minecraft sound effects for Claude Code events
2w
andrewgazelkanpx claudepluginhub andrewgazelka/mcsoundMinecraft sound effects for Claude Code events
andrewgazelka
Add Minecraft sound effects to Claude Code
claude plugin marketplace add andrewgazelka/mcsound
claude plugin install mcsound
A Claude Code plugin that plays Minecraft sounds for coding events — hear a door open when you start a session, level up when tasks complete, and amethyst chimes when files are saved.
| Event | Sound |
|---|---|
| Session start | random/door_open |
| Session end | random/door_close |
| Task complete | random/levelup |
| Subagent complete | random/orb |
| Notification | note/bell |
| File write/edit | block/amethyst/place1 |
| Bash command | random/click |
| Task spawn | block/end_portal/endportal |
| Web search/fetch | block/end_portal/eyeplace1 |
Override any sound via environment variables:
| Variable | Default |
|---|---|
MCSOUND_SESSION_START | random/door_open |
MCSOUND_SESSION_END | random/door_close |
MCSOUND_STOP | random/levelup |
MCSOUND_SUBAGENT_STOP | random/orb |
MCSOUND_NOTIFICATION | note/bell |
MCSOUND_WRITE | block/amethyst/place1 |
MCSOUND_BASH | random/click |
MCSOUND_TASK | block/end_portal/endportal |
MCSOUND_WEB | block/end_portal/eyeplace1 |
# Example: change task complete sound
export MCSOUND_STOP="mob/villager/celebrate"
The plugin uses nix run for zero-install execution. No additional setup needed.
If you don't have Nix installed, build the binary locally:
cd ~/.claude/plugins/marketplaces/mcsound
cargo build --release
The plugin will automatically use the built binary at target/release/mcsound.
If you use Prism Launcher or have Minecraft installed in a non-standard location, set the MINECRAFT_HOME environment variable:
export MINECRAFT_HOME="$HOME/.local/share/PrismLauncher"
Can also be used as a standalone CLI tool:
# Run directly with Nix
nix run github:andrewgazelka/mcsound -- play mob/zombie/death
# List all sounds
nix run github:andrewgazelka/mcsound -- list
# Filter sounds
nix run github:andrewgazelka/mcsound -- list zombie
Install with Cargo:
cargo install --git https://github.com/andrewgazelka/mcsound
mcsound play mob/zombie/death
mcsound list zombie
Minecraft path: Auto-detects standard locations. Override with MINECRAFT_HOME env var.
Reads the Minecraft asset index to map sound names to hashed files in .minecraft/assets/objects/. Audio playback is bundled (no ffmpeg required).