Play Minecraft sound effects for Claude Code session events—start, stop, notifications, and tool calls—using bash commands on every lifecycle event
Add Minecraft sound effects to Claude Code
[!NOTE] This project has moved. The
mcsoundCLI now lives in theindexable-inc/indexmonorepo atpackages/minecraft/sound(crate and binaryminecraft-sound). The monorepo version ships a Nix-fetched sound pack, so it plays sounds with no Minecraft install required. This repository is no longer the source of record and may be archived.
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).
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub andrewgazelka/mcsound --plugin mcsoundUltra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Memory compression system for Claude Code - persist context across sessions
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Curate auto-memory, promote learnings to CLAUDE.md and rules, extract proven patterns into reusable skills.