Angry Assignments

Angry Assignments

This addon was written by the guild Angry (US-Illidan) to handle assignments during raids. It provides a convenient way to store and share assignments for different bosses, allows editing by multiple people, and is able to display the information to raiders in a configurable format.

Using AA as a raider

First, you'll want to configure a keybinding for the "Toggle Display" function, so you can easily show/hide the on-screen assignments display during raids. It should appear under the section "Angry Assignments" in the game's keybindings menu.

The rest of the important configuration is in the game's Interface menu, Addons tab, where you should now have a menu for "Angry Assignments" (the "/aa" command will also bring up this screen):

  • "Toggle Display" will toggle the on-screen assignments display on and off (can also use "/aa toggle", but likely you'll want to use the keybinding discussed above).
  • "Toggle Lock" will lock/unlock the anchor for the on-screen display (can also use "/aa lock" or a keybinding), so that you can configure its location, direction, and width.
  • In the "Highlight" field, you can set some words that will be highlighted in your on-screen assignments. Separate multiple words with commas or spaces. Typically, you will set this to your name and any short versions of it that are commonly used. If you add the special keyword "Group" into your list of highlight words, then raid groups in the format "G1", "G2", "G3", etc will always be highlighted whenever you are inside that group.
  • You may wish to turn on the "Hide on Combat" option which will automatically hide the on-screen assignments whenever you get into combat. You can always bring them back up during combat by using the keybinding or other methods mentioned above.
  • You can configure the font face, size, color, and outline style that will be used for the on-screen assignments. You can also configure the color used for the words that get highlighted (see above).
  • Permissions section: AA will accept assignments from the raid leader or assistants, but only when you are in an "approved" raid. If the raid is led by an officer in your own guild, it will always be approved. Raids will also be approved if they are led by anyone whose name you add into the "Allow Players" field (separate multiple names with commas or spaces, cross-server name format is also supported). If you turn on the "Allow All" checkbox, then all raids will be approved.
  • The "Reset Position" button can be used to move the assignments display anchor back to its default location, in case it ends up off the edge of your screen.

For initial setup, unlock the on-screen display if necessary (use the "Toggle Lock" button, "/aa lock" command, or the keybinding if you set one for it), and you should now see a red horizontal strip. You can adjust the width of the strip (long lines will be word-wrapped as needed) and place it in whatever location you want. The up/down arrow at the far left of the strip will determine whether the assignments text goes up or down from the location at which you place the strip. When you're done, click the lock on the strip and it will disappear from view. It may be easiest to configure this strip while you're actually in a raid and seeing assignments - although while you're solo, you can also use the edit window (use the "Toggle Window" button, "/aa window" command, or the keybinding if you set one for it) to create a test page, and then hit "Send and Display" to show it to yourself.

During raids, whenever any change in assignments occurs, the new assignments will re-appear on your screen if you had hidden them (along with a noticeable visual indicator). If you selected the auto-hide in combat option, they'll hide when you get into combat, but you can always bring them back up at any time by using the Toggle Display keybinding or other methods. If you re-log or reload your UI during the raid, your addon will pull information from the raid leader to get back in sync (if you are the raid leader yourself, it will use saved data). Upon leaving the raid, the on-screen assignments will go away.

Using AA as a raid leader/assistant

When in a raid, you'll be able to edit and send assignments if you're the raid leader or an assistant and if the raid is, from your perspective, "approved". All raids will be approved if you have "Allow All" turned on, otherwise the raid must be led by an officer from your own guild, or by someone in your "Allowed Players" list. However, just because you are able to edit/send assignments doesn't mean everyone in the raid will accept them. You can use the version check to see who in your raid isn't accepting assignments - they'll be listed as "Not allowing changes".

You will likely want to configure a keybinding for "Toggle Window" in the game keybindings. This brings up the assignments editing window. The window can be scaled up or down via the "Scale" parameter in the configuration menu (or via "/aa scale"). The edit window contains a list of assignment pages you have on the left. When you select one, you'll see the current contents of that page on the right. You can "Add", "Rename", and "Delete" pages via the buttons at the far bottom left. When editing pages, you'll have several buttons of interest:

  • "Accept" will become available after you've begun changing a page. It will save changes to the page and send the updated version to everyone in your raid (replacing whatever version they may have had). "Accept" does not change which page is currently displayed on-screen, but if the page you edited is the one being displayed, everyone will immediately see the new version (and if they had hidden their display, it will re-appear).
  • "Revert" will become available after you've begun changing a page. It will abandon your current edits, going back to the previous version of the page.
  • "Restore" will recall the last version of the current page that you personally edited and accepted. This can be used to get back to your "last good version" if someone else has made undesirable edits to the page in the meantime. Note that if you want to save the restored version on top of the current version of the page, you still need to "Accept" after you "Restore", otherwise nothing really happens. You can "Revert" to abort the restore.
  • "Send and Display" is only available while not actively editing a page. It will send your current version to everyone in your raid (replacing whatever version they may have had) and also make it the current on-screen display. If you're not in a raid, it will display on-screen for you personally, so you can preview it.
  • "Clear Displayed" will remove whatever on-screen display was currently in place, ie: everyone in the raid will now see nothing. It doesn't affect the contents of any pages.

Various special sequences can be used within assignment pages:

  • Raid target icons can be inserted with {rt1} ... {rt8}, or the symbol names: {star}, {circle}, {diamond}, {triangle}, {moon}, {square}, {cross}/{x}, {skull}.
  • {tank}, {healer}, and {dps}/{damage} will insert the group role icons.
  • {bl}/{bloodlust} will insert the Bloodlust icon, {hero}/{heroism} will insert the Heroism icon.
  • {hs}/{healthstone} will insert the Healthstone icon.
  • You can insert any other icon in the game using this syntax: {icon [name]}. For example, {icon spell_holy_sealofprotection}. Icon names can be looked up by going to a spell or item's page on Wowhead and then clicking on the icon.
  • You can use any UI escape sequences, see WoWWiki's page for a full list. You do not need to use double | and \ characters. Also, as an alternative to the typical |cAARRGGBB format for changing color, you can use these special keywords: |cblue, |cgreen, |cred, |cyellow, |corange, |cpink, and |cpurple. As an example, "|credHello|r" would display the word "Hello" in red. Note that you cannot nest colors, the |r sequence always reverts the color back to the normal font color.

If someone else saves edits to a particular page while you are editing that page, you'll receive a pop-up box notifying you of the fact. At that point, you can continue your edits and eventually overwrite their updated version by hitting "Accept", or alternatively you can hit "Revert" which will abandon your own edits, and instead bring up their updated version of the page. (Tip: if you want to merge your changes with theirs, then you could highlight the particular section you were working on, copy it with Ctrl+C, then hit Revert, highlight the same section in their version, and paste your changes on top of it with Ctrl+V).

Individual pages are identified internally with unique IDs. The names seen in the edit window are only used for display purposes, so there can be multiple pages with the same name. Much like an edit, if someone renames a page, that rename is sent out to everyone in the guild who's online at the time (others will get the rename later, whenever that page is next edited or sent). Deletes, however, are only done locally - so if you delete a page, others will still have it. If you've deleted a page, and later on someone else edits it or sends it, you'll get it back again.


The "/aa help" command will list all console commands.

The "/aa version" command (also available from the config menu) will perform a version check. The results of the version check will be broken down into four groups: people running the same version as you, people running a different version from you (their version number will be shown), people who are running AA but aren't accepting assignments in the current raid, and people who aren't running AA. Note that people who aren't in your guild and are running an old pre-1.0 version will appear in the last list, as if they weren't running the addon at all (they wouldn't accept assignments properly in a multi-guild situation anyway).

The "/aa backup" command (also available from the config menu) will store the current version of every page for later "Restore" (similar to if you had just edited every page and made no actual changes).

The "/aa deleteall" command will delete all pages you have stored. This could be used occasionally to clean out old assignment pages that are no longer used, for example, when beginning a new tier. Of course, if others still have those pages, you'll get them back if they edit or send them while you're in a raid with them.

You must login to post a comment. Don't have an account? Register to get one!


Date created
Oct 12, 2013
Last update
Apr 02, 2014
Development stage
  • enUS
BSD License
Curse link
Angry Assignments
Recent files
  • R: v1.1.3 for 5.4.7 Apr 02, 2014
  • R: v1.1.2 for 5.4.2 Mar 05, 2014
  • R: v1.1.1 for 5.4.2 Feb 20, 2014
  • R: v1.1 for 5.4.2 Feb 20, 2014
  • R: v1.0.1 for 5.4.2 Jan 31, 2014