Mute Valeera (Delves)

Silence Valeera Sanguinar’s repetitive delve companion voice lines in World of Warcraft. Reduce audio clutter while keeping control over what gets muted — from basic chatter to critical warnings — using the same lightweight, single-file addon architecture as Mute Repetitive Brann.

✨ Features

Smart Muting — Choose partial muting (keep critical warnings) or full muting (mute everything)
In-Game Settings Panel — Open the addon settings category with /mutevaleera ui
Custom Sound IDs — Add your own sound IDs beyond the built-in list, with validation support
Import / Export — Share custom sound ID lists with friends or back them up safely
Slash Commands — Full command-line control for power users
Locale-Independent — Works in all WoW client languages (no locale-specific text matching)
Safe Failure Mode — If the client stops exposing the sound mute API, the addon warns once and disables muting instead of throwing Lua errors
Zero Performance Impact — Lightweight event-driven setup; no OnUpdate loops, init events unregister after load

🎮 Quick Start

/mutevaleera on — Enable muting
/mutevaleera ui — Open settings for customization
Use partial by default to keep important warnings: /mutevaleera partial

💬 Commands

Use /mutevaleera or /mv in chat:

Basic Controls

on / off / toggle — Control mute state
full / partial — Include or exclude critical gameplay lines
status — Show current settings and sound count
ui — Open settings panel
help / helpfull — Command help (brief / detailed)

Custom Sound IDs

add <ids> — Add custom IDs (e.g., add 12345,67890 or add 111 222 333)
del <ids> — Remove custom IDs
list — Show all custom IDs
clear — Clear all custom IDs (requires confirmation)
validate — Check custom IDs for potential issues

Advanced

export — Copy custom IDs for backup/sharing
import <ids> — Import custom IDs from a string

🔧 Settings Panel

Access via /mutevaleera ui or Interface → AddOns → Mute Valeera

Toggle main mute and critical lines (partial/full)
Add/remove custom sound IDs with a visual list
Validation feedback for entered IDs
Export/import for easy backup and sharing

📋 Examples

/mv on
/mutevaleera partial
/mutevaleera add 12345,67890
/mutevaleera add 111 222 333
/mutevaleera validate
/mutevaleera export
/mutevaleera import 12345,67890
/mv toggle
/mv full

🌍 Localization

Works in all WoW client languages — detection is locale-independent and avoids fragile string matching.

⚙️ Compatibility

Retail (Midnight) compatible — ## Interface: 120001
Existing MuteValeeraSettings are preserved across updates
If the game client removes or changes the sound muting API, the addon disables muting cleanly after a one-time warning

🎯 Default Scope (Built-In Sound List)

The built-in mute list targets Valeera Sanguinar delve-companion voice assets introduced after build 12.0.0.63534.

Initial auditing used the Wago Tools Valeera file search (pages 9–15) and did not produce any files meeting the criteria “first version > 12.0.0.63534”.
Result: version 1.0.0 ships with an empty built-in mute list and relies on the custom sound-ID workflow until confirmed post-63534 Valeera lines are verified.

📦 Installation

Download a packaged release from GitHub Releases
Extract to: World of Warcraft/_retail_/Interface/AddOns/
Restart WoW or run /reload
Configure with /mutevaleera ui

🚀 Release Process

Releases are tag-driven and automated:

Pushing a tag matching v* triggers GitHub Actions packaging + a GitHub release
This repository publishes GitHub releases only
(CurseForge publishing is intentionally disabled until a real project exists)

Security note: Never commit tokens or credentials anywhere in the repo (docs, issues, PRs, or config intended for commit).
Windows dry-run packaging uses package.ps1 — see PUBLISHING.md for prerequisites and troubleshooting.

🤝 Contributing

Contributor guidance: CONTRIBUTING.md
Publishing + Windows troubleshooting: PUBLISHING.md

🧩 Support

Issues: GitHub Issues
Releases: GitHub Releases

🏷️ Tags (SEO)

Valeera Sanguinar, Mute Voice Lines, WoW Addon, Delves, Companion, Audio Control, Sound Management, War Within, TWW, Midnight, Quality of Life, Immersion, Retail