Hail Mary Guild Tools

Hail Mary Guild Tools is a World of Warcraft addon focused on raid and group coordination. It combines cooldown tracking, encounter reminders, notes, and map utilities in a single Ace3-based addon.

Status

Stable version: 1.3
Current build: 2.0-beta
SavedVariables: HailMaryGuildToolsDB

Main Features

Custom tracker system with individual tracker configs
Interrupt, raid cooldown, and group cooldown tracking
Per-tracker bar and icon layouts
Buff Ending Announcer for selected buffs and channels
Raid Timeline for encounter-based text reminders and raid cooldown assignments
Notes window for raid or personal note management
Map Overlay with custom world map POIs
Version mismatch detection inside groups and raids
Blizzard AddOn options integration with Ace3-based module configuration

Modules

Tracker

The tracker system is the core feature of HMGT. It supports multiple independent tracker bars with custom spell categories, display modes, growth directions, party-frame attachment, and demo/test modes.

Buff Ending Announcer

Tracks selected buffs and channel-based spells and warns before they expire.

Map Overlay

Lets you create custom POIs on the world map and assign curated icon presets.

Raid Timeline

Allows encounter-based planning with timed reminders and raid cooldown assignments. The system is designed around encounterId data and supports encounter-specific configuration.

Notes

Provides a dedicated notes window for raid notes, personal notes, and drafts.

Commands

/hmgt Opens the addon configuration
/hmgt lock Locks all tracker frames
/hmgt unlock Unlocks all tracker frames
/hmgt demo Toggles tracker demo mode
/hmgt test Toggles tracker test mode
/hmgt notes Opens the notes window
/hmgt debug Opens the developer tools window
/hmgt dev Alias for the developer tools window
/hmgt version Opens the version window when developer tools are enabled

Installation

Copy the HailMaryGuildTools folder into: World of Warcraft/_retail_/Interface/AddOns/
Start or restart the game
Enable the addon on the character selection screen if needed

Project Structure

HailMaryGuildTools.lua Main addon bootstrap, communication, settings normalization, slash commands
HailMaryGuildToolsOptions.lua Root options UI and module integration
Core/ Shared windows and developer tooling
Modules/Tracker/ Tracker rendering, data, and options
Modules/BuffEndingAnnouncer/ Buff ending module and options
Modules/MapOverlay/ World map POIs, icon config, and options
Modules/RaidTimeline/ Encounter timeline logic, bossmod bridges, and options
Modules/Notes/ Notes window and options
Locales/ Localization files
Changelog.lua Ingame changelog data

Development Notes

The addon uses embedded Ace3 libraries
Module options are split into their own files where possible
Current development is happening on the 2.0-beta build line
The tracker system was heavily reworked in 2.0

Changelog

The ingame changelog is stored in Changelog.lua. Recent 2.0 highlights include:

Reworked tracker architecture based on individual tracker configs
Custom tracker creation
Improved party-frame attachment and upward bar layouts
Persistent tracker category selections
Tracker removal confirmation
Improved bar coloring behavior

3.4 KiB Raw Blame History