LuraHelper

A polished fork of PugaHelper by Vaelhys — a World of Warcraft addon that displays L'ura symbol sequences in real-time during the Midnight Falls.

Why Fork?

The original PugaHelper nails the core functionality — symbol detection from raid chat events works flawlessly, even in combat. But it ships as a single monolithic file with no settings UI, no keybindings, hardcoded values, French-only strings, and an always-visible command frame that clutters the screen.

PugaHelper Extended keeps all the battle-tested combat logic intact and wraps it in a proper addon shell.

What Changed

New Features

• WoW Settings Panel — all options accessible via the native Settings UI (Esc > Options > Addons > PugaHelper Extended)
• Keybindings — bindable shortcuts for Toggle Diagram, Toggle Solo Mode, and Toggle Test Mode (Options > Keybindings > PugaHelper)
• Test Mode — press your macros outside of an encounter to fill the diagram and practice (/puga test)
• Frame Locking — prevent accidental repositioning (/puga lock)
• Opacity Control — adjustable transparency with hover-to-full-opacity effect
• UI Scale — scale all frames from 50% to 200%
• Full Slash Command System — /puga [toggle|solo|template|test|clear|heroic|normal|macro|lock|reset|settings|help]

Polish

• Tooltips on every interactive element — hover anything for an explanation
• English strings throughout (original was French)
• Proper SavedVariables — settings, frame positions, and visibility state persist correctly across sessions
• Clean frame position saving — stored as compact tables instead of flat key sprawl
• Diagram hidden by default — respects your saved enabled/disabled state on login
• Command frame removed — replaced by slash commands and the settings panel
• Icon and categories in the addon list

Code Quality

• Multi-file architecture — Core.lua (init, events, commands), PugaHelper.lua (UI), Settings.lua (options panel), Bindings.xml (keybindings)
• Consolidated symbol definitions — single SYMBOLS table instead of three separate lookup tables
• De-duplicated frame builders — diagram and template frames share parameterized constructors
• Removed unnecessary pcall wrapping around safe API calls
• Extracted constants — addon path, media path, color prefixes defined once

Unchanged

• Symbol detection logic — the chat event buffer system (yell + ping = triangle, etc.) is untouched
• Encounter timing windows — the three timed input windows with their open/close/reset/sound timers
• Solo mode — clickable symbol template for practice
• Macro creation — same 5 macros with the same icons and chat commands

Installation

Copy the PugaHelperExtended folder into your Interface/AddOns/ directory. The original PugaHelper folder is included in this repo for reference but is not needed to run the extended version.

Commands

Credits

• PugaHelper by Vaelhys — original addon and all combat mechanics
• PugaHelper Extended — UI overhaul, settings panel, test mode, and code cleanup