KeystonePercentageHelper

Addon port of https://wago.io/4pHPrk9NM

Contributors Forks Stargazers Issues Discord License


Logo

Keystone Percentage Helper

A percentage helper for World of Warcraft mythic+ dungeons.

Report Bug · Request Feature

About The Project

Keystone Percentage Helper is an addon designed to assist players in tracking enemy forces percentage during Mythic+ dungeon runs. Originally inspired by the WeakAura WA RM+, this WeakAura has been rewritten as a standalone addon to provide better performance and reliability.

The addon helps you optimize your routes by:

  • Displaying the current enemy forces percentage
  • Showing target percentages for each boss
  • Warning you and your group when approaching important percentage thresholds
  • Supporting all current season dungeons and previous expansions
  • Allowing full customization of percentage targets for each dungeon

Whether you're a seasoned Mythic+ runner or just starting out, this addon helps ensure you reach the required enemy forces percentage at the right time, making your runs more efficient and organized.

Why an Addon Instead of a WeakAura?

While the original WeakAura served its purpose well, converting it to a standalone addon brings several significant advantages:

  • Better Performance: Uses significantly less memory and CPU resources compared to the WeakAura version
  • Faster Response: More reactive to game events, providing real-time percentage updates
  • Easier Maintenance: Structured codebase makes it easier to update for new seasons and expansions
  • Enhanced Reliability: Built using WoW's addon framework for more stable operation

Built With

  • Lua

Slash Commands

  • /kph - shows/hides the GUI

Features

Core Features

  • Real-time enemy forces percentage tracking
  • Target percentages to reach before each boss encounter
  • Group notifications for important percentage thresholds
  • Support for all dungeons (Current Season, The War Within, Dragonflight, ...)

Customization

  • Fully customizable text display (font, size, colors)
  • Adjustable position on screen
  • Custom percentage thresholds for each dungeon
  • Per-boss notification settings

User Interface

  • Clean and intuitive options panel
  • Easy-to-navigate dungeon selection tree
  • Quick access to default routes
  • One-click reset to default values

Credits

Localization

I am actually looking for people that want to help with localization of Keystone Percentage Helper, don't hesitate to contact me on X (Twitter)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

PLEASE DON'T FORGET TO PUT THE VERSION OF THE GAME (RETAIL, WOTLK CLASSIC, VANILLA CLASSIC, ...) IN YOUR ISSUE

License

Distributed under the All Rights Reserved License. See LICENSE for more information.