Blood Elf Restore v0.7.0-alpha

Blood Elf Restore v0.7.0-alpha

Highlights

• Added DebugChatFrame integration with a dedicated BElfVR chat tab for live debug output (requires optional DebugChatFrame addon).
• Added a 2000-line ring-buffer debug log that persists across /reload and logout, with a copyable in-game dump window (/belr dumplog).
• Added structured debug logging across all major event handlers, voice decisions, and music state changes.
• Fixed intro music never playing on login or zone entry because loading-screen arrivals unconditionally skipped the intro instead of respecting the 10-minute cooldown.

New Features

• Debug.lua — new file providing DebugChatFrame integration, global c() / cp() logging shortcuts, and SavedVariables log capture.
• /belr dumplog — opens a scrollable, copyable window with the full debug log. Use Ctrl+A then Ctrl+C to extract.
• /belr log clear — clears the debug log buffer.
• All voice and music verbose output (Log(), LogMusic()) now also routes to DebugChatFrame when installed.
• Pre-init buffering captures startup lines logged before ADDON_LOADED.

Bug Fixes

• Fixed intro music being permanently skipped on all loading-screen arrivals (login, /reload, zone portals). The intro now correctly defers to the existing 10-minute SavedVariables-persisted cooldown instead of being unconditionally blocked.
• Fixed the world-entry settle window clearing the intro pending flag, which prevented intro playback even when the cooldown had expired.
• Filtered CVAR_UPDATE debug logging to Sound_* CVars only, eliminating irrelevant camera/perks/splash screen noise.
• Suppressed periodic EvaluateMusicState heartbeat logging (~1s) to keep the debug log focused on meaningful state changes.

Included In This Release

• new Debug.lua
• updated BElfRestore.lua, bloodElfRestore.toc
• refreshed README.md, DEV_NOTES.md, and CHANGELOG.md
• no changes to Config.lua, SoundData.lua, or generated catalogs

Upgrade Notes

• Version: v0.7.0-alpha
• Addon package zip: bloodElfRestore-v0.7.0-alpha.zip
• Tag: v0.7.0-alpha
• Recommended install: extract the bloodElfRestore folder into Interface/AddOns/
• Optional: install DebugChatFrame for a live debug chat tab

Blood Elf Restore v0.6.4-alpha

Blood Elf Restore v0.6.4-alpha

Highlights

• Added a dedicated silvermoon_interior music region so Silvermoon City buildings can use calmer scenic TBC ambience instead of the outdoor day/night cycle.
• Routed Silvermoon interior playback through IsIndoors() plus explicit subzone overrides such as Wayfarer's Rest, with a fallback chain back to normal Silvermoon outdoor pools when an interior category is empty.
• Refreshed the docs for 0.6.4-alpha, including the missing voice test slash commands, install/layout guidance, and README reference fixes.

Included In This Release

• updated BElfRestore.lua, Config.lua, SoundData.lua, and bloodElfRestore.toc
• refreshed README.md, DEV_NOTES.md, and CHANGELOG.md
• no new generated catalogs or tooling changes in this release bundle

Upgrade Notes

• Version: v0.6.4-alpha
• Addon package zip: bloodElfRestore-v0.6.4-alpha.zip
• Tag: v0.6.4-alpha
• Recommended install: extract the bloodElfRestore folder into Interface/AddOns/

Blood Elf Restore v0.6.3-alpha

Blood Elf Restore v0.6.3-alpha

Highlights

• Fixed supported-region music transitions so moving between areas like Silvermoon City and Sunstrider Isle now swaps TBC music immediately instead of waiting for the previous regional track to finish.
• Split active injected-track ownership from live player-area tracking, which closes the stale-playback gap behind those delayed region handoffs.
• Hardened GUID parsing and debug logging so protected or non-creature gossip targets no longer throw secret-string / taint errors when the addon inspects or logs them.
• Kept the earlier v0.6.2-alpha Silvermoon load-screen music fix and rolled these follow-up transition and gossip-object fixes on top of it.

Included In This Release

• updated BElfRestore.lua and bloodElfRestore.toc
• refreshed README.md, DEV_NOTES.md, and CHANGELOG.md
• no new generated catalogs or data files in this hotfix release

Upgrade Notes

• Version: v0.6.3-alpha
• Addon package zip: bloodElfRestore-v0.6.3-alpha.zip
• Tag: v0.6.3-alpha
• Recommended install: extract the bloodElfRestore folder into Interface/AddOns/

Blood Elf Restore v0.6.1-alpha

