Group O Matic is a tool for raid leaders. It does the following:
*Gives you the ability to save and restore raid member positions
*Gives you an auto-arrange command, which tries to find the best group arrangement based on class/spec, and then automatically arranges the raid to match it.
*Adds slash commands to swap raid members' groups (for macros to move people on the fly)
*Auto-arrange template for AB/EotS which will move people at the same node into the same group.
If you want to configure GOM while not in a raid, use /gom active
If you want to use GOM as a simple raid inviter, see: http://www.wowinterface.com/downloads/info14018-GOMRaidStarter.html
-------------------------------------------
GOM has more settings than you would normally find in an addon of this type, but it also works "out of the box." That is, it will work as well as/better than any other raid config addon without changing anything, and will give you a simple save/restore/auto window when you open the raid UI.
If you do want to manipulate the way the auto-arrange and restore functions work then read on for some basic documentation. If you have more specific questions just post them in the comments here.
-------------------------------------------
* Macro Commands:
/rs Name1 Name2
(Swaps two people)
/rgs Group#1 Group#2
(Swaps two groups with each other)
/rm Name Group#
(Moves Name into Group#)
/rm Name @Group#
(Moves Name into Group# even if Group# is already full, in which case it swaps a random person into Name's old group)
/rm Name1 Name2
(Moves Name1 into the same group as Name2)
/rm Name1 @Name2
(Moves Name1 into the same group as Name2 even if Name2's group is already full, in which case it swaps a random person into Name1's old group)
Names can be replaced with !p, !t or !f for player, target or focus, i.e...
/rs !p !t would swap you with your target.
/rm !p @!f would move you into the same group as your focus, even if that group is full.
-------------------------------------------
*Raid Save and Restore:
Restore will try to get the current raid as close as possible to the saved raid. By default, if there are people missing they will be ignored, and if there are extra people they will be auto-arranged -- these settings can be changed in the "Manage Saves / Restore Options" pane.
*Raid Restore Options:
As mentioned above, there are several restore modes that you can choose from. The options are in the form Part1-Part2 where Part1 is what to do with missing players, and Part2 is what to do with new players...
Part1 can be:
--Dumb: Players from the saved raid who are absent from the current raid are ignored.
--Smart: Players from the saved raid who are absent from the current raid are compared to new players who aren't in the saved raid. Any new players that have the same roles as the absent players are filled into their spots.
--Armchair: Same as "Smart" but substitutions are based on class rather than roles.
Part2 can be:
--Merge: New players (who aren't substituted for a missing player) are auto-arranged based on the currently selected template.
--Separate: New players (who aren't substituted for a missing player) are pushed into the lower groups for manual arrangement.
-------------------------------------------
*Auto Arrange:
Automatically sets up the raid, taking into consideration class and talent spec, based on either one of the built-in rulesets or a user-created template. Anyone whose talents are unknown will have defaults filled in by class.
*Talent scanning/caching:
GOM saves a list of the roles of players whose talents it has scanned. Scanning happens when you click auto-arrange, or slowly over time (while not in combat) if you have checked "Continuous Scan" -- Addons can only scan talents of players within ~40 yards, so it's best to just leave "Continuous Scan" on all the time, so that your database of roles is current (assuming that you are using features that take talents into account).
Also, GOM will only cache players' talents who are in their primary spec. It will still read and use secondary talents if it has directly confirmed that a player is using them during the current raid. But, if it hasn't scanned a player during the current raid, it will assume that they are using their primary talents. You can change this behavior, so that it will assume they are using the last spec it saw them using, with /gom secondarytalents
*Auto Arrange Templates:
GOM supports user-created templates to modify how the auto-arranger behaves. If you want to create one, see the EZ Templates tab (or for advanced templates, templates.lua
*AB/EotS template:
Note that using the auto-arrange with this template will probably only be useful to you if you're in an AB/EotS game that is in-progress. It scans all raid members' current sub-zone ("mine", "stables", etc) and groups people at the same place together. Remember that GOM can't work while *you* the raid leader are in combat, but it doesn't matter if other people are, and you can macro /gom auto and hit it when you have a few seconds OOC.
-------------------------------------------
*Group Exclusions:
You can exclude any/all groups from being saved/restored/arranged. Excluded groups will not be modified at all by the addon (the exception is the AB/EotS template, which intentionally ignores this setting).
*Dead/Lowbie/Offline player handling:
GOM can optionally be configured (in the Extras menu) to push dead, offline and/or lowbie (below the level of your choice) players into the lower groups. This works for auto-arranges normally. For raid restores, it only applies to players who would otherwise be "merged" (i.e. players that are not in the save, but are in the current raid). If you have a lowbie player that you accidentally saved into a raid, remember that you can edit them out in the "raid options" Extras menu. You can also exclude groups from being saved, if you want.
*MVPs:
You can create a list of MVPs which the auto-arrange will look at first when arranging groups. Class and spec are valued over MVP status, but among players with the same class and spec, MVPs will be placed in the top groups first.
*Throttling:
You can change how many requests GOM sends to the server at a time while moving groups around. Setting this to a lower number can resolve issues that happen to some people due to high latency connections or other addons. The default setting almost always works fine; but if you're having problems while using GOM, this is something you can do to troubleshoot it.
2.6.5 (2-8-2010):
-Works around a Bliz bug causing the "talent interpreter outdated" warnings.
2.6.1 (12-28-09):
-Minor GUI bug fix.
-Fix for "attempt to index nil" error which was probably quite common but never happened for me :\
-Allows changing the output chatframe. No GUI for this yet. Ask me if you want to use it before then.
2.6.0 (12-8-09):
-toc increase to 30300
-Fixed a bug which caused starting an auto-arrange or raid restore via slash command to sometimes not work if "continuous scan" was active.
-Added extras pane for automatic actions as the raid is formed:
--Optionally automatically auto-arrange when the number of players hits 10 and/or 25 and/or 40 members for the first time during the current raid.
--Optionally automatically move raid members to match a saved raid as they are added.
--Note: You can use these options and GOM Raid Starter at the same time; if they conflict, GOM's setting will win out over GOM_RS.
2.5.6 (8-4-09):
-Updated for WoW 3.2
-Various minor changes/fixes.
2.5.5 (7-15-09):
-Fixed a minor, harmless bug that I introduced in 2.5.4. GG testing. >.>
2.5.4 (7-14-09):
-Re-enabled the ability to toggle on debugging output (/gom debug)
-The "bad template syntax," etc. errors (anything that would be output because of a badly written 3rd party template) that were being output as debugging text are now output properly as "error" text.
-A couple of other things that should be output even if "Silence Console Output" is checked are now considered errors and therefore will ignore that checkbox.
-Added some smart debugging output in the case of a talent scan failing. This system is vulnerable to latency and addon conflicts.
2.5.3 (7-13-09):
-Fixed a fatal error that occured when the first auto-arrange or raid restore done after loading GOM was started while GOM was in the middle of a "Continuous Scan" which had been delayed for some reason (latency, addon conflict, etc.)
2.5.2 (6-22-09):
-Misc. minor fixes/changes.
-Fixed a (harmless) bug that was generating a Lua error on new characters...oops.
2.5.1 (6-5-09):
-Improved memory management substantially.
-Added about 2/3 of the "BUFFER" roles back in that I removed in some of the earlier 2.x versions.
-Played around with the default PvE template a bit.
--If you like/dislike the way this changes how auto-arranges act, let me know. :)
2.5 (5-30-09):
-Added options to push dead/lowbie/offline players to the lower groups...see the wowi description page (towards the bottom) for more info.
-Tweaked a couple things so that auto-arranges/restores go faster in certain (rare) situations where they were going pretty slow.
-If GOM is being run for the first time on a character, "Continuous Scan" will now default to being on.
-Changed some text around.
2.4 (5-8-09):
-Fixed the 3.1 incompatability that was causing neverending raid arranges.
2.3.1 (5-1-09):
-Reduced the time between raid moves back down to the original 0.3 seconds.
-Added some smarter code to try to deal with the infinite looping problem.
2.3 (4-30-09):
-Increased the time between raid moves to compensate for what seems to be a really stupid design change in GetRaidRosterInfo. >:0
--Hopefully that will fix the infinite looping problem.
-Updated the talent scanner for 3.1.
-The scanner will read and use but NOT cache the talents of players who are using their secondary spec, unless you tell it to (see note on the wowi page)
-Minor text updates, etc.
2.2 (2-24-09):
(Only updates the /rm command, you don't need this if you don't use /rm)
- /rm can now take an @ in front of its second argument, which forces it to move the player to that group even if the group is full. It will pick a random member to swap to name1's group in this case.
--i.e. /rm Jim @1 will move Jim to group 1 even if it is full, and if it is full will move someone from g1 to Jim's group.
- /rm can now take a name (or !p !t or !f, same as the other <name> arguments) as its second argument. If you pass a name (or wildcard) to the second argument, it will move name1 into the same group as that person. If the group is full, it will do nothing UNLESS you put an @ in front of the entire argument in which case it will swap name1 with a random person from name2's group (other than name2 of course)
-- i.e. /rm !p @!t will move you into the same group as your target, even if that group is full
2.1.3 (2-10-08)
-Updated the talent interpreter (lol).
-Optimized some frame creation code/memory management.
2.1.2 (11-2-08):
-Possible bugfix for GOM ignoring the "Show GUI" toggle if the UI is loaded while the player is in a raid.
2.1.1 (10-25-08):
-GOM now has a pretty good chance of not tainting the portrait focus menu-items each time it loads
--i.e. UIDropDownMenu_Initialize recoding so that it isn't called until well after the UI loads
--but, it still can sometimes...like if you try to do a restore/save really soon after load
--it's really blizzard's fault which is why so many addons do this post-3.0
-Also...fixed a typo in the error text for bad argument syntax to the decursewhich scripted template command (which no one will *ever* see let alone care about a typo in it...but meh)
2.1 (10-17-08):
-Various bug fixes
-GOM now keeps a list of players' classes independant of its list of specs, this list is updated regardless of the "scan" settings and stores the class of everyone that you join a raid with...this list is used for the following two changes:
-Added class info to the saved raid edit screen
-Added "Armchair-xxx" restore modes, which act like "Smart-xxx" except that they match by class rather than spec if the exact player isn't in the current raid
2.0 (10-14-08):
**General:
-Updated for WoW 3.0
-GOM's buttons are blue now ^-^
-Removed all use of the addon channel (ping/update checks/syncing talents with other raid members running GOM) which probably no one used, and which used a small amount of CPU time even when idle.
**Slash Commands:
-/rs and /rm can now take !t !p or !f (target/player/focus) instead of a name.
--i.e. /raidswap !t !p would swap you with your target
**Auto-Arrange:
-Removed both built-in PvE Auto Arrange Templates
-Added a new "Default PvE" template (WIP, but raid arrangement is a much simpler problem in WoW 3.x)
-The "Continuous Scan" option will no longer prevent you from starting a restore/auto-arrange while it is scanning
-EZ Template class/spec menus can now be localized
--enUS/default localization means that those menus are more natural now in English as well("Spell DPS buffer" as opposed to "SPELL_BUFFER", etc.)
-Cached player roles/specs from version 1.x will be deleted, due to the number of changes from WoW 2.x
**Scripted templates:
-Anchors for templates: go, etc. are now able to take an anchor name in place of a line number
-Added "anchor anchorName" command for templates
-Updated special talents, added MANA_BATTERY for surv hunters w/ hunting party, etc.
-Several *_BUFFER roles have been removed because those talents/abilities now affect the whole raid
-Deathknight talent interpretation added
-When trying to find a matching player for a request by an auto-arrange template, GOM will now prioritize players with a different ROLE than an optional prefSpec (but who aren't applicable to be limited by a limits line) over players who are limited by an optional limits line -- before, these two conditions had equal weight
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...