https://github.com/djdefi/healiq
HealIQ - Resto Druid smart healer suggestion addon for WoW retail
https://github.com/djdefi/healiq
wowaddon wowaddons
Last synced: 10 months ago
JSON representation
HealIQ - Resto Druid smart healer suggestion addon for WoW retail
- Host: GitHub
- URL: https://github.com/djdefi/healiq
- Owner: djdefi
- License: mit
- Created: 2025-07-10T03:49:59.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-08-15T18:30:49.000Z (11 months ago)
- Last Synced: 2025-08-15T20:38:23.794Z (10 months ago)
- Topics: wowaddon, wowaddons
- Language: Lua
- Homepage:
- Size: 649 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# HealIQ
**HealIQ** is a smart spell suggestion addon for Restoration Druids in World of Warcraft. It helps you prioritize your next healing spell based on current combat context, active HoTs, procs, and cooldowns.
## 🧠 What It Does
- Displays optimal healing spell suggestions based on Wowhead Restoration Druid guide
- Tracks HoT durations (e.g. Lifebloom, Rejuvenation)
- Recognizes Clearcasting procs and emergency situations
- Shows Swiftmend combo opportunities and AoE healing priorities
- Alerts for cooldown-based healing (e.g. Wild Growth, Tranquility)
- Supports movement and configuration of suggestion UI
- Shows upcoming suggestions in a queue display
- Provides extensive strategy customization options
**Enhanced Strategy Features:**
- Efflorescence maintenance prioritization
- Smart Lifebloom tank management with bloom timing
- Clearcasting proc optimization
- Swiftmend + Wild Growth combo suggestions
- Grove Guardians charge pooling
- Wrath filler for mana restoration
- Configurable thresholds for all healing decisions
**Note:** HealIQ provides visual suggestions only. Due to Blizzard restrictions, spell casting must be done manually using your normal keybinds or action bars.
> HealIQ is inspired by Hekili, but for healing. Designed with Restoration Druids in mind, support for other healers may be added later.
## 📦 Installation
### From CurseForge (Recommended)
- Download from [CurseForge](https://curseforge.com) using the CurseForge app or website
- Automatic updates and dependency management
### Manual Installation
1. Download the latest release from [GitHub Releases](https://github.com/djdefi/healiq/releases)
2. Unzip to your `Interface/AddOns/` directory
3. Enable the addon in the WoW AddOn menu
4. Type `/healiq` for basic options and slash commands (coming soon)
## 🔧 Configuration
- UI icon is movable (drag-and-drop)
- Suggestions shown via a single icon by default
- Queue preview shows upcoming spell suggestions
- Extensive strategy customization via `/healiq strategy` commands
- Rule enable/disable via `/healiq rules` commands
- All healing thresholds and priorities are tunable
**Strategy Configuration:**
- Access via `/healiq strategy list` to see all settings
- Modify with `/healiq strategy set `
- Reset to optimal defaults with `/healiq strategy reset`
- See [STRATEGY.md](STRATEGY.md) for detailed configuration guide
## 📜 Planned Features
- DBM integration for upcoming damage phases
- Rule customization (enable/disable rules)
- Visual “queue” preview
- Support for hybrid Resto-DPS catweaving
## 💡 Why Use This?
Healing doesn’t follow a strict rotation, but there are patterns of optimal decision-making. HealIQ helps you build muscle memory and learn when to refresh HoTs, use procs, or prep cooldowns for big AoE.
## 🛠 For Developers
This addon is written in Lua using the WoW AddOn API.
### Development Setup
1. **Quick Setup:**
```bash
./setup-dev.sh
```
This script will install Lua, luacheck, and set up the development environment.
2. **Manual Setup:**
```bash
# Install dependencies (Ubuntu/Debian)
sudo apt-get install lua5.1 luarocks
sudo luarocks install luacheck
# Or on macOS with Homebrew
brew install lua luarocks
luarocks install luacheck
```
### Code Quality
This project uses automated linting to catch issues early:
- **Pre-commit hooks** automatically run luacheck before each commit
- **CI/CD pipeline** runs comprehensive linting on all pull requests
- **Local linting:** Run `luacheck *.lua` to check your code
### Running Tests
```bash
# Run the main test suite
lua5.1 test_runner.lua
# Run basic validation
lua5.1 Tests.lua
# Run loading order tests (regression test for issue #98)
lua5.1 test_loading_order.lua
```
### Contributing
1. Fork the repository
2. Create a feature branch: `git checkout -b feature-name`
3. Make your changes (linting will run automatically on commit)
4. Run tests: `lua5.1 test_runner.lua`
5. Submit a pull request
The pre-commit hook will prevent commits with linting issues. To bypass temporarily (not recommended): `git commit --no-verify`
Contributions and suggestions welcome via [Issues](https://github.com/djdefi/healiq/issues) and PRs.
---
## 🔒 License
MIT License