Terms used here
- A claim is a request for an item you need and agree to accept.
- An award is contested when at least two eligible people are in the selected group.
- Credit is the balance used to compare those claims. Higher credit wins.
- Your turn is your place in a saved order. It decides only exact credit ties.
- A ledger is one separate set of credit and turn records.
- A loot season is one gearing period. It may cover more than one raid tier.
- The selected group is the highest-priority group that has a valid claim.
- Main-spec means your approved primary role. Offspec means another approved role.
- A recruit has not yet qualified for prized-item priority. Qualification starts at the raid after six credited raids.
- A checkpoint is the last saved state of the records. A snapshot is a fixed copy saved for a season change.
1. What this policy covers
What credit means and which raids these rules cover.
Raid standards and time commitment
Preparation, skill, and constructive behavior earn a raid place. Once you are eligible for an item, the same published rule applies to you as to everyone else. We address performance problems directly, not through hidden loot penalties. Officers get no better loot treatment for being officers.
The scheduled commitment is four hours per week. Farming, donations, summons, optional runs, and staying late do not earn credit. We appreciate those contributions, but they do not create a second, hidden commitment.
What credit means
Each contested item gives the selected claimants equal shares of one credit. The winner spends one credit. Your balance is the credit you have gained minus what you have spent. A negative balance means you have won more than your accumulated share. You can still win with negative credit; it is not a penalty or a performance score.
If nobody else in the selected group wants an item, there is no competing claim. The item costs no credit and uses no turn. There is no one-item-per-night limit.
Every contested item costs one credit in its ledger. We do not charge more for a stronger item or choose winners by estimated raid damage.
The three ledgers
| Ledger | Used for | Separate from |
|---|---|---|
| Ordinary main-spec | Contested ordinary main-spec upgrades | Prized and offspec credit and turns |
| Prized main-spec | Contested main-spec items on the prized list, including recruit fallbacks | Ordinary and offspec credit and turns |
| Offspec fallback | All contested offspec awards in the season, ordinary or prized | Both main-spec ledgers |
Each ledger has exact balances and its own turns. We do not create extra queues for an item, class, pair of players, or claimant combination.
The prized list is a small, published list of specific item variants. Each revision has a version number. These items have separate main-spec priority; weapons and trinkets are not automatically prized. All offspec awards use the same offspec ledger, including prized items. Any eligible drop that is not on the published prized list at raid start counts as ordinary for that raid. Officers review newly seen drops after the raid, and any addition to the prized list takes effect at the next raid. Legendary items (quality 5) are automatically prized even before they appear on the published list. Officers may publish a Legendary assignment before the raid freezes (30 minutes before start); an assigned Legendary goes to that member outside the ledgers with no claim window, credit change, or turn change, and officers cannot assign one during a raid.
Membership and outside items
This policy covers recorded guild allocations during scheduled raids. An item you get elsewhere can satisfy a need, but it cannot earn or spend guild credit. Optional runs are outside the loot system: their loot is a free roll, and they do not change your priority.
Your records belong to your permanent member identity. Changing characters, changing an approved role, leaving, or returning does not erase them. Qualification applies to you as a member, not to a character. Credit and turns belong to one member, one loot season, and one ledger.
2. Claims, groups, and qualification
Who can ask for an item and when recruits qualify.
What makes a valid claim
You may claim an actual drop only if you are entitled to receive it, need it as a genuine upgrade for your approved role, and will accept it at the normal credit cost. Being on the roster or able to equip it is not enough.
Your approved main spec and raid role lock 30 minutes before each raid starts. You do not submit a gear plan ahead of time. When a boss drops loot, you choose Need (main-spec upgrade for your approved main spec and role), Offspec, or Pass inside the in-raid claim window. Claims are blind while the window is open and lock when the window closes. No answer counts as Pass. A higher item level alone does not make an item an upgrade.
You may change your choice freely until the claim window closes. A pass earns no credit and prevents you from claiming that same copy through a lower-priority group, including offspec. After the window closes, the only change is a factual pass before delivery: you already have the item, or it breaks a set bonus. Need cannot change to Offspec after the window closes, and you cannot change a claim after you see the result. A drop that removes your need for a different item (for example, it completes a set bonus) changes that other claim only by the same factual pass before delivery. Officers do not override honest claims during the raid. Officers review the saved claim log after the raid and treat deliberate out-of-role or false claims as a guild conduct issue.
Who can claim in the raid
- In the group at the kill. You must be in the raid group when the boss dies, when its loot batch opens. A player who joins after the kill cannot claim that boss’s loot.
- A disconnect does not cost you loot. If you are still in the raid group, you can claim and win while you are offline. A claim that you sent before the disconnect counts. Delivery waits until you reconnect, and the item does not go to another player during the raid. Attendance counts only your online minutes.
- Loot master claims for you. If you do not have the addon, the loot master can enter your claim, but only inside the 30-second window, so claims stay blind.
- One character per raid. Each member uses one approved character per raid: the main or an approved alt. Online minutes on both characters add up toward the 60 minutes, and a minute on both counts once.
- Guests. Guests cannot claim until we publish a guest policy. A guest claim is excluded with a reason, and it never blocks a member.
- Officers. Any officer can take over loot with a recorded handoff. An in-game change of master looter to an officer counts as a handoff. The new officer must be online in the raid group. After a valid handoff, the addons accept the new officer as the writer.
Pick the group first
| Item category | Priority groups, highest first |
|---|---|
| Ordinary | All valid main-spec claimants; otherwise all valid offspec claimants |
| Prized | Qualified main-spec; otherwise recruit main-spec; otherwise qualified offspec; otherwise recruit offspec |
Check the groups in the listed order. Use the first group with a valid claim, then stop. N counts only the people in that group. Other groups gain and spend nothing. If the selected group has one claimant, the award is uncontested even if someone in a lower group also wants it.
Main-spec awards use the ordinary or prized ledger for the item. Offspec awards use that season’s offspec ledger. If no group has a valid claim, use the published bank, disenchant, or other unallocated-item rule where the game allows it.
Six credited raids to qualify
Qualified prized priority starts at the next raid after six completed, credited scheduled raids. With two raids each week and full participation, that normally means the seventh scheduled raid after three raid weeks. Missed or noncredited sessions extend the period. There is no separate 14-day or 21-day test.
The minimum is 60 minutes in the raid or available on its assigned bench during the scheduled two-hour window. Count overlapping raid and bench time once. A completed raid can count toward qualification only once. Optional runs and time after the scheduled end do not count.
An officer marks bench players in Discord with /officer raid bench. Bench time counts from the scheduled start, also when the raid starts late. Loot after the scheduled end uses the normal rules and normal credit; only attendance minutes stop at the scheduled end.
Qualification stays fixed throughout a raid. Completing your sixth credited raid gives you priority at the next raid, not during the sixth. Items won as a recruit, credit, and turns remain in your record when you qualify.
Everyone starts in the recruit groups at guild launch. Founding members have no exemption. Recruits can still receive prized items when no qualified main-spec member claims them.
3. How credit and turns decide
How credit is calculated and how ties are decided.
The credit calculation
When at least two eligible people are in the selected group, let N be the number of people in that group:
Every claimant: balance += 1/N
Winner only: balance -= 1
The highest exact credit wins. The earliest turn breaks an exact tie. Everyone gets the same +1/N, so that addition cannot change the order; the system may compare the balances before adding it.
Each loser gains 1/N credit. The winner gains the same share, then spends 1 credit: a net change of -(N-1)/N. The changes total zero. If three people start at zero, the winner ends at -2/3 and the other two at +1/3 each.
With one claimant (N = 1), award the item without changing credit or turn. This is not a contested win. With no claimants (N = 0), follow the rule for unclaimed items without changing anyone’s priority.
How turns are made and used
For the first season, we close the initial roster and Quartermaster makes one seeded draw for each ledger. The Guild Master starts the season once. The bot makes a random seed, saves it with the season, and publishes it. For each member of the closed roster, the draw key is the SHA-256 digest of the text seed:ledger:member id, as hexadecimal text. The lower key gets the earlier turn; for an equal key, the lower member id. Anyone with the seed can repeat the draw. The draw runs once and its turns are saved. Officers cannot reroll to get another order. There is no new roll for each item. A season change makes no new draw; section 6 says how the tie-break order carries over.
A later enrollee joins the back of every ledger’s order. New members get their turns in the order they joined the guild, then by member id. Every confirmed contested winner moves to the back of the ledger used, whether credit or a tie decided the award. Everyone else keeps the same relative order. Passing, absence, uncontested loot, and qualification do not use a turn.
New members do not move ahead just because they have never won. At equal credit, the earlier turn wins. In the same selected group, a new member at zero can beat an existing member with negative credit.
Software stores turns as unique ascending sequence numbers. Lower numbers win ties. Each enrollment and contested win gets the next number. A returning member uses the existing record. A later season inherits its starting order under section 6 instead of drawing again.
One ladder, different groups
For each drop, select its priority group and ledger, then compare only the people who can claim it. One ledger needs one record per member, not a separate queue for each combination of claimants.
You may lead the overall ladder and still be unable to claim an item. Losing to Alex does not reserve the next item against Alex; either of you may enter other contests that change the next comparison.
A preview must name the item, selected group, season, and record checkpoint. It cannot promise who will get the next prized drop in every situation.
4. Boss batches, delivery, and corrections
Multiple drops, failed trades, and mistakes.
Set a batch order before awarding
Several drops from one boss can affect the same balances and needs. Quartermaster records the complete observed batch, locks claims, and sets a repeatable order before finalizing an award.
Process prized items before ordinary items. Give each physical copy a unique, fixed ID (its loot slot key). Inside each of the two groups, the order comes from a fixed key:
text = raid_id + ":" + ledger_revision + ":" + boss + ":" + slot_key
h = 2166136261
for each UTF-8 byte b of text:
h = h XOR b
h = (h * 16777619) mod 4294967296
key = h
This is 32-bit FNV-1a. raid_id and ledger_revision are the raid number and the ledger revision of the session package, as decimal digits. Both stay the same for the whole night and are saved, so nobody can choose another order. The lower key goes first. For an equal key, the lower slot key goes first, compared byte by byte. Compare keys as numbers. The result must not depend on button clicks or message arrival order.
Save the seed, batch, item order, and policy version. Do not allow repeated shuffles until someone likes the order. A saved seed is not enough to prevent manipulation: changes to the roster, IDs, and permitted corrections must also be recorded.
Process items in that order, updating temporary balances and eligibility after each award. Winning a single-slot or unique item removes your claim on a second copy of that same item in the batch. For slots that hold two copies (rings, trinkets, and one-handed weapons), your claim on copy 2 stays after you win copy 1 only if you clicked Need on both copies. An Offspec claim on copy 2 is dropped after you win copy 1, and it never blocks other players or the drop. Copy 3 is open to everyone except the two winners of that item in the batch. Do not change claims after the batch window closes.
If a delivery is still pending when the next boss dies, the next boss goes ahead. Only decisions on the same ledger that share a claimant with the pending item wait for it.
This removes officer choice over order, but it does not find the best whole-batch result for every person. The fixed order can still change who gets which item.
A selection is not a delivery
The addon may preview a batch. A ledger changes officially only after delivery is confirmed. If an earlier award fails, later awards cannot use a state that never happened. Fix the failure and replay the undelivered remainder from the last confirmed state, in the saved order.
If the winner leaves the raid group before delivery, or is offline and does not reconnect before the raid ends, the item goes to the next valid claimant: the award is replayed without that player. The player’s credit does not change. If an item cannot be delivered at all, an officer marks it undelivered, nobody’s credit changes, and the rule for unclaimed items applies. If nobody claims an item, the loot master banks or disenchants it, and nobody’s priority changes.
The game integration must confirm awards in the saved order and detect conflicting deliveries. Trade-button order cannot change who wins. Reports from multiple addons, retried actions, or repeated uploads must not count the same item twice.
For each award, save included and excluded claims and reasons, selected group, season, ledger, exact balances, turns, recipient, delivery status, and the state before and after it.
Correct facts, not preferences
A wrong ownership record or need classification is an input error. Pause the award, correct the evidence, save a new numbered claimant record, and replay. Do not charge anyone for an item they did not receive. Replay dependent undelivered awards too.
A delivered item cannot be erased by editing a score. Record what happened and reverse or recover it where allowed. Do not invent compensation currency or silently reset turns. Leave conflicts that cannot be recovered as visible incidents.
The incident ledger keeps these records. A wrong delivery that we find later, and a correction after a confirmed delivery, is a visible officer incident. Neither changes the books automatically. An incident records what happened, the item and its copy, the award it refers to, the player who should have it and the player who got it, the officer who recorded it, the time, and the resolution. Its facts never change, and it gets one resolution. Any officer records an incident with /officer loot incident and resolves it with /officer loot resolve. The bot records an incident by itself when it cannot book an award, and when an item went to another player than the winner. You see the incidents about you with /loot incidents.
Two other cases wait for an officer. If a member joined after the session package was made, or got a raid rank during the raid, the bot flags the award as a conflict, and an officer fixes it after the raid. If an item variant has no season mapping, an officer maps it to a season first, and the bot holds the award until then.
Disliking a result is not a factual error. Policy changes take effect at an announced future point, outside the current allocation. Neither an officer nor an AI may choose a different winner because they prefer that result.
5. Example: four drops, different claimants
Four drops with different people competing.
Four qualified members start at zero prized credit. Their first turn order is Alex, Blair, Casey, Drew. Each row is a different needed item. Confirm each award before the next row.
| Drop | Claimants and credit before the award | Winner | Reason |
|---|---|---|---|
| 1 | Alex: 0; Blair: 0; Casey: 0 | Alex | Equal credit; earliest turn. |
| 2 | Blair: +1/3; Casey: +1/3; Drew: 0 | Blair | Blair and Casey tie for highest credit; Blair’s turn is earlier. |
| 3 | Alex: -2/3; Casey: +2/3; Drew: +1/3 | Casey | Highest credit. |
| 4 | Alex: -1/3; Blair: -1/3 | Alex | Equal credit; Alex’s updated turn is earlier. |
Order after each contested award
Start: Alex, Blair, Casey, Drew
After 1: Blair, Casey, Drew, Alex
After 2: Casey, Drew, Alex, Blair
After 3: Drew, Alex, Blair, Casey
After 4: Drew, Blair, Casey, Alex
Every contested winner moves to the back, including Casey, whose win used credit rather than a tie. There is no queue for a particular claimant combination.
Final balances
| Member | Prized credit | Tiebreak position |
|---|---|---|
| Alex | -5/6 | Fourth |
| Blair | +1/6 | Second |
| Casey | 0 | Third |
| Drew | +2/3 | First |
Drew leads the ladder but could not claim drop 4. A lead matters only if you are in that item’s selected group.
Alex beat Blair twice because both records changed between contests: Blair won another prize and Alex took part in another loss. The result uses their current category-wide records, not a promise about their next direct contest. The four balances sum to zero, and exact fractions must not be rounded into false ties.
6. New raids and loot seasons
When credit starts over and what carries forward.
A new raid is not an automatic reset
A loot season is the published set of records for one gearing cycle. A new raid can extend it. A major new gearing cycle can start another season. We publish the boundary and item assignments before awards, not after seeing who would gain from a reset.
The catalogue assigns every item variant a season and category. Running an old raid later does not move its loot into the current season. While only one loot season exists, a newly seen raid drop uses that season automatically as an ordinary item unless it is already on the published prized list. Once more than one season exists, publish a season mapping before allocating new variants or unclear cross-content drops. An item variant with no season mapping waits until an officer maps it.
New credit, inherited order
At the announced boundary, we save a checked snapshot of the previous season. For each ledger:
1. Sort old records by credit DESC, then turn ASC.
2. Copy that full order as the new starting turns.
3. Set every new-season credit balance to zero.
4. Leave the old ledger unchanged.
Copy the full closing ladder, not only the old turn order. A positive-credit member must not go behind a negative-credit member only because the latter had an earlier old turn.
Old credit determines your starting place, but it does not become new-season credit or debt. After the snapshot, normal new-season rules apply. We do not draw a new random order.
Keep old and new records separate
Only the open season is live in a raid. A new-season item uses the new ledger. An item that is mapped to a closed season and drops in a raid is not booked: it goes to the officers as a conflict, and an officer records it by hand as an incident. No old-season ledger, credit or turn changes. The item mapping, not the calendar date, chooses the season.
Old-season ledgers are closed records. An old item that an officer records by hand does not change old credit or turns, and does not reduce new-season credit. Later old-season items do not change the new starting turns saved in the snapshot. Items acquired outside guild raids can change needs but cannot earn guild credit.
Qualification and identity continue
Qualified members stay qualified. A recruit with four credited sessions still needs two more; a tier change is not a new trial. Keep character links, membership, and award history.
Members with records at the transition keep their inherited places even if absent or inactive. They must still be eligible to claim each item. New members enrolled after the snapshot start at zero and join the back. Returning members use their existing records, not a fresh order or a cleared balance. New members join only the ledgers of the open season; closed old-season ledgers never change.
If an old-season award is still pending at the season change, the season snapshot waits until that award is resolved.
There are no weekly resets or decay within a season. Reopening a season, retiring an old pool, or adding an unusual ledger needs a published rule, not an officer’s improvised result.
7. Example: moving to a new season
An example using old-season and new-season loot.
The old prized ledger closes with these balances. Its raw turn order happens to be Casey, Alex, Blair, but credit is sorted first.
| Member | Old prized credit | New prized credit | Inherited new turn |
|---|---|---|---|
| Alex | +1 | 0 | First |
| Blair | 0 | 0 | Second |
| Casey | -1 | 0 | Third |
Alex carries a place in the new order, not one spendable credit. Casey keeps -1 in the old ledger but starts at zero in the new one. The raw old turn order cannot override the closing credit.
All three qualify and claim the first new-season prize. Alex wins the equal-credit tie. New balances are Alex -2/3, Blair +1/3, Casey +1/3, and the new order is Blair, Casey, Alex.
Blair then beats Casey in an equal-credit contest. Alex could still win another item if Blair and Casey cannot claim it. Inherited order is a starting comparison, not a promise that each member gets one prize before anyone wins again.
An old item after the change
An old-season prize drops in a later raid, and Alex and Blair both want it. Their old balances are still +1 and 0, but the old season is closed. The bot does not book the item. It goes to the officers as a conflict, and an officer records who received it. Their old balances stay +1 and 0. Their new balances and turns do not change.
That separation is intentional. Alex keeps a new starting place, and the new season does not transfer a continuing balance from the old one. A closed season never changes.
The end-of-season tradeoff
Taking a contested item near the end of a season can lower your place in the next season’s starting order. Passing on an optional item can preserve that place. A fixed snapshot date does not remove this incentive.
We carry only the starting order, not unlimited credit, and we do not erase all history. Publish this before end-of-season decisions. Do not claim that strategic passing is impossible.
Save the checked season record
Check that all confirmed old-season awards are included before taking the snapshot. Save the source season, exact closing records, inherited orders, effective boundary, and version. Do not use outdated Discord records or awards awaiting delivery.
If a factual error is found before any new-season award, save a corrected snapshot with a new version. After new-season awards have occurred, record a cross-season incident and all affected decisions. Do not silently change the starting order or pretend a delivered item changed owners.
8. Questions about wins and losses
Multiple wins, repeat winners, and rare drops.
1. “They got four items and I got nothing.”
Morgan gets three ordinary upgrades that nobody else in the selected group wants. Morgan and Alex then tie at zero for a contested ordinary upgrade, and Morgan has the earlier turn.
Result: Morgan wins a fourth item. The first three were uncontested, so they changed no balance or turn. Only the fourth changes contested priority; ordinary wins do not change prized credit. There is no one-item-per-night limit, and those free upgrades did not take an item Alex wanted.
2. “Alex beat me last time. I was owed the next one.”
Blair loses to Alex, wins another prize against other people, and later faces Alex again. In section 5’s fourth contest, both have -1/3 and Alex has the earlier turn.
Result: Alex wins again. Intervening contests changed both records. Blair’s loss earned credit, not a separate right against Alex; records follow the category and season, not one opponent.
3. “I’m first on the ladder. Why didn’t I get it?”
Drew has the highest prized credit, but the item does not meet Drew’s approved needs. Alex and Blair are the only valid claimants in the selected group.
Result: Drew is excluded, gets no credit, and keeps the same turn. Quartermaster compares Alex and Blair. A negative balance can win when no selected claimant outranks it. A preview must show the item, group, season, and checkpoint; it cannot promise the next prized drop in general.
4. “The first prize is still just luck.”
Several people claim the first prize of the first season. They have zero credit, and several equal-credit contests may happen that night.
Result: The published starting turn order breaks each tie. Each confirmed contested award changes credit and turns. Later seasons inherit their starting turns instead of drawing again.
The first order is random. Rare drops can leave people waiting; the system cannot guarantee another drop or show that the first winner deserved it more.
9. Questions about recruits
When recruit claims take priority.
5. “They finished their trial and jumped the queue.”
An established member and a newly qualified member both have zero prized credit. The established member was waiting before the recruit enrolled and has not moved back by winning.
Result: The established member wins the tie because their turn is earlier. Qualification does not move the recruit or reset their account.
Credit still comes first. If the recruit has 0 and the established member has -0.5, the recruit wins when both are in the same group. Neither time in the guild nor having never won gives extra priority.
6. “A recruit got a prized item on their first night.”
No qualified main-spec member claims the prize, and one recruit genuinely needs it for main spec.
Result: The recruit gets it uncontested with no balance or turn change. Several recruit claims compete in the prized ledger. Early fallback awards, credit, and turn changes remain after promotion. Qualified priority is protected, but a recruit is not barred from an otherwise unclaimed prize.
A recruit may receive that item and later leave. Preventing every such loss would mean leaving some usable loot unawarded.
7. “My offspec should beat a recruit’s main spec.”
A qualified member claims a prize for offspec. No qualified main-spec member needs it, but a recruit has a valid main-spec claim.
Result: Recruit main-spec is selected. The qualified offspec claim is excluded and earns no credit. Use the recruit’s prized main-spec ledger, because main-spec gearing comes before offspec collection.
8. “My balance is higher. Why wasn’t it compared?”
A recruit has +0.5 prized credit from an earlier recruit contest. A qualified main-spec claimant has -0.5. Both want the prize.
Result: Qualified main-spec is selected first. If that claimant is alone in the group, the award is uncontested despite the recruit’s claim, and the recruit gets no credit. Choose the group before comparing credit; the recruit keeps +0.5 for later. At launch, everyone may compete in recruit groups, with no founder exemption.
10. Questions about claims and passing
Passing, gear needs, and credit for a loss.
9. “They passed on upgrades to save for the jackpot.”
Alex passes on a lesser prized item. Blair and Casey compete at zero; Blair wins. Alex stays at 0, Blair falls to -0.5, and Casey rises to +0.5. Later, only Alex and Blair need another prize.
Result: Alex wins on credit. Passing earned nothing but preserved Alex’s balance. Blair spent credit because Casey also wanted the first item; a sole claim would have cost nothing.
Members may pass on unwanted optional gear without a penalty. Keeping the prized list small limits the reason to save credit, but does not remove it. Raid readiness is handled separately.
10. “I’ll claim for losing credit and refuse when I win.”
A player claims unwanted items to collect +1/N losses, then withdraws when selected. Another passes main-spec and asks for the same physical drop as offspec.
Result: Neither is allowed. Claim only items you need and will accept at the normal cost. Passing also prevents an offspec claim for that same copy.
Correct invalid claims before delivery and before recording final credit changes. Correct honest errors; treat repeated deliberate false claims as a conduct issue. The software cannot tell whether a player is sincere.
11. “I clicked Need by mistake, or realized the item is not an upgrade.”
A player clicks the wrong button during the claim window, or notices before delivery that the drop breaks a set bonus or duplicates an owned slot.
Result: A wrong button is yours to fix while the 30-second window is open: change it before the window closes. After the window closes, only a factual pass is possible, before delivery: you already have the item, or it breaks a set bonus. Need cannot change to Offspec after the window closes. For a factual pass, pause the award, check the facts, and mark the pass. Recalculate any later undelivered awards that depend on it. Do not charge credit for an undelivered item. If one drop removes your need for a different item, use the same factual pass on that item before its delivery.
A player cannot withdraw an otherwise valid claim after seeing the winner just to avoid its credit cost. Repeated deliberate false claims are a conduct issue reviewed after the raid.
12. “Why is my loss worth less in a bigger group?”
A loser in a two-person contest gains +1/2. A loser in a ten-person contest gains +1/10.
Result: Both are correct. One credit is divided among the selected claimants, so each gets 1/N. The winners’ net changes are -1/2 and -9/10. Each contest totals zero.
Every claim must meet the same need and acceptance rules. Do not add someone who could use the item but does not want it.
11. Questions about drop order, attendance, and characters
Drop order, bench time, and character changes.
13. “Processing the ring first changed who got the trinket.”
Alex and Blair need two prizes from one boss. Their credit is equal, and Alex has the earlier turn. Alex gets the first item; Blair’s higher resulting credit wins the second.
Result: Reversing the order would swap the items. The saved batch order (prized items first, then the fixed key of section 4) fixes the order, not an officer’s preference or trade-click order. An earlier acquisition can remove a later need, and duplicate copies follow the same rules. The order is repeatable, not an attempt to optimize everyone’s ideal batch.
14. “I was benched. Why didn’t I earn loot credit?”
A member serves the required time on the formal bench but cannot receive the boss’s drops. Another misses a week and returns with positive credit.
Result: Assigned bench time counts toward qualification. An officer marks it in Discord with /officer raid bench, from the scheduled start, also when the raid starts late. Bench time and raid time add up toward the 60 minutes, and a minute that is both counts once. Neither player earns loot credit for a contest they could not enter.
Absence leaves credit and turns unchanged, including negative balances. Other players’ awards can still change who ranks ahead. Repeated benching is a roster issue; do not compensate by secretly changing credit.
15. “This is my sixth raid. Am I qualified for this boss?”
A recruit enters a sixth possibly credited session. Another adds optional hours, and a third attends less than the published minimum.
Result: Qualification begins at the next raid, after the sixth credited raid ends. It does not begin on day 21 or partway through a boss.
Count active and assigned-bench time once within the scheduled window. Optional hours do not substitute. A raid shorter than 60 minutes does not count, even if the guild shortened or cancelled it.
16. “Can I change characters and start at zero?”
A member with negative credit switches to an approved alt, changes role, or leaves and returns in the same season.
Result: The permanent member record keeps credit, turn, and qualification history. Changing your approved role changes which drops qualify for main spec, but one person cannot claim twice through different characters. A character change does not erase awards, and a new season resets accounting for everyone only at the published transition. You cannot switch your approved main spec after seeing a drop.
12. Questions about decisions and mistakes
Officer decisions, failed trades, and record errors.
17. “The officer wants it to go to a better player.”
Quartermaster selects Alex, but an officer prefers Blair for performance, donations, leadership, or a claimed raid-wide benefit and wants to reclassify the drop.
Result: The officer cannot replace Alex with a preferred winner. Eligibility, the published item catalogue, group, credit, and turn decide.
Correct documented factual errors. Address performance and conduct separately from loot. Any policy change must apply at an announced future point, not to this award.
18. “The trade failed. Did I still lose my credit?”
The addon proposes an award, delivery fails, and later batch previews depend on it.
Result: No delivery means no final credit or turn change. Fix the failure, then recalculate the remaining undelivered awards that depended on it.
If the winner left the raid group, or was offline and did not reconnect before the raid ended, the item goes to the next valid claimant, and the winner’s credit does not change. If the item cannot be delivered at all, an officer marks it undelivered, and nobody’s credit changes.
Refusing a valid claim is a conduct issue, but it is not proof of delivery. If the item went to the wrong person, an officer records it as an incident and resolves it. The incident is visible and does not change the books automatically. Do not invent a credit charge or hide the error.
19. “Discord disagrees, or that item was uploaded twice.”
Discord has an older checkpoint, the companion retries an upload, or several addons report one copy. Someone attempts a policy edit during the raid.
Result: Only the authorized raid writer can update the active session. Discord shows its last verified checkpoint and sync status. The server processes each confirmed event once, so duplicate reports cannot charge twice.
A cloud edit cannot change the raid’s locked rules. Show conflicts and stop affected imports. Do not manually enter drops into a second, competing ledger.
20. “Both balances say 0.33. Why wasn’t my turn used?”
Alex has exactly 1/3 credit, about 0.33333. Blair has 23/70, about 0.32857, and an earlier turn. Both display as 0.33 to two decimals.
Result: Alex has more exact credit, so the turn is not used. The details view must show exact values and the comparison that decided the award. Rounded values are not necessarily equal; addon and server arithmetic must agree.
13. Questions about old credit and old items
What happens to old credit and unfinished gear needs.
21. “I saved three credits. Why can’t I spend them in the new raid?”
Alex built a large positive prized balance in the old season and expects to spend it on several new-season prizes.
Result: The old balance stays in the closed ledger. It sets Alex’s place when we copy the full old ladder, but all new-season credit starts at zero. No old numerical stockpile transfers. Announce this before end-of-season planning.
Use the full credit-then-turn order. Copying only old turns would ignore Alex’s positive credit.
22. “They won on the last night, and now their debt is gone.”
Casey wins a contested prize shortly before the snapshot, ends the old season with negative credit, and starts the new season at zero.
Result: Casey’s negative old balance remains and affects the closing order; it does not become negative new credit. Casey can still win new loot if the people ahead are not selected claimants. A new season carries relative priority, not indefinite debt, and does not require everyone to receive one item before another win.
Awards confirmed before the snapshot affect the inherited order. Later old-season awards do not change the new starting order.
23. “My old best-in-slot item still matters. Did you delete my place?”
Alex still needs an old prized trinket and has positive old credit. It drops in a later scheduled raid, while Alex also has a new-season place.
Result: The old season is closed, so the trinket is not booked. It goes to the officers as a conflict, and an officer records the delivery by hand as an incident. No old credit or turn changes, and no new priority is spent or recalculated. Alex’s new place stays as copied.
The published item mapping decides the season. Running an old raid later, or calling it a catch-up run, does not move its loot into a newer ledger.
14. Questions about season changes
Trial progress, new raids, and passing before a reset.
24. “Does a new tier restart my trial or give me another lottery?”
A recruit has four credited raids when the season changes. A qualified member is absent when the snapshot is taken, and a new member enrolls afterward.
Result: The recruit still needs two more credited raids, then qualifies at the following raid. The qualified member stays qualified and keeps the inherited record despite being absent. The new member starts at zero and joins the back. A returning member uses their existing record.
A season change does not start a new trial or lottery. Members must still meet the attendance and eligibility rules to claim current drops.
Qualification does not clear existing balances, recruit awards, or turns. Records present at the snapshot determine the inherited order. Later enrollment does not reorder those members.
25. “A new raid opened. Why haven’t you reset us?”
New bosses extend the current gearing period. Some members want a reset; others want to keep their balances. Someone asks to take the snapshot before a final award reaches the server.
Result: Only the announced season boundary creates new ledgers. A new raid may use the existing season. Include every confirmed award when checking the closing records; do not choose a partial history. Members cannot choose their own season or snapshot date. Publish the item mappings, source season, exact checkpoint, and resulting orders.
An error found after new-season awards have been delivered needs a recorded cross-season correction. Do not silently reroll or erase the original snapshot and award history.
26. “Why take an upgrade before the snapshot if passing preserves my place?”
Blair can accept an optional contested late-season item or pass to preserve a stronger closing balance and inherited new turn.
Result: A valid pass earns nothing but may preserve the inherited place. Taking the item changes old credit and may change that place. A free uncontested upgrade changes neither. This incentive remains whenever some history carries forward; we allow honest preferences and transfer order, not a full credit balance.
Keep the prized list small and the snapshot date predictable. Members must still prepare for raids and make honest claims. Do not add a late passing penalty, move the snapshot date, or make an officer exception to force a choice.
15. Records and allocation rules
The records and calculations the software must keep.
Records the system must keep
For each permanent member, keep identity, linked characters, approved main spec and role, eligibility, and completed credited sessions. Attendance and qualification do not belong to a loot season.
For each member + season + ledger, keep exact credit and one unique turn sequence. Keep the next sequence number for each ledger. Award history explains a decision; it does not add a hidden never-winner rule.
For each season, keep item-to-season mappings, the source season, effective boundary, a fixed transition snapshot, and inherited orders. For each raid, keep the locked policy and catalogue versions, qualification at the start, authorized writer, checkpoint, and draw seeds.
For each physical item, keep batch and copy IDs, processing position, valid and excluded claims with reasons, selected group, season, ledger, proposed result, delivery proof, and before/after state. Keep reasons and dependencies for corrections.
Keep an append-only incident ledger (section 4) and the bench marks of each raid. Everything is recorded locally and backed up in the cloud record, which is the official record:
- The addon keeps every event it records until the upload is confirmed, and for 30 days after that. Only then does it remove the event. It shows the incidents, bench marks, and corrections that come down from the cloud record, read only.
- The uploader keeps its own local archive: one file for each raid, with one line for each event it uploads and each cloud record it receives. It never deletes the archive.
- The cloud record keeps the incident ledger, the bench marks, and the awards. It can be restored to any point in the last 30 days.
Allocation steps
The software must use this contract:
claims = validate_window_claims(drop, session, prior_batch_awards)
group = first_nonempty_priority_group(drop.category, claims)
ledger = account_for(drop.season, group, drop.category)
if size(group) == 0:
propose unallocated outcome; no priority changes
elif size(group) == 1:
propose uncontested award; no credit or turn changes
else:
winner = first(sort(group, credit DESC, turn ASC))
propose each selected claimant += 1 / size(group)
propose winner -= 1
propose winner.turn = next_turn_sequence(ledger)
commit proposed changes once, on confirmed delivery
First choose a result; then record it only after delivery is confirmed. Replay must get the same claims and winner, not trust a client-supplied winner or balance. Addon and server must use the same fixed data format, exact arithmetic, and stable IDs. Unsupported claimant counts or number limits must fail clearly instead of rounding.
Joining and changing seasons
A new member appends a zero-credit record to each relevant ledger under the permanent identity. A returning member reuses the old records. Qualification changes the selected claim tier only at a session boundary; it does not create another prized account.
For a season change, sort each complete old ledger by credit then turn, write that order as unique new turns, and set new balances to zero. Save the change as one checked operation without changing old records. Keep its source checkpoint and item mapping in the audit record.
Every change needs authorization, version checks, processing that ignores an exact repeated event, and a lasting record. An editable balance spreadsheet, silent correction, or AI-selected recipient is not part of this design.
16. Addon, Discord, and cloud service
How the addon and Discord tools work.
What each part does
Quartermaster addon: Every raider installs the addon. In raider mode, it shows usable boss drops for live Need, Offspec, or Pass claims during the claim window. In loot-master mode, one designated officer writer collects live claims, calculates locally, confirms delivery, shows exact reasons, and saves a recoverable session transcript. Stand-in officers follow checkpoints and can take over loot.
Quartermaster service: The server stores the verified records, policy, member identities, approved roles, saved claim logs, qualification, and season snapshots.
Quartermaster in Discord: Members inspect the same verified record, link characters, set their approved main spec and role more than 30 minutes before raid start, and retrieve award reasons. Officers record incidents, corrections, bench marks, the prized list, item seasons, and Legendary assignments there. Discord runs no live loot: there is no claim card, and no claim, close, or delivery happens in Discord. One session summary is better than posting every item in chat.
Raid-leader companion: Transfers prepared session packages and saved raid records between the addon and server. It does not need a continuous addon-to-web connection.
How one raid moves through the system
Before the raid, the service makes a numbered session package with ledger checkpoints, prized catalogue, approved roles, and qualification. The officer companion loads it through the verified client workflow. Both sides show the package number and authorized writer.
During the raid, the addon uses that prepared data. Cloud edits cannot independently change the active ledger. A prepared session must work without a live Discord connection. The cloud must clearly show its last verified checkpoint.
After the session is safely saved, the companion uploads its record. The server checks and replays confirmed events, rejects conflicts, ignores exact repeats, and publishes a summary. All confirmed awards must be included before the next session or season snapshot.
Member commands
| Command | Purpose |
|---|---|
/loot me |
Credit, turns, qualification, and current checkpoint by season |
/loot item |
Eligible group and current priority preview for a specific item |
/loot why |
Exact inputs and reason for a recorded award |
/loot incidents |
The loot incidents about you, with their resolution |
/me profile |
Declared character, approved main spec, and raid role |
Linking, publishing policy, and corrections need separate authenticated actions. Officers record incidents with /officer loot incident, resolve them with /officer loot resolve, list them with /officer loot incidents, and mark the bench with /officer raid bench. Each of these also works in chat with the bot.
17. Administration
Published rules, access, and corrections.
Published rules
Publish the prized list, published Legendary assignments, item-to-season mappings, approved roles, claim window length (30 seconds), valid needs for multiple copies, starting roster and draw procedure, rules for unclaimed items, and season boundary. Publish a guest policy before any guest joins. There are no reserved-item exceptions except published Legendary assignments, and no founder exemptions, attendance points, or weekly resets.
Also publish membership checks, role-change deadlines, how to identify a complete boss batch, and who may make corrections. Any officer or the Guild Master records and resolves loot incidents and marks the bench. Administration checks and corrects facts; it cannot select a preferred winner.
Access and records
Restrict access by guild. Allow one authorized writer per session. Companion credentials must be revocable, and server secrets must stay on the server. Check data structure, versions, signatures where implemented, and exact arithmetic limits. Keep a record of every change.
Show errors clearly with a next action. Label outdated records and pending deliveries. Do not hide a failure by letting an officer or an AI choose the winner.