Loot's UI

Hide and show interface frames with macro conditionals, on every flavor of World of Warcraft.

Give a frame a rule like [mod:ctrl][combat] show; hide and Loot's UI keeps it out of the way until you want it. Action bars, unit frames, the minimap, bags, the objective tracker and more, each with its own rule. On top of the game's own conditionals, LootsUI adds a few of its own, so a rule can react to things the macro system has no idea about.

LootsUI was heavily inspired by DinksUI, which showed how well macro conditionals work for driving what your interface shows. It was built to take that idea further, with a set of custom conditions of its own and support for every flavor of the game.

Getting started

1. Type /loots to open the options.
2. Pick a preset from the Presets tab to see it working, or go straight to a tab and write your own rules.
3. Frames with an empty box are left alone.

Presets overwrite the rules in the current profile, so make a profile first if you want to keep what you have. Profiles live in the Profiles tab and can differ per character.

Commands

/lootsui works the same as /loots.

Writing rules

A rule is a list of conditions and what to do when they match.

[condition] show; hide
[condition] hide; show

Several bracket groups in a row mean or, so [mod:ctrl][combat] show; hide matches if either is true. Commas inside one group mean and, so [combat,damaged] needs both. The last part of a rule with no brackets is the fallback, which is why show; hide reads as "show when something above matched, otherwise hide".

Your rule is handed to the game's own macro parser, so anything valid in a macro is valid here, including [mod:alt], [flying], [group:raid], [form:1] and [@target,exists]. The full reference is the macro conditionals documentation, with more background in the macro documentation.

LootsUI conditions

These are added by LootsUI. Mix them with the game's own conditionals freely, use them inside the same brackets, and put no in front of any of them to invert it.

Health

Resources

Resource means whatever your character is running on at that moment, mana, rage, energy, focus or runic power, so one rule covers every class. It follows a druid through its forms, reading energy in cat and mana in caster.

Target

Location

Some things you might expect here are already in the game and need nothing from LootsUI: [stealth], [resting], [mounted], [flying], [indoors], [group:raid] and [form:1] all work as written. For death, [dead] reads your target, so use [@player,dead] for yourself and [@player,nodead] for alive. Prefer these where they exist, since the game evaluates them itself and can hide frames outright.

The Help tab in game lists the same set, generated from what is actually installed, so it is never out of date.

Examples

Fading

Frames can snap or fade. The Fading tab sets which one to use by default and how long a fade takes, and any frame can be set to its own Instant or Fade regardless of the default.

One thing to know: a frame hidden by a fade, or by any rule using a LootsUI condition, goes transparent rather than fully hidden, so it can still catch a mouse click in the space it occupied. Rules built only from the game's own conditionals hide frames outright.

That split is not a preference, it is what the game allows. Only the transparent route can react during a fight, because addons are not permitted to re-register a visibility rule once combat has started.

Fades interrupt cleanly, so a frame caught half way through fading out reverses from where it is rather than starting over.

Supported clients

A frame that does not exist in the client you are playing is greyed out in the options rather than causing errors.

If Questie is installed, its tracker is covered by the Objective Tracker rule alongside the game's own, so one rule handles both.

Credits

Heavily inspired by DinksUI by Duenke, which is where the idea of driving frame visibility with macro conditionals comes from. LootsUI exists to carry that further: custom conditions such as [damaged], [resource:90], [hastarget] and [stealth] that the macro system has no equivalent for, and one addon that runs on Classic Era, Anniversary, Wrath Titan Reforged, Mists Classic and retail alike.