Blood Elf Restore v0.6.1-alpha

Highlights

• Fixed the voice-scope regression so out-of-scope NPCs no longer inherit TBC Blood Elf voices, and added voice-side native-only exclusions such as Harandar.
• Narrowed hidden-race target-select fallback to positive Blood Elf name and profile hints, which stops generic humanoid false positives while preserving supported Silvermoon NPCs.
• Blocked target-select TBC playback for dead and hostile or attackable units, fixing corpse and combat-adjacent misfires.
• Restored hidden-race target-select recognition for Doomsayer and Household Attendant via exact built-in Blood Elf profiles.
• Fixed the reload crash caused by the hidden-race fallback helper being referenced before Lua had a valid local upvalue.
• Tightened startup music purge ordering so tracked music mutes are armed before music is re-enabled, reducing Silvermoon intro overlap on login and /reload.
• Cleaned the public docs, moved README testing guidance to exploratory issue-tracker-driven testing, and cut the release surfaces to v0.6.1-alpha.

Included In This Release

• updated BElfRestore.lua, Config.lua, and bloodElfRestore.toc
• refreshed README.md, DEV_NOTES.md, and CHANGELOG.md
• no new generated catalogs or data files in this hotfix release

Upgrade Notes

• Version: v0.6.1-alpha
• Addon package zip: bloodElfRestore-v0.6.1-alpha.zip
• Tag: v0.6.1-alpha
• Recommended install: extract the bloodElfRestore folder into Interface/AddOns/

Blood Elf Restore v0.6.0-alpha

Blood Elf Restore v0.6.0-alpha

Highlights

• Tightened music ownership to Midnight Quel'Thalas only, with map-lineage scope checks and native-only exclusions so unrelated zones stay on Blizzard music.
• Rebuilt music muting around a generated Midnight catalog plus supplemental Blizzard interior zonemusic coverage, fixing Deatholme and Silvermoon inn overlap.
• Moved safe voice, music, and UI policy into Config.lua, including persisted intro cooldown rules by region, zone, subzone, area, pool, and exact track ID.
• Fixed several stability regressions from the refactor pass, including reload overlap, temporary audio-setting recovery, and the Lua chunk-local overflow/load break.
• Tightened target-loss bye behavior so late fly-away disengages no longer play point-blank farewell audio.
• Fixed the Music tab layout so longer status text no longer overlaps the action buttons.

Included In This Release

• Config.lua
• Midnight_ID_catalog.lua
• Midnight_ID_Index.md
• updated BElfRestore.lua, SoundData.lua, and bloodElfRestore.toc
• refreshed README.md, DEV_NOTES.md, and CHANGELOG.md
• assets and generator scripts under assets/ and tools/

Upgrade Notes

• Version: v0.6.0-alpha
• Addon package zip: bloodElfRestore-v0.6.0-alpha.zip
• Tag: v0.6.0-alpha
• Recommended install: extract the bloodElfRestore folder into Interface/AddOns/

v0.5.0-alpha

v0.5.0-alpha

• Bumped working addon/docs metadata version from 0.4.0-alpha to 0.5.0-alpha.
• Rebranded visible addon naming from Blood Elf Voice Restore to Blood Elf Restore.
• Renamed main addon script from BElfVoiceRestore.lua to BElfRestore.lua and updated TOC load order.
• Switched primary slash command docs/UI prompts to /belr while keeping /belvr as a legacy alias.
• Renamed the legacy southern music routing label from ghostlands to eversong_south to match Midnight-era zone reality.
• Added a dedicated deatholme music region so Ruins of Deatholme no longer shares the full southern random pool.
• Added legacy compatibility so custom SoundData.lua packs that still define ghostlands are treated as eversong_south.
• Added /belr music note <text> to write manual zone/subzone/region marker lines into the trace buffer.
• Added a StopMusic() pre-playback reset before replacement music starts to reduce native Midnight overlap in leak-prone pockets.
• Added native-music suppression by temporarily forcing Sound_MusicVolume=0 while replacement music is active in supported areas, then restoring the prior value when leaving control.
• Switched injected replacement music playback to the Master channel so native Music channel suppression does not cut the injected track.
• Added immediate CVAR_UPDATE handling for Sound_EnableMusic and Sound_EnableAllSound so Ctrl+M and sound toggles react without waiting for periodic ticks.
• Fixed intro routing so intro cues are queued only on true fresh entry into supported music space, not on every internal region swap.
• Rebalanced southern pools so deatholme no longer uses 53513, and Deatholme now uses a darker dedicated intro/day/night selection.
• Added scalable/clipped UI background-art support (assets/tbc_art.jpg) with configurable margins and independent X/Y art scaling.
• Added a dedicated amani music region (Amani Pass / Zeb ruins routing) with verified old TBC Zul'Aman ambient FileDataIDs (53825-53830) so troll subzones no longer default to elf music.
• Added dynamic Amani routing fallback for subzone names containing amani or zeb'.
• Added thalassian range regional override to keep southern corridor routing stable.
• Added fail-safe playback fallback for amani: if a selected Zul'Aman path cannot be played in the current client build, routing falls back to southern-Eversong pool selection.
• Added TBC_ID_CATALOG.lua and TBC_ID_INDEX.md generated from wowdev/wow-listfile (202603051942) to provide a full TBC zone-music ID database for future config-driven routing.
• Added tools/generate_tbc_catalog.ps1 to regenerate the TBC catalog/index from a listfile dump.

