# BLU Release Notes

## Version 6.0.0-alpha (2025-08-08)

### 🎉 Major Refactor Release

This release represents a complete architectural overhaul of the BLU addon, focusing on performance, maintainability, and user experience.

### ✨ Highlights

- **Complete Codebase Cleanup**: Reduced addon size by 75% (removed 180MB+ of redundant files)
- **Modular Architecture**: Each feature is now a self-contained module
- **Professional Structure**: Industry-standard directory organization
- **Performance Optimized**: Lazy loading, on-demand module activation
- **Sound Consolidation**: Single sound file per event (volume controlled via settings)

### 🔧 Technical Changes

#### Directory Structure
- ✅ All directories and files now use lowercase naming convention
- ✅ Clear separation: `core/`, `modules/`, `interface/`, `media/`, `localization/`
- ✅ Removed all test files, build artifacts, and duplicate code
- ✅ Consolidated 200+ sound files (removed high/low variants)

#### Core Framework
- Custom event system without external dependencies
- Dynamic module loader with on-demand activation
- Centralized sound registry system
- SavedVariables database management
- Comprehensive configuration system

#### UI Improvements
- Narcissus-inspired design system
- Tabbed interface for settings
- Per-event sound customization
- Volume control (0-100%) with channel selection
- Sound preview functionality

#### Module System
Feature modules implemented:
- **LevelUp**: Character leveling events
- **Achievement**: Achievement unlocked notifications
- **Quest**: Quest accepted/completed sounds
- **Reputation**: Reputation changes
- **BattlePet**: Pet battle events
- **Honor**: PvP honor gains
- **Renown**: Renown rank increases
- **TradingPost**: Trading post activities
- **Delve**: Delve-specific events

### 📦 Installation

1. Download the latest release
2. Extract to `World of Warcraft/_retail_/Interface/AddOns/BLU`
3. Launch WoW and type `/blu` to open settings

### 🐛 Known Issues

- Options panel alignment needs fine-tuning
- Some sound packs not fully implemented
- Profile system pending implementation

### 🔄 Migration from v5.x

**Important**: This version uses a new SavedVariables structure. Your settings will be reset to defaults on first load.

### 📊 Performance Metrics

- **Memory Usage**: ~2MB idle, ~5MB active
- **CPU Impact**: <0.1% during normal gameplay
- **Load Time**: <100ms on average hardware

### 🎮 Compatibility

- **WoW Version**: 11.0.5 (The War Within)
- **Interface**: 110105
- **Classic Support**: Moved to separate BLU_Classic addon

### 👥 Contributors

- **donniedice**: Original author and maintainer
- **RGX Mods Community**: Testing and feedback

### 📝 Development Notes

This release establishes a clean foundation for future development:
- No external library dependencies
- Modular architecture allows easy feature additions
- Professional code organization improves maintainability
- Performance optimizations ensure minimal game impact

### 🚀 What's Next

- [ ] Complete sound pack library (50+ games)
- [ ] Profile system with import/export
- [ ] WeakAuras integration
- [ ] Custom trigger conditions
- [ ] Visual effects system

### 📋 Full Changelog

#### Added
- ARCHITECTURE.md documentation
- Professional directory structure
- Module loader system
- Sound registry pattern
- Narcissus design system

#### Changed
- Complete codebase reorganization
- All files/directories to lowercase
- Sound files consolidated (no more variants)
- SavedVariables structure updated
- UI panels rebuilt from scratch

#### Removed
- 180MB+ of duplicate/unused files
- High/low sound variants
- Test files and build artifacts
- Legacy Ace3 code
- Unused options implementations

#### Fixed
- Module loading performance
- Memory leaks in event handlers
- Sound playback timing
- Options panel registration
- File naming consistency

### 📞 Support

- **Issues**: [GitHub Issues](https://github.com/donniedice/BLU/issues)
- **Discord**: RGX Mods Community
- **Email**: donniedice@protonmail.com

---

*Thank you for using BLU! This release represents months of work to create a cleaner, faster, and more maintainable addon. Your feedback is always welcome.*