mcsound

Add Minecraft sound effects to Claude Code

[!NOTE] This project has moved. The mcsound CLI now lives in the indexable-inc/index monorepo at packages/minecraft/sound (crate and binary minecraft-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.

Sound Mappings

Configuration

Override any sound via environment variables:

# Example: change task complete sound
export MCSOUND_STOP="mob/villager/celebrate"

Requirements

• Minecraft Java Edition must have been launched at least once (to download sound assets)
• Either Nix or Rust/Cargo for building locally

Installation

With Nix

The plugin uses nix run for zero-install execution. No additional setup needed.

Without Nix (Cargo)

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.

Prism Launcher / Alternative Minecraft Locations

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"

# 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

cargo install --git https://github.com/andrewgazelka/mcsound

mcsound play mob/zombie/death
mcsound list zombie