Group O Matic

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

-------------------------------------------
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.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.