Raid Loot Suite

RAID LOOT SUITE v2.6.3
Loot history, soft reserves, SR / MS / OS rolls, loot council and raid loot tables (WoW 3.3.5a).
By Saranwrap

INSTALL
  1. Close the game.
  2. Copy the "RaidLootSuite" folder into <WoW folder>\Interface\AddOns\ and keep its name:
     the addon loads from it.
  3. Start the game.

  UPDATING
    Close the game and DELETE THE OLD "RaidLootSuite" FOLDER COMPLETELY, then copy in the new
    one. Also delete any "Raid-loot-suite-main" folder from an older download, so only one copy
    is installed. Copying over the old folder can keep old files (images in particular),
    and the game only loads new files after a full restart, not after /reload.

QUICK START
  /rls           open / close the window
  Minimap button: left-click open / close, shift-click History, right-click menu.
  Settings: button in the title bar (press Back to return).
  Try everything alone first: Settings > Test mode (fake raiders, nothing sent to chat).

THE WINDOW
  Tabs: Loot Session | Soft Reserves | Loot Council | History | Loot Tables
  Drag the title bar to move it, drag the bottom-right corner to resize it
  (double-click the corner for the default size). /rls opens the last tab used.
  Hover any item in the game to see who soft reserved it.
  Most rows have a right-click menu with quick actions.

LOOT SESSION
  Queue (left)
  - As master looter, opening the boss corpse/chest adds its items to the queue and posts
    "Loot from <Boss>: [item] [item]..." in raid chat (both can be turned off in Settings).
  - Add any item by hand: shift-click it into the box, or type its ID.
  - Status per item: Waiting, Rolling, Council vote, Tie, No rolls, Awarded, Delivered,
    Disenchant, Skipped. "SR: names" shows under soft reserved items.
  - Right-click an item: roll, council, end roll, disenchant, skip, back to waiting,
    link in chat, remove, Give to > Group 1-8 > player.
  - Clear finished: removes awarded, delivered, disenchanted and skipped items.

  Selected item (right)
  Roll / Council     start a roll or a council vote
  End now            end the roll and pick the winner
  Award              give it to the selected player (or right-click a player)
  Disenchant         give it to the disenchanter, saved as DE
  Skip / Remove      skip it / remove it from the queue
  Roll timer         seconds for the next roll (5-120, default 10), or /rls timer 30

  Rolls
  - MS = /roll 100, OS = /roll 99, SR = /roll 100. Any MS roll beats any OS roll.
  - Soft reserved by players in the raid: only they roll. One SR'er: they get it.
  - The timer ends the roll, with a 5-4-3-2-1 countdown in chat. The winner is announced
    and gets the item with Master Loot when the loot window is open.
  - Ties reroll automatically between the tied players. Only the first roll counts.
  - Nobody rolled and a disenchanter is set: it goes to the disenchanter.
  - Status turns to Delivered when the winner receives the item.

  Raiders
  - With Raid Loot Suite: a popup with MS / OS / Pass. The buttons do the /roll for them
    (also in a council vote), so everybody sees the rolls in chat.
  - Without it: they read the raid chat and type /roll 100 or /roll 99 (council: whisper
    ms / os / pass, or roll). Their rolls count the same way.

  Loot council
  - Raiders answer with the popup, a whisper (ms / os / pass) or a roll.
  - Council members see the answers and click Vote (click again to take it back).
    Hover a player to see who voted for them. You select the player and press Award.
  - Council members need Raid Loot Suite to vote.

SOFT RESERVES
  - Views: By item (who reserved it, queue status / winner), By player (their reserves),
    Edit list (one line per reserve: click to edit, x to delete).
  - Search box and "Only my raid" filter. Grey = not in your raid, (won) = already got it.
  - Add: player + item (shift-click, item ID or exact name), then Add.
  - Import: softres.it CSV export (with or without its header line), or one per line:
      Player: [item]     Player - Item name     Player, 49623
  - Players can whisper you: sr [item] (save), sr (check), sr clear (remove).
  - Announce: posts the list in raid chat, one line per item.

LOOT COUNCIL
  Tick who can vote (you are always on it), "Leader + assists" in one click, or add a name
  of someone not in the raid yet. Changes apply right away, also to a vote in progress.

