WeakAuras2

World of Warcraft addon that provides a powerful framework to display customizable graphics on your screen.

1,389

330

1,389

Quick Overview

WeakAuras2 is a powerful and flexible addon for World of Warcraft that allows players to create custom visual displays and notifications. It enables users to track buffs, debuffs, cooldowns, and various game events, enhancing the player's interface and gameplay experience.

Pros

Highly customizable, allowing for a wide range of visual effects and triggers
Large community with extensive sharing of custom auras
Regular updates and maintenance to keep up with WoW patches
Extensive documentation and support resources

Cons

Steep learning curve for creating complex auras
Can be resource-intensive if too many auras are active
Potential for information overload if not used judiciously
Requires some coding knowledge for advanced customization

Code Examples

Creating a simple aura to track a buff:

WeakAuras.Create({
    name = "My Buff Tracker",
    trigger = {
        type = "aura",
        spellIds = {12345},
        unit = "player",
    },
    load = {
        class = "MAGE",
    },
    display = {
        type = "icon",
    },
})

Setting up a cooldown tracker:

WeakAuras.Create({
    name = "Spell Cooldown",
    trigger = {
        type = "status",
        event = "Cooldown Progress (Spell)",
        spellName = "Fireball",
    },
    display = {
        type = "progress",
    },
})

Creating a custom text display:

WeakAuras.Create({
    name = "Health Percentage",
    trigger = {
        type = "status",
        event = "Health",
        unit = "player",
    },
    display = {
        type = "text",
        text_color = {1, 0, 0, 1},
    },
    text = function(trigger)
        return string.format("%.1f%%", trigger[2])
    end,
})

Getting Started

Install WeakAuras2 addon through your preferred WoW addon manager.
In-game, type /wa to open the WeakAuras interface.
Click "New" to create a new aura.
Choose a trigger type and configure the display options.
Test your aura and adjust as needed.
For more complex auras, refer to the official documentation and community resources.

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

WeakAuras

Logo

WeakAuras is a powerful and flexible framework that allows the display of highly customizable graphics on World of Warcraft's user interface to indicate buffs, debuffs, and other relevant information. This addon was created to be a lightweight replacement for Power Auras but has since introduced more functionalities while remaining efficient and easy to use.

Features

An intuitive and powerful configuration interface
Custom textures including all textures from Power Auras and Blizzard's spell alerts
Progress bars and textures that show the exact duration of auras
Displays based on auras, health, power (mana, rage, soul shards, holy power, etc.), cooldowns, combat events, runes, totems, items, and many other triggers
Preset and user-defined animations
Custom side-effects such as chat announcements or sounds
Grouping, which allows multiple displays to be positioned and configured at the same time
CPU optimizations such as conditional loading/unloading of displays, modularity, and prevention of full aura scanning
Powerful customization options, such as animation paths, on-show/on-hide code, and custom triggers, for Lua-savvy users

Quick Start

To open the options window, type /wa or /weakauras into your chat and hit enter or use the minimap icon.

Extensions

WeakAuras Companion: This application adds the missing link between Wago.io and the World of Warcraft addon, enabling you to update your auras in a convenient fashion.
WeakAuras_StopMotion: This addon adds a new region type to WeakAuras that allows for stop motion animations. Stop Motion textures contain each frame of the animation as a separate image. The addon ships with a number of animations and it supports custom textures.
SharedMedia for more bar textures.
SharedMediaAdditionalFonts for more fonts.
ColorPickerPlus for a better version of the WoW color picker that includes class color templates and a copy and paste function.

Documentation

For in-depth documentation, see the wiki page.

Examples

For some examples of what WeakAuras can do, take a look at wago.io where tons of people upload their creations and even feature complete interfaces utilizing WeakAuras!

Problems

Please see the wiki page.
If you've discovered something that's clearly wrong, or if you get an error, please create a ticket.
You're a programmer yourself and want to contribute? Check out our contributing guidelines to get started!
Feel free to join our Discord Community to talk, get help and discuss everything WeakAuras!

Support

If you want to help out with development without providing code yourself, you can always donate to the WeakAuras project maintainers using PayPal or become a Patreon:

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot