Description
TokenCouncil
A token-based loot council for raids. Every raider gets tokens when the raid starts and puts them on the drops they really want. Each token is a roll. The Master Looter hands the item to the best roll or lets the loot council vote - and everyone who used tokens but didn't win gets them all back. Only the winner pays.
No loot tables, no spreadsheets, no DKP bookkeeping: TokenCouncil lists the drops, takes the tokens, rolls, refunds and keeps the ledger for you.
Version 1.18.0
How a raid works
- Start the raid. The raid leader opens the Master Looter panel, types how many tokens everyone gets and presses Start session - a clean start, or carry on with the saved ledger. Guild ranks can get bonus tokens on top.
- Loot drops. Equipment is listed as pending by itself. Every raider sees it in My Loot and can decide what they want before anything starts.
- The Master Looter starts the roll. Raiders click Use token (1, 2, 3 or all of them, with an optional note for the council) or Pass. Tokens on an item are final: you can add more, but never take them back.
- The timer ends. Every token becomes an automatic 1-100 roll and your best roll counts. Everyone sees the rolls.
- Hand out. The Master Looter gives it to the best roll, or starts a council vote for that one item. The moment the item is handed out, everyone who used tokens on it but didn't win gets them back.
- End of the raid. Copy the token export and paste it into the next raid: banked tokens are added on top of that raid's tokens.
Features
For the Master Looter
- One control panel with Session, Tokens, Council, History, Bank, Import / Export, Reserved, Alts and Settings tabs
- Clean player rows: highest roll, tokens used, tokens left, upgrade size, loot record, note (hover for the full text), votes and voters
- Hand to the best roll, start a council vote, hand to anyone, disenchant, or cancel and refund
- Free mainspec roll and offspec roll: a roll for everyone that costs no tokens, when nobody used a token (an offspec roll can also go straight on a pending drop). They don't count in the loot record
- Max tokens per item (0 = no limit), saved for the whole raid and announced in raid chat
- Guild rank bonus: for example Officer +2, Raider +1 on top of the raid's tokens
- Reserved slots: everyone picks one gear slot in a popup; token rolls on items for that slot get bonus roll points you set
- Linked characters: pair a player's alts with their main - one shared balance, loot record, bank row and council seat
- Late joiners get the raid's tokens automatically (once per player, whichever character)
- Full audit log of every token change, and a hand-out history
For raiders
- My Loot: pending drops as icons, your tokens, Use token / Pass and a live timer
- Loot Board: every drop and every player's tokens and loot record, plus a Raid history tab - who got what, how it was decided and who got tokens back
- Upgrade size and loot record for everyone: "+13" = item levels a drop adds over what that player wears; "1 · 3" = items won this raid · in their last 4 raids with you
- Refunds show up the moment they happen; your own wins are highlighted
- Council members get a clean Council Vote window only when the Master Looter asks for a vote
- Minimap button to open every window (in Retail also in the addon compartment)
Reserved slots
- Click Ask raid to pick: everyone in the raid - you too - gets a popup to pick one gear slot for the raid (head, neck, shoulders, back, chest, wrists, hands, waist, legs, feet, ring, trinket, weapon, off hand)
- Token rolls on an item for your reserved slot get bonus roll points (Settings, for example +20: a roll of 20 counts as 40)
- Everyone sees it: "40" with "20+20" under it in the Master Looter panel and council vote, "40 (20+20)" on the Loot Board, and in raid chat
- Picks are final; the Master Looter can clear one, clear all, lock picks or turn it off
- Free and offspec rolls get no bonus
Linked characters (alts)
- The Alts tab: type (or pick) an alt and its main and click Link
- From then on they're one player: one token balance, one loot record, one guild bank row, one council seat
- The raid's tokens are given once per player: log out and come back on your alt mid-raid and you keep the same tokens
- Linking adds the alt's tokens to the main's - the popup shows the math, or keeps only the main's; Unlink leaves the tokens with the main
- Everyone sees the shared balance and record under either name ("Alt of ..." in the tooltip)
- The token export carries the pairs (
Alt Name -> Main Name), so the next import - on any computer - links them again - Reserved slots stay per character (each has its own gear)
Guild bank dues
- Tracks the vendor value of every item a player receives
- Set a share of 0-100% of the vendor price that players owe the guild bank
- A Bank tab for the Master Looter with Mark paid and Undo
- Everyone sees what they owe on the Loot Board
Carry tokens to the next raid
- End session opens the token export: every player as
Name = tokens [loot record], ready to copy (Ctrl+C) into a text file or Discord - and saved on your computer for Use last export - Next raid, paste it in the Import / Export tab, check the preview and click Add banked tokens
- Players in the raid get their banked tokens on top of the raid's tokens
- Players who skip a raid keep exactly their banked tokens - never the raid's - and stay in the next export, so nobody drops off the list
- Import again safely (only the difference is added), or undo the whole import
Built to be reliable
- The Master Looter's addon is the single source of truth; every raider follows it live
- The raid is scanned every second, so new players get the session and their tokens right away
- Reloads and disconnects don't lose the session; even after a crash of the Master Looter's game the raid's copies fill in what wasn't saved
- Works within the game's addon message limits and boss-fight restrictions - tested with full 20- and 40-player raids (late joiners, reloads, a boss fight in the middle of a roll, a crash of the Master Looter's game)
- Shows who has the addon, who is connected and who runs another version (
/tkc check) - Classic WoW look: the game's own frames, buttons, checkboxes and sounds
WoW Forever
Full support for WoW Forever's two-part names ("First Last"). Players are always told apart by their full name, so two players who share a first name never share tokens. Slash commands, the Alts tab and the token import take the full name, for example /tkc set Tree Boggler 2 or /tkc link Tree Sapling > Tree Boggler.
Slash commands
/tkc- Loot board (everyone)/tkc me- Your token balance and rolls/tkc vote- Council voting dashboard/tkc ml- Master Looter control panel (raid leader)/tkc start [n]- Start a loot session: choose to reset the ledger (everyone gets n tokens) or keep saved tokens (ML)/tkc reset- Clean slate: wipe saved tokens, audit log and hand-out history (ML, no session running)/tkc stop- End the loot session; shows the token export to copy for the next raid (ML)/tkc export- Every player's tokens as text to copy for the next raid (ML; import it in ML panel > Import / Export)/tkc reserve- Pick your reserved gear slot (while the Master Looter asks for reserved slots)/tkc tokens <n>- Set every raid member to n tokens (ML, before the raid)/tkc set <name> <n>- Set one player's tokens (ML; WoW Forever: the full name, e.g. /tkc set Tree Boggler 2)/tkc give <name> <n>- Add (or with -n remove) tokens for one player (ML; full name)/tkc add [item]- Put an item up and start its roll (drops are listed as pending by themselves) (ML)/tkc council <name>- Toggle a council member (ML; full name)/tkc link <alt> > <main>- Link an alt to its main: they share tokens and loot record (ML; full names, e.g. /tkc link Tree Sapling > Tree Boggler)/tkc unlink <alt>- Unlink an alt (its tokens stay with the main) (ML)/tkc links- List linked characters/tkc check- Who in the raid has TokenCouncil (and which version)/tkc debug- What the addon sees about you and your group/tkc sync- Ask the Master Looter for a full resync/tkc minimap- Show or hide the minimap button
Requirements
- Everyone in the raid needs TokenCouncil. The Master Looter panel shows who doesn't have it, who isn't connected yet and who runs a version that can't join.
- The raid leader runs the loot session.
- Clients: Retail (Midnight), WoW Forever, Mists Classic, Titan Reforged, TBC Anniversary and Classic Era.
- Retail: the player who received a drop is asked to trade it to the winner. Classic: the item is given through Master Loot while the loot window is open.
- Addons can't write files, so the token export is a window to copy from - paste it wherever you keep it.
What's new in 1.18.0
- Linked characters (alts): a new Alts tab in the Master Looter panel pairs a player's alts with their main. They share one token balance, one loot record, one guild bank row and one council seat - and the raid's tokens are given once per player, whichever character comes.
- Linking shows the token math first ("3 + 4 = 7", or keep only the main's); unlinking leaves the tokens with the main. Also
/tkc link Alt Name > Main Name,/tkc unlinkand/tkc links. - The token export lists the player once plus a line per alt (
Alt Name -> Main Name); the import links them again and adds up older exports that listed them separately. - Big raids: tested with full 20- and 40-player raids. In a busy 40-player raid everyone now sees rolls, refunds and votes within seconds (updates go first, on two message lanes, and are much smaller), nobody can promise the same token twice by clicking fast, and the false "No answer from the Master Looter" is gone.
- After the Master Looter's /reload the raid follows again within seconds, and a crash of the Master Looter's game in a 40-player raid no longer loses the drops since the last save.
- Everyone in the raid needs 1.18 or newer.
Recent versions
- 1.17.1 - The export after a solo test session keeps its loot record.
- 1.17.0 - Upgrade size and loot record (this raid / last 4 raids) for every token user; free roll renamed to free mainspec roll.
- 1.16.1 - The Loot Board's Your role card shows your reserved slot short so it fits.
- 1.16.0 - Reserved slots: everyone picks one gear slot; token rolls on items for it get bonus roll points, shown next to the roll.
- 1.15.0 - Absent players stay in the token export with their banked tokens as they were - never the raid's tokens.
- 1.14.1 - Players are always told apart by their full name (First Last) - two players who share a first name never share tokens.
- 1.14.0 - Token export at the end of the raid and banked-token import in the next one.
- 1.13.0 - Everyone sees what they owe the guild bank on the Loot Board.
- 1.12.0 - Offspec roll, and guild bank dues based on the vendor price of received items.
- 1.11.0 - Guild rank bonus tokens.
- 1.10.0 - Drops are listed as pending; the Master Looter starts each roll. Pending loot strip in My Loot.
Bugs and feedback
Found a problem? Type /tkc debug and include what it prints in your report.


