# nugsSuite

**Addons. Elevated.**

One central, minimap button for every nugs addon.

The suite exists because a handful of addons had turned into a handful of minimap
buttons, a handful of slash commands, and a handful of settings to rebuild by hand
on every new character.

---

## What it does

**Launches everything.** One button. Left click opens the hub: a roster of every
nugs addon with its version and an Open button. Right click skips the window
entirely and drops a menu straight to any of them.

**Shows the whole family.** Addons you do not have stay in the list, greyed, with a
line on what they do. If somebody handed you one of these, the rest are not a
secret.

**Folds up the clutter.** One checkbox hides every other nugs minimap button and
leaves this one. Untick it and they all come straight back.

**Moves your settings.** Export every nugs setting you have as a single string.
Paste it to a guildmate, or into another character, and get the same setup back.

---

## Profiles

A profile is a **diff against each addon's defaults**, not a copy of its saved
variables, so the string stays short. Most people change a handful of the hundreds
of values an addon stores.

**Importing replaces, it does not blend.** The addon is reset to its defaults and
the profile's choices are laid on top, so you land in exactly the sender's setup
rather than a hybrid of theirs and yours. Your current settings are backed up
automatically beforehand, and one button puts them back.

Things that are stored as settings but are not really settings — measured cooldown
caches, where your minimap button happens to sit, first-launch prompt answers — are
never exported, and an incoming profile can never clear them.

**On safety:** import strings come from other players, so the reader is a
hand-written parser rather than `loadstring`. It accepts only the few value types a
profile can contain and rejects everything else, so a hostile string can at worst
fail to load. A checksum catches a half-copied paste before it is merged into your
settings rather than after.

---

## It is never required

No nugs addon depends on the suite. Every one of them behaves exactly the same
without it. Install the suite only if you run more than one and would rather have
them in one place — and removing it changes nothing about the others.

There are no external libraries and no dependencies of any kind.

---

## Commands

| Command | |
|---|---|
| `/nugs` | open the hub |
| `/nugs list` | print every nugs addon and its version |
| `/nugs profile` | open the hub on the profile tab |
| `/nugs castbars` | open an addon by name — partial names work |
| `/nugs minimap` | show or hide the minimap button |
| `/nugs help` | the full list |

---

## The family

- **nugsRaidReady** — raid addon, consumable and character readiness checks
- **nugsCastBars** — cast bars for you, your target, focus, pet and bosses
- **nugsComboBar** — your class resource drawn as configurable pips
- **nugsCooldownPulse** — pulses an icon the moment a cooldown comes back up
- **nugsAuras** — free-floating buff and debuff groups you place yourself *(coming soon)*

---

## About nugs

I am a 22 year WoW veteran, retail almost exclusively, with a real love and passion
for the game. I have been a fan of addons since the early days and have watched
great ones come and go — some because the developer stopped, others because
Blizzard's design closed the door on them. Either way, they have always felt like a
core necessity to the game.

Some of them still miss something, though. A finesse. A quality finish. The sense
that you understand every decision you are making while you use it. These are built
the way I would want them built: limited to no dependencies, a consistent look, and
each window doing its job.

It is not that similar addons do not exist. Maybe they just were not for me. I hope
you enjoy the suite, and whichever of the addons you have chosen to use.

---

## Support

Bugs, requests and questions: the comments here, or Discord at **nug.s**.