HISTORY
  Records item, boss, winner, date and time, raid and size/difficulty.
  - Winners come from "<player> receives loot" lines. Drops seen in the loot window show
    "Pending..." until someone loots them.
  - Default: epic and better, inside raids, trash included. Emblems, Abyss Crystals and
    Frozen Orbs are ignored (Settings > History & window).
  - Search, Raid and Period filters, click a column title to sort.
  - Row: hover = tooltip, shift-click = link, ctrl-click = try on,
    right-click = edit winner / boss / note, mark as MS / OS / SR / DE, delete.
  - Tag: left-click cycles none > MS > OS > SR > DE, right-click adds a note.
    Next to MS / OS: LC = awarded by the loot council, SR = went to a player who soft
    reserved it (set automatically, or from the right-click menu).
  - Delete... (bottom right): delete part of the history without erasing it all: what the
    filters show, by raid, by raid night (raid + size + date), by day, older than N days,
    pending drops (no winner), test mode entries, or everything. Each asks first and shows
    how many entries it deletes. Deleted drops are not brought back by a sync.
    "Duplicates" removes drops recorded twice (the copy changed last is kept).
  - Sync column (tick box at the start of each row, ticked by default): untick a drop to
    keep it out of syncs; it stays only in your history.
  - Sync: gets the loot other raid members recorded in the last 7 days and fills in what
    you missed (disconnected, too far away). They need Raid Loot Suite. Auto sync also runs
    it once after a login, a /reload or when you join a raid (turn it off in Settings >
    History & window).
    A drop someone changed (winner, MS / OS, LC / SR, note, boss) is recognised as the same
    drop, not added twice: the most recent change wins. Both players need version 2.6.1 or
    later for a changed winner to be recognised.
  - Export: CSV (Excel / Google Sheets), plain text or Discord (what is shown, filters apply).
  - Import: Excel / Google Sheets cells with the header row, CSV, this addon's exports, or
    lines like  Item -> Player  /  Boss | Item -> Player MS
  - Outside the game: Tools\savedvariables_to_csv.py makes a CSV from the saved file (Python 3).

LOOT TABLES
  Every raid boss with its loot in 10 / 25 (and 10 / 25 heroic where the raid has it),
  plus "Trash mobs" (epics and better) and "Patterns & recipes".
  - Each item: type, item level, drop chance. HM = hard mode only.
    A (blue) / H (red) = Alliance / Horde only.
  - Click a column title to sort (click again to reverse).
  - Search box: an item or a type ("trinket", "plate", "pattern") in the whole raid.
  - Right-click an item: link, add to the loot queue, add a soft reserve.
  Drop chances are worked out from the AzerothCore world database (the core ChromieCraft
  runs on). The server can change its loot, so treat them as a guide.

SETTINGS
  Loot session: test mode, roll timer, announce channels (roll start, winners, countdown),
  auto-queue, post boss loot in raid chat, give with Master Loot, countdown, whisper SR,
  whisper MS / OS, disenchanter (+ give no-roll items to the disenchanter), council members.
  History & window: minimum quality, raids only, trash drops, chat line when loot is
  recorded, minimap button, auto sync, window opacity, links.
  Raid warning needs leader or assist, otherwise raid chat is used.

TEST MODE  (Settings, minimap menu or /rls test)
  Six fake raiders, a few test items from your gear and ready-made soft reserves.
  Fake raiders roll, answer the council and vote. "Fake whisper" in Soft Reserves tests
  the whisper commands. Nothing is sent to chat, Master Loot is not used. Awards go into
  the history as "Test Boss" (you are asked if you want to keep them when the test stops).

COMMANDS
  /rls                          open / close the window
  /rls session | sr | council   open a tab
  /rls history | tables         open a tab
  /rls queue [item]             add an item to the loot queue
  /rls timer <seconds>          roll timer (5-120)
  /rls sync                     get the loot history recorded by the raid
  /rls export | import          export / import the history
  /rls options                  settings
  /rls add [item] Player [MS|OS] Boss   add a history entry by hand
  /rls minimap                  show / hide the minimap button
  /rls test                     test mode on / off
  /rls testentry                add a sample entry to the history
  /rls delete                   delete part of the history (by raid, raid night, day...)
  /rls clear                    delete all history
  /rls help                     list the commands in chat
  /raidloot works too.

SAVED DATA
  WTF\Account\<ACCOUNT>\SavedVariables\RaidLootSuite.lua (shared by your characters).
  Written on logout, /reload or exit; a crash loses that session's changes.
  A roll or vote in progress does not survive a /reload.

LINKS
  GitHub:   https://github.com/saranwrap04/Raid-loot-suite
  Warperia: https://warperia.com/addon-wotlk/raid-loot-suite/