v0.4.0-alpha

Second public alpha release of Blood Elf Voice Restore.

This update significantly expands and stabilizes the addon's music system while also improving the in-game settings UI.

Highlights in this release:

• Expanded the music system from a basic first-pass layer into broader regional routing
• Added distinct music families for:
  • Silvermoon
  • Eversong
  • Sunstrider Isle
  • ghostlands-style southern / haunted Quel'Thalas areas
• Added many more tracked Midnight music FileDataIDs to reduce double-music bleed-through in remastered subzones
• Added more subzone-to-region overrides so remastered sub-areas route more consistently
• Added region-aware TBC music pools for Eversong, Sunstrider, and ghostlands-style areas
• Added intro cooldown handling so intro cues do not replay too often on quick re-entry
• Added track-duration handling so known tracks can finish naturally instead of being cut off by the old coarse timer
• Reduced constant restart churn from tiny subzone and resting-state changes by using broader region-based routing
• Improved handling of WoW's global music toggle (Ctrl+M) so the addon resumes more cleanly when music is re-enabled
• Fixed /belvr music stop so it now stays stopped until a meaningful resume trigger happens
• Reworked the settings window into separate Voice and Music tabs instead of one long stacked panel
• Fixed startup music double-play on initial login / world entry
• Fixed slash-command music tests so they now use the same region-aware music selection as the live system

Current limitations:

• This is still an alpha build
• The music system is still an addon-side approximation, not a true engine-level override of Blizzard's music resolver
• The addon still cannot reliably read the exact native Midnight music FileDataID currently playing
• Ctrl+M music disable may still cut off abruptly because Blizzard appears to clamp the music channel immediately
• Some remastered Quel'Thalas subzones may still need additional routing and mute-ID refinement

Feedback is most useful when it includes:

• exact zone and subzone names
• whether you were indoors, resting, or crossing a boundary
• whether native Midnight music was still audible underneath the replacement track
• a SavedVariables music trace captured after /reload or logout

v0.3.0-alpha

Release title:

v0.3.0-alpha

Release notes:

First public alpha release of Blood Elf Voice Restore.

This version restores classic TBC-style Blood Elf NPC voice playback in Midnight-era Silvermoon and adds a first-pass Silvermoon / Eversong music replacement system.

Included in this release:

• Mutes tracked Midnight Blood Elf NPC voice files
• Plays TBC greet, bye, and pissed voice lines during supported NPC interactions
• Supports left-click target greet, gossip greet, gossip close bye, and target-loss bye
• Includes GUID-based and name-based override tools for problematic NPCs
• Includes in-game UI controls and test playback buttons
• Adds first-pass TBC music injection for supported Silvermoon / Eversong areas
• Mutes tracked Midnight music IDs for the supported music layer
• Supports intro, day, and night music pools
• Uses shuffle-with-cooldown logic to reduce immediate music repeats
• Includes music verbose diagnostics and a SavedVariables-based music trace recorder for route mapping

Important notes:

• This is an alpha build and still uses heuristic area matching for the music system
• Music replacement is addon-side and not a true engine-level override of Blizzard's internal music resolver
• Some Silvermoon subzones and interiors may still need further mapping and refinement
• The music trace recorder writes to SavedVariables and is saved on /reload or logout

Known rough edges:

• Injected music transitions are improved but may still feel abrupt in some area changes
• Additional Midnight music FileDataIDs may still need to be identified and muted
• Some NPCs may still require manual override commands if Blizzard hides or misreports metadata

Feedback is most useful when it includes:

• exact zone / subzone names
• whether you were indoors, resting, or moving between boundaries
• any music trace capture produced during testing