Simple Loot Council — Feature Guide
Simple Loot Council (SLC) runs loot council voting for WoW retail 12.1.0 (Midnight), synced live across every raider's client. Retail has no master looter, so the council votes on items sitting in a raider's bags during the 2-hour trade window; the loot master awards, and the holder trades the item across.
Beta SLC is in beta as of 0.40.0. Every participant needs the addon; players without it still show up in the council table, they just never answer.
Getting started
- Install it. With WowUp: Get Addons → Install from URL → paste
https://github.com/SimpleLootCouncil/SimpleLootCouncil-Beta. WowUp keeps it updated. By hand: download the zip from the latest release and unzip theSimpleLootCouncilfolder intoWorld of Warcraft\_retail_\Interface\AddOns. /reloadin game. No client restart is needed, even for a first install.- Type
/slcto open settings./glcworks as an alias for every command. - The group leader runs loot by default. Hand it to someone else with
/slc lootmaster Name-Realm. - Add your council:
/slc council add Name-Realm, or tick guild ranks under Council by guild rank in settings. - Try it solo first:
/slc test 6opens a simulated run with six items so you can see every window.
If WowUp says Addon Installation Failed, go to Options → Addons and clear the GitHub Personal Access Token field, then try again.
No library dependencies. Optional integrations: WowUtils (wishlist and sim columns), SimulationCraft (profile export), RCLootCouncil / Loothing (history import). Disable RCLootCouncil's own looting if you run the SLC funnel - the two conflict.
How a loot run works
A run goes from the boss kill to a completed trade in seven steps, and every step is shared live with the group.
- Opt in. On entering a raid, the loot master is asked "Use Simple Loot Council for this raid?". Raiders are then asked whether to take part. Nobody is asked anything until the loot master says yes.
- Collect. With the optional group-loot funnel on, the loot master rolls Need and participating raiders pass, so loot lands in one pair of bags. Without it, raiders keep what they win and the council still votes on it.
- Stage. The loot master queues items privately in the Loot Queue (
/slc queue), from their own bags or, if enabled, council members' bags. Staging opens nothing on anyone else's screen. - Start.
Start runsends the items to the group. Every raider gets the Loot Response window; the council gets the Loot Council table. Items can be added to a run in progress. - Respond. Raiders pick a response (Mainspec, Offspec, Transmog by default, all configurable), add an optional note, or pass. Unusable items can auto-pass.
- Vote and award. The council votes; the loot master awards. Awards can go to a player or "for a reason" (disenchant, guild bank, free).
- Trade. Whoever holds the item sees it in Loot to Trade. Opening a trade with the winner fills the window automatically; you press Trade. The award is marked delivered only once the item has actually changed hands.
The boss each item dropped from is recorded automatically, from the kill or from the Adventure Guide. Addon messages are blocked during boss encounters and Mythic+, so loot seen mid-fight is queued and sent when the pull ends; normal combat is fine.
For raiders
A raider answers each item in one window and never needs a command.
| Feature | What it does | Commands |
|---|---|---|
| Loot Response window | One card per item, with its item level, your equipped comparison and the response buttons. Pass is always there. | /slc response (/slc r) reopens it |
| Notes | Add up to 64 characters per item, with or without a response. The council sees [+] and reads the note on hover. A half-typed note survives repaints and reloads. | - |
| Session panel | A compact overview of your own answers, rolls and awards for the run. | /slc session (/slc sess) |
| Rolls | When the council asks, a Roll button appears on the card. Your roll is read from chat by your own client and the loot master's. | /roll works too |
| Auto-pass | Passes for you on items with a definite class or armour restriction, never on a guess. It never overrides an answer you already gave. The note reads Automatic pass: wrong armour type. | Settings > Loot handling |
| Transmog exception | Optional: never auto-pass on an item that would teach you a new appearance. | Settings > Loot handling |
| Whisper fallback | If your addon is broken, whisper the loot master: 1 mainspec great upgrade. Button names, first words and custom keywords all match, in any case. | /slc whisper shows the guide |
| Group-loot funnel | Opt-in. While the loot master is collecting, your client passes on group loot so it lands with them. You are warned in chat whenever it is active. | /slc funnel toggles it |
| Auto-join | Skip the "take part?" question in groups that use SLC. You are still told in chat. | Settings > Loot handling |
| Bonus rolls | Coin results you win are reported to the loot master and shown as a coined tag beside your name on that item. | /slc coins |
| Windows come back | The response window reopens itself after a loading screen, fear or mind control if the game closed it. Closing it yourself keeps it closed. | - |
For the council
The Loot Council table shows every candidate for every item, and each council member's votes reach everyone within a second. Reopen it any time with /slc vote (/slc v).
| Column / feature | What it shows |
|---|---|
| Item rail | Each item with its state: OPEN, AWARDED, MISSING, OWED, REMOVED, plus boss, difficulty and upgrade track |
| Name | Class-coloured candidate, spec, item level, and a coined tag if they bonus-rolled this item |
| Response | Their answer in its button colour, or Waiting, Pass, Auto-pass |
| Upgrade | Item-level change against what they have equipped, and tier-set progress (3/4 set, +2set, +4set) |
| Wishlist / Sim | From WowUtils, when installed: is it on their list, BiS, and the simulated DPS gain |
| Note | [+] when they wrote one; hover to read it |
| Roll | Their roll, or assign for a generated one |
| Votes | Vote count, with Vote / Unvote buttons |
| Compact / Expand | Toggle a denser layout for large raids |
Hover a candidate for the council tooltip: their most recent loot, who else has won this item, attendance (nights this season), alt/main link, guild note and officer note (if you can see it), and their equipped item with sockets and average item level.
Voting rules are shared group-wide so a vote means the same thing on every screen:
- Council may vote for themselves (on by default)
- Allow voting for several candidates per item (off)
- Hide vote counts until you have voted, to stop bandwagoning (off)
Rolls: right-click a row or item to ask one player, everyone on a response, or the whole raid to roll; or generate rolls instantly. /slc roll ask, /slc roll random, /slc roll clear do the same for every unawarded item.
Start requests: if the loot master allows it, council members can propose a run from their own queue; the loot master approves or declines.
For the loot master
The loot master stages, starts, awards and ends runs; SLC tracks every item until it is delivered.
| Feature | What it does | Commands |
|---|---|---|
| Loot Queue | Private staging window. A side panel lists your tradeable items (newest first); click one to queue it, or add all. | /slc queue (/slc q), /slc additem <link>, /slc bags add <n>|all |
| Start / end a run | Start sends the queue to the group. End keeps the records for re-award; Clear discards staged items (refused mid-run). | /slc start, /slc end, /slc clear |
| Add mid-run | Items can join a run already in progress; loot rarely arrives in one batch. | Loot Queue or /slc additem |
| Award | One click on a candidate's row, with a confirmation. Re-award or undo at any time; undo strikes it from history for everyone. | Right-click a row |
| Award for a reason | Disenchant, Guild bank or Free. Kept out of that player's win count; Free is not recorded at all. | Right-click > Award for |
| BoE routing | Name one player and one reason for Bind-on-Equip items. Their row shows route -> and the Award button is pre-filled. It never awards by itself. | Settings > Loot handling |
| Remove / restore | Pull an item out of a run and put it back later. | Right-click the item |
| Held-item checks | Items that were equipped, sold, or passed their trade window are flagged MISSING and cannot be awarded. An item still owed from an earlier award shows OWED. | - |
| Loot to Trade | Everything you owe, grouped by player and trade range. Open a trade and the items are filled in; you press Trade. Wrong recipients, equipped or vanished items are flagged red and reported to the loot master. | /slc trades, /slc trade [name], /slc held |
| Announcements | Awards, completed trades and roll requests posted to raid/party chat, by the loot master only. Each can be switched off. | Settings > Announcements |
| Session timer | Optional countdown on a run. Display only: it never closes the run or rejects a late answer. | Settings > Session |
| Active / LIVE tags | In /slc: click Active to turn SLC on or off for the group; click LIVE to open the council window, right-click to end the run. | /slc on, /slc off |
| SimulationCraft | With SimC installed, /simc includes the run's items as a gear block to paste into Raidbots. | /simc |
Council setup
The council is a list of players plus any guild ranks you empower, and the group leader's settings are shared with everyone automatically.
| Feature | What it does | Commands |
|---|---|---|
| Council members | Add or remove by Name-Realm. Absent members show as pending (greyed) until they join; members are kept by character ID, so renames and transfers survive. | /slc council, /slc council add|remove <Name-Realm> |
| Council by guild rank | Tick ranks in settings; everyone at that rank votes, and promotions or demotions apply automatically. Listed after named members. | Settings > Loot Council |
| Loot master delegation | The leader hands loot to someone else. It reverts to the leader whenever the delegate leaves the group. | /slc lootmaster <Name-Realm>, /slc lootmaster clear (/slc ml) |
| Start requests | Let council members propose a run for approval, or start runs themselves without approval. Both off by default. | Settings > Voting |
| Council bags | Show each council member's tradeable loot in the Loot Queue under their name, so items they hold can be staged. Off by default. | Settings > Voting |
| Response buttons | Rename, recolour, add, delete or reorder the buttons raiders see, and add whisper keywords (e.g. ms). | Settings > Response buttons |
| Alts | Link an alt to its main so the council sees the whole history. Realm spelling is forgiving. | /slc alt <Alt-Realm> <Main-Realm>, /slc alt remove <Alt-Realm>, Settings > Alts |
| Version check | See which build everyone runs; you are warned in chat if someone is on a different version. | /slc version (/slc ver) |
| Guild-group gate | The funnel only acts in guild groups by default. | /slc guild |
History, raid team and imports
Every award is recorded, shared with the group, and browsable by item or by raider.
| Feature | What it does | Commands |
|---|---|---|
| Loot History browser | Every award with date, item, winner, response, boss, instance, votes and delivered state. Search by name, item, boss or date; filter by time (30 days to all time), source, mine only or raid team. | /slc history (/slc h) |
| Council snapshot | Hover an award to see the council as it stood: every candidate's answer, note, roll and votes. Hold Shift for more than eight. For settling disputes. | Hover a row |
| Edit locally | Right-click a row to fix the winner, response or reason, or delete it. Edits are marked as local. | Right-click a row |
| Shared history | Awards broadcast so every raider keeps an auditable copy. | Settings > Data & history |
| Raid Team Loot | The same history pivoted by raider for the guild ranks you mark as your raid team. Expand a raider to see what they won; sort by loot, latest win, attendance, rank or name; this season or all time. Bank and disenchant awards are listed, never counted. | /slc team (/slc t), /slc team season <date>|clear |
| Attendance | While you run loot, who was present at the end of each pull is recorded and shared. Shown as nights attended on hover and in Raid Team. | /slc attendance [name] (/slc att), /slc attendance nights |
| CSV export | Copyable export, comma or semicolon separated (semicolon suits European Excel). | /slc csv [slc] [comma|semicolon] |
| Import other addons | Pull award history from RCLootCouncil or Loothing saved data on this client. Imported rows are kept separate and labelled. | History > Import Other History, /slc import [addon] |
| Import CSV | Paste a CSV export from RCLootCouncil, Loothing or SLC, including someone else's database. Duplicates are skipped. | History > Import CSV |
| Retention | Local history is pruned after 180 days by default. | Settings > Data & history |
Settings
Every option lives in the /slc window. Settings marked shared come from the loot master and apply to the whole group.
| Section | Setting | Default |
|---|---|---|
| Voting | Council may vote for themselves (shared) | On |
| Voting | Allow voting for several candidates (shared) | Off |
| Voting | Hide vote counts until you have voted (shared) | Off |
| Voting | Council may request a run start (shared) | Off |
| Voting | Council members may start runs themselves (shared) | Off |
| Voting | View loot in council members' bags (shared) | Off |
| Loot handling | Auto-pass on unusable items | On |
| Loot handling | Don't auto-pass on items you can gain an appearance from | Off |
| Loot handling | Group-loot funnel | Off |
| Loot handling | Funnel only in guild groups | On |
| Loot handling | Use SLC in groups (not just raids) | Off |
| Loot handling | Route BoE items to (player + reason) | Unset |
| Loot handling | Automatically join SLC sessions in groups you join | Off |
| Session | Allow whispered loot responses | On |
| Session | Show the council hover panel | On |
| Session | Show the session frame | On |
| Session | Session timer (10 s to 1 h) | Off, 120 s |
| Announcements | Announce awards / trades / roll requests in raid chat | On |
| Response buttons | Names, colours, order, whisper keywords | Mainspec, Offspec, Transmog |
| Loot Council | Named members and council guild ranks | Empty |
| Data & history | Record award history; share it with the group; record attendance | On |
| Diagnostics | Log to chat | Off |
| Alts | Alt-to-main links | Empty |
Slash command reference
Every command works as /slc or /glc; /slc help prints this list in game.
| Command | Who | What it does |
|---|---|---|
/slc | Anyone | Open settings |
/slc response (r) | Anyone | Reopen your loot response window |
/slc vote (v) | Council | Reopen the council window |
/slc session (sess) | Anyone | Your own view of the current run |
/slc queue (q) | Loot master | Staging window with the bags panel |
/slc additem <link> | Loot master | Queue an item (shift-click it in) |
/slc bags [add <n>|add all] | Loot master | List tradeable items, or queue them |
/slc start | Loot master | Start a run on the queued items |
/slc end | Loot master | End the run, keeping items for re-award |
/slc clear | Loot master | Discard staged items (refused during a run) |
/slc show | Anyone | Print the current run state |
/slc roll [ask|random|clear] | Loot master | Rolls on every unawarded item |
/slc on / /slc off | Loot master | Use SLC for this group, or stop |
/slc funnel | Anyone | Toggle your group-loot funnel |
/slc lootmaster [<name>|clear] (ml) | Leader | Delegate loot, or hand it back |
/slc council [add|remove <name>] | Leader | Manage the council |
/slc alt [<alt> <main>|remove <alt>] | Anyone | Link an alt's history to its main |
/slc trades | Holder | The Loot to Trade window |
/slc trade [name] | Holder | Open a trade with someone you owe |
/slc held | Holder | List what you owe or are holding |
/slc whisper [text] (w) | Anyone | Show the whisper guide, or test what a whisper would do |
/slc history (h) | Anyone | Loot history browser (history text prints it) |
/slc csv [slc] [comma|semicolon] | Anyone | Export history as CSV; slc omits imported rows |
/slc import [addon] | Anyone | Import RCLootCouncil or Loothing history |
/slc team (t) | Anyone | Raid Team Loot view |
/slc team season [date|clear] | Anyone | Set what counts as this season |
/slc attendance [name] (att) | Anyone | Nights and pulls attended; nights lists raid nights |
/slc boss | Anyone | Current boss and the encounter log |
/slc coins | Anyone | Recent bonus-roll results |
/slc item <link> | Anyone | Why the funnel does or does not take an item |
/slc set | Anyone | Equipped tier-set facts |
/slc guild | Anyone | The guild-group gate check |
/slc version (ver) | Anyone | Who runs which build |
/slc status | Anyone | Restrictions, queue depth, leader |
/slc test [<count>|<link> [from [heroic] <boss>], ...] | Anyone | Simulated run; count 1-N from a classic raid pool, default 3 |
/slc testcoin [Name-Realm] [item] | Anyone | Fake a coin result on a test run |
/slc ping [bytes] | Anyone | Comms round-trip test |
/slc log / /slc log history | Anyone | Diagnostic log, copyable |
/slc dump | Anyone | Saved variables, copyable |
/slc debug | Anyone | Echo the log to chat |
/slc pseudo [on|off] | Anyone | Translation test mode (reloads) |
/slc taint | Anyone | Blocked-action counts |
Reliability
A run survives reloads, disconnects and loading screens on any client, including the loot master's.
- Reload recovery. A raider, council member or loot master who
/reloads mid-run gets the run back from the group within seconds: responses, notes, votes, rolls and coins intact. A delegated loot master recovers too. - Nothing owed is forgotten. The trade ledger is saved, so a reload never loses who you owe what.
- Delivery is checked against your bags, not assumed. An item that was equipped, sold, or traded to the wrong player is flagged, and the loot master is told.
- Loading screens and crowd control. The game closes addon windows on every zone change, fear or mind control; SLC reopens the ones you did not close yourself.
- Boss encounters and Mythic+. Blizzard blocks addon messages there. SLC queues outgoing messages in order and sends them when the block lifts.
- Version warnings. You are told in chat if someone in the group runs a different build.
- Every string is translatable. The addon ships in English; translators can work from
Locale/enUS.lua.
Testing and reporting bugs
Most of SLC can be tried solo; a real bug report needs the log from every client involved.
Solo checks
/slc test 6- a simulated run with six classic-raid items. Open every window, respond, vote, award./slc test [item link] from heroic <boss>- test a specific item, attributed to a boss and difficulty./slc testcoin 2- fake a bonus roll on item 2 to see thecoinedtag. No coin is spent and nothing reaches history./slc ping- checks the whole message path, round trip./slc history,/slc team,/slc queue,/slc trades- browse each window.- Test awards from
/slc testnever reach your real history.
With a friend: start a test run, then /reload one client mid-run and check that everything comes back.
Before testing, run /console scriptErrors 1 so Lua errors show on screen. BugSack and BugGrabber help too.
When something goes wrong, send:
/slc logfrom every affected player, copied out of the window./slc dumpfrom the loot master.- What you clicked, and what you expected to happen.
The log is timestamped and survives reloads, so comparing the loot master's with a raider's usually shows which message went missing. After an update, /reload twice before reading the log: the first reload still shows the old build's state.