Raid Sort

Paste a raid setup and Raid Sort puts everyone in the raid into their groups, then hands out the raid roles: leader, assists, master looter, main tanks, main assists and raid marks.

Made for WoW Forever; works on Classic Era too.

Quick start

1. Plan the raid in Guild Assistant: open the event's Setup tab and press Export for addon, then Copy. (Or write a setup by hand, see The setup.)
2. In game, type /raidsort and press Upload Config.
3. Paste the setup and press Save.
4. Once everyone is in the raid, press Sort.

The setup stays loaded until you close the game or upload another one. Nothing is saved between sessions.

Commands

sort and invite open the upload window when no setup is loaded.

The windows

Raid Sort, with no setup loaded:

• Upload Config: opens the upload window.
• Close.

Raid Sort (Config Loaded), once a setup is loaded. It shows the event's name and how many groups and players the setup has.

• Re-upload Config: opens the upload window with the current setup in it, to change or replace.
• Sort: sorts the raid.
• Close.

Upload window: paste the setup into the text box.

• Save: loads it. If something is wrong with it, a red line under the box says what, and nothing is loaded.
• Close: goes back without changing anything.

Drag a window by its title bar. Escape closes it.

Sorting

Press Sort (or type /raidsort sort). You need to be the raid leader or an assistant, out of combat.

• Everyone in the setup goes to their group. Moving players takes the game a moment, so Raid Sort moves them in rounds and checks the raid after each one, until everyone is in place.
• Full groups are handled: players are swapped.
• People in the raid who aren't in the setup stay in their group if it has room. Otherwise they move to the free places, filling from group 8 back.
• Then it hands out the raid roles, and says in chat:
  • "Raid sorted."
  • who in the setup isn't in the raid;
  • who in the raid isn't in the setup;
  • anything it couldn't set (see below).

Raid roles

Roles are only set for people who are in the raid, and only added: Raid Sort never takes assist, a main tank or a mark away from anyone.

If you're an assistant, Raid Sort sorts the raid and sets what it can, then lists what only the leader can set. WoW Forever may not have master loot. If it doesn't, Raid Sort says "Couldn't set master loot: this game doesn't seem to have it" and carries on.

Inviting

/raidsort invite invites everyone in the setup who isn't in your group. A party only holds 5, so it invites 4 first. When someone joins, it turns the party into a raid (if you're the leader) and invites the rest. You need to be the leader or an assistant if you're already in a group.

The setup

A setup is up to 8 groups of up to 5 players. Each player is written as their name:

{
  { "Dark Shivan", "Wwolf Test", "Tearyn" },   -- Group 1
  { "Some Name", "Other Name" },               -- Group 2
}

Leave a group empty with {}. Names are matched ignoring upper/lower case, spaces and dashes ("Dark Shivan" is "dark-shivan"). If no name matches exactly, a name also matches by its first word when only one player has that first word.

Adding raid roles

Write a player as { name = "…", … } to give them roles:

{
  { "Dark Shivan", { name = "Wwolf Test", mainTank = true, mark = "skull" } },
  { { name = "Some Name", assist = true }, "Other Name" },
}

Or list roles for the whole setup, after the groups:

{
  { "Dark Shivan", "Wwolf Test" },
  { "Some Name", "Other Name" },
  leader = "Dark Shivan",
  masterLooter = "Some Name",
  assists = { "Wwolf Test", "Other Name" },
  mainTanks = { "Wwolf Test" },
}

Everyone named in a role must be in one of the groups.

event = "Molten Core" names the setup; it's shown in the window. Guild Assistant's export adds it, along with a comment line at the top (-- …), which is fine to keep.

What Guild Assistant exports

The event's groups (not the bench), the leader, the master looter and the assists, as long as they're in a group. The export window says if anything was left out.

When Save says something is wrong

Quotes pasted from documents or chat (“ ”) are fine. The pasted text can only describe a setup: it can't run anything.