Mute Valeera (Delves)

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

1. /mutevaleera on — Enable muting
2. /mutevaleera ui — Open settings for customization
3. 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

1. Download a packaged release from GitHub Releases
2. Extract to: World of Warcraft/_retail_/Interface/AddOns/
3. Restart WoW or run /reload
4. 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

---

📜 License

All Rights Reserved (c) 2024–2026 Italist