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 spaces or commas. Typically, you will set this to your name and any short versions of it that may appear in assignments. If you also add the special keyword "Group" into your list of highlight words, then 5-player raid groups in the format "G1", "G2", "G3", etc will be highlighted whenever you are inside that group at the time.
- 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).
- If you turn on the "Display Backdrop" option, then a background will be displayed behind your current on-screen assignments. You can then configure the color and transparency of this backdrop with the "Backdrop Color" color picker.
- You can use the "Update Notification Color" color picker to select the color of the glow graphic that is momentarily displayed whenever currently-displayed assignments are edited.
- You can configure the font face, size, color, outline style, and line spacing that will be used for the on-screen assignments. You can also configure the color used for words that get highlighted (see "Highlight" section 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 spaces or commas, cross-server names are 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 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 grows up or down from the strip location. When you're done, click the lock on the strip and it will disappear. It may be easiest to configure this strip while you're actually in a raid and seeing assignments - although while 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), create a test page if necessary, then hit "Send and Display" to show a page to yourself for testing purposes.
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 in your 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 perform a 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 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" (or you could also "Revert" to abort the restore).
- "Output" will send the current page to whatever the appropriate com line is for your current group (party, raid, or instance). Can be used as a quick way to allow people not running AA to see the assignment. All AA curly brace sequences (see below for more info on those) will be converted to text equivalents, with the exception of , which will be stripped. Color escape codes (|c...|r) will also be stripped.
- "Send and Display" is only available while not actively editing a page. It will send your current version of the page 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.
- "Clear" 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 ... , or the symbol names: , , , , , , /, .
- , , and / will insert the group role icons.
- / will insert the Bloodlust icon, / will insert the Heroism icon.
- / will insert the Healthstone icon.
- , , , etc will display the icons of the named class.
- You can insert any other icon in the game using this syntax: {icon [name/spellID]}. For example, {icon spell_holy_sealofprotection} or {icon 774}. If you use a spellID number, it'll use the icon associated with that spell. Icon names can be looked up by going to a spell or item's page on Wowhead and then clicking on the icon.
- Similar to the above, , , and will insert "links" to the corresponding spells, bosses, and dungeon journal entries. For example, {spell 155080}. These links will display in AA's display window, but won't be clickable, and thus will generally be more useful when using the "Output" button.
- 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. You can also use |cCLASSNAME, for example |cshaman or |cdruid, to get that class's color. 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. Also note that if you put a player or group name immediately after a UI escape sequence (ie: |rStingray), highlighting of the name won't work properly - you need some space or punctuation inbetween.
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 could be multiple pages with the same name. Much like an edit, if someone renames a page, that rename is sent out to the current raid - people not in the raid at the time would get that 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 "Add Category" button allows you to add categories to store your pages in. Categories are completely local to you, for your own organizational convenience, and won't be visible to anyone else. You could, as an example, create a "Hellfire Citadel" category then move all your Hellfire Citadel-related pages under that category. Right-click on a page's name to bring up a menu which will let you select or deselect your categorization of that page. You can also categorize a category under another category, to create nested categories. Right-click on a category's name to delete or rename that category. If you delete a category with pages, those pages will be retained, but become uncategorized.
Miscellaneous
The "/aa help" command will list all console commands.
The "/aa send <name>" command will send and display the named page. Useful if you are doing assignments for a fight in separate sections (ie P1, P2, P3, etc) and want to macro the display of the different pages. Note that it is possible to have multiple pages with the same name (as described above), in which case this command will just pick one of them.
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.
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 raid 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.
When I do a version check it even says that I personally don't have the addon installed (which I obviously do to make the check in the first place :P).
Hopefully it can all be sorted out! One of my other raiders could send my AA that I had created from a few weeks back and sent to him! Was fine on my raid on Monday!
It might have something to do with BigWigs/DBM/WA2 or Pawn. Those four addons had updates today/in the recent past as well, which might cause the bug. AA worked for some in our raid and at least one had not yet updated the above mentioned addons.
And FYI the version check shows, that even I do not have AA installed even though I used the version check of AA itself, hopefully this gives some more insight into the issue.
It's pretty clear that the addon communication channel has totally stopped working for some people using the addon. I am trying look into reasons why it would, but currently I have no idea what changed to cause it to happen.
If someone that is having the issue, it would be useful if they could test with all other addons disabled. To rule out it being caused by another addon.
Good suggestion thecurseaccount - When I turned off WA2 - It returned to the usual state of saying I had the addon but when WA2 is enabled it claims I do not have the addon on the version check!
I have a problem, when I use your addon, after a very short period, all of my bars break. Extra bars dissapear, chat window, the background of every window you open (like skills / stats / bags/ etc). I obviously can't use the addon like this, haven't found anyone with the same issue either. Any help would be greatly appreciated
I am also having this issue, and my guild use this addon so it'd be great if there was a fix. I have elvUI and it messes up windows/popups, chat, dbm timers and tmw. It's unplayable...
i see alot of people using this addon while progresssing through M NH. I have recently downloaded the addon, made some notes and realized that once i entered raid - it disappeared. i came back to this page and read about the toggle display keybind in the interface keybinding option. i do see Angry Assignments but there is no option to allow me to keybind it.
any help would be very much appreciated.
btw, i'm also trying to figure out how to send my notes to others in my raid team that have recently downloaded this addon. please help.
thank you,
Depending on how you configured the permissions in AA, and your position in the raid (leader/assistant/neither), and your rank in your own guild (officer or not), you may not have access to display a page while in raid, even just to yourself. You should read the "Permissions section" bit in the documentation of AA.
If you just want to display notes for yourself personally, not tied to anyone else, you should download a separate, but similar, addon called Angry Notes.
Rest of your questions should all be answered in the documentation really.
Awesome addon. Any chance you can add a "Display on Target" option so that the list changes based on target. Very useful for boss or pet battle notes imo.
Since 7.1 whenever I click toggle window, the window is blown up to huge proportions, have a fix for it?
Try running "/aa scale 1". There is a scale setting that effects the size of that window, that you could set higher by mistake.
There's an error with version checking, it tells you that your AA is outdated if there's anyone in the group that has an older version. I have 1.8.7 installed and every time I get into a group with guildie with 1.8.5, I see this message.
Thanks for the report, I will get a fix out for it soon.
Hi trying to install using Curse client but I'm not very computer savvy, the following message keeps appearing---
There is no application set to open the URL curse://mods.curse.com/wow-addons/angry-assignments/2350265/download-client?v3=2850969743&p2=2448548542&x2=9a15f42d&verify=53635682&file-id=2350265.
Can you advise . Have downloaded separately but don't know where to install into thx
Love the addon. Great work.
Are there any plans to make editing the notes easier? It's really difficult to change the notes around on the fly when you swap people in and out of the raid, or when you change your strategy so much during progression.
It would be nice to have clickable names/colors/spells/markers/font-size, kind of like how Excorsus does it without having to mess with the coding to format it just right.
Thanks.
The Backdrop function wont work in 7.1, you can activate it/change color but no Backdrop is displayed.
I just released a new version (1.8.5) that fixes this.
AA now has a huge blank space between the top bar and the actual text.
I just released an update (v1.8.4) that fixes this issue. Thanks for the report.