BijouRR - Automated Round-Robin Loot Distribution for Classic Era

Tired of manually distributing ZG coins and bijous one by one to 40 raid members? BijouRR handles it all automatically.

BijouRR is a raid loot utility for WoW Classic Era that automates round-robin distribution of consumable loot (ZG coins, bijous, AQ scarabs, gems, lockboxes, and green gear) while intelligently routing crafting materials directly to the Master Looter's bags—all without any manual intervention from the raid leader.

What's New

v1.2.10 (2026-07-22) - Classic Era API Update Compatibility

• Fixed: BijouRR would fail to load after the latest WoW Classic Era game update — it now loads and runs normally again. Update to this version if the addon stopped working after patch day.

Core Features

Round-Robin Distribution

• Fully Automatic: As the Master Looter, simply open the loot window — BijouRR distributes eligible items without any clicks
• Fair Rotation: Tracks who received what across the entire raid session; no one gets two of the same category until everyone has had one
• Session Guards: Per-loot-window duplicate protection prevents the same player receiving two bijous (or coins, etc.) from a single boss drop
• 1-Hour Reset: Rotation state resets automatically if the raid is offline for more than an hour — picks up seamlessly if you relog mid-session
• Supported Item Types: ZG Coins, ZG Bijous, AQ Scarabs, Gems, Lockboxes, Green Equipment, all Common (white) items such as Hourglass Sand and Runecloth, and all Junk (grey) items (Common and Junk are opt-in)

Master Looter Data Pack System

• Automatic Routing: Items in enabled data packs are sent directly to the Master Looter's bags instead of being rolled out
• Molten Core Pack: Fiery Core, Lava Core, and crafting mats — sent to ML for officer distribution
• Blackwing Lair Pack: Elementium Ore and BWL crafting materials
• Zul'Gurub Pack: Bloodvine and ZG crafting materials
• Ahn'Qiraj Pack: All Qiraji Idols from AQ20 and AQ40 — configurable per raid tier
• Connected-Realm Aware: Candidate matching on connected-realm clusters correctly handles PlayerName-RealmName format

Exclusion System

• Various Pack: Items that should be left for manual distribution (e.g. Demonic Rune) — completely ignored by the addon
• Auto-Detection: Profession recipes (Recipe:, Pattern:, Plans:, Formula:, Schematic:, Design:) and class spell books (Book of, Tome of) are automatically excluded without any configuration
• Manual Exclusions: Add specific item IDs to the exclusion list on the fly

Configuration UI

• One-Stop Setup: Open with /brrconfig or ESC → Interface → AddOns → BijouRR
• Per-Category Toggles: Enable or disable each item type and each data pack independently
• Settings Persist: All configuration survives logout, reload, and game updates

How It Works

Distribution Priority (in order)

1. Various Pack / Auto-Excluded: Item is completely ignored — left in loot window for manual handling
2. Master Looter Data Pack: Item is sent directly to the ML's bags (if corresponding pack is enabled)
3. Round-Robin Category: Item is distributed to the next player in the rotation for that category
4. Unrecognized: Item is left untouched for manual distribution

Setup (One-Time)

1. Install BijouRR and enable it in your AddOns list
2. Open configuration: /brrconfig
3. Check the item categories you want to auto-distribute (Coins, Bijous, Scarabs, etc.)
4. Check the data packs for items that should go to the Master Looter (MC Crafting, BWL, ZG, AQ)
5. In your raid, set yourself as Master Looter
6. Open the loot window — BijouRR handles the rest

Master Looter Setup

1. Run /bijoumaster setmaster YourCharacterName once (saved permanently)
2. BijouRR auto-detects the current ML from the raid frame each session
3. Use /bijoumaster status to confirm loot method and data pack state

Commands

Main Commands (/brr)

• /brr — Toggle addon on/off
• /brr status — Show current cycle status and loot history
• /brr history — Display full record of all loot distributed this session
• /brr reset — Reset all loot tracking counters
• /brr log — Toggle debug logging on/off
• /brr excluded — Show all manually excluded items
• /brr coin / /brr bijou / /brr scarab / /brr green / /brr gems / /brr lockboxes / /brr common / /brr junk — Toggle individual categories (/brr common and /brr junk also lower the loot threshold to Common / Poor)
• /brr threshold poor / /brr threshold common / /brr threshold uncommon — Manually set the loot threshold
• /brrconfig — Open configuration window

Master Looter Commands (/bijoumaster)

• /bijoumaster enable / disable — Enable or disable the ML designation system
• /bijoumaster status — Show loot method, master looter, and data pack state
• /bijoumaster setmaster <name> — Set fallback ML name for when auto-detection is unavailable
• /bijoumaster testitem <itemID> — Preview exactly how a specific item will be handled
• /bijoumaster help — Show all master looter commands

Testing Example

/bijoumaster testitem 12662   -- Demonic Rune → shows "COMPLETELY IGNORED" (Various pack)
/bijoumaster testitem 17010   -- Fiery Core → shows "SEND TO MASTER LOOTER" (MC pack)
/bijoumaster testitem 22526   -- ZG Coin → shows "ROUND-ROBIN DISTRIBUTE"

Data Packs

Master Looter Packs (items sent to ML bags)

• Molten Core — Fiery Core (17010), Lava Core (17011), Sulfuron Ingot (11382), and other MC crafting materials
• Blackwing Lair — Elementium Ore (18562)
• Zul'Gurub — Bloodvine (19726) and ZG drop-only crafting materials
• Ahn'Qiraj — All Qiraji Idols from AQ20 (20866–20868) and AQ40 (20869–20876); AQ40 configurable separately

Exclusion Pack (items left for manual looting)

• Various — Demonic Rune (12662), Onyxia Hide Backpack, Sacks of Gems, and other items added by the raid leader as needed

Technical Details

• WoW Classic Era: Interface version 11508 — not compatible with Wrath, Cata, or retail
• Ace3 Framework: Built on AceAddon-3.0, AceConsole-3.0, AceConfig-3.0, AceConfigDialog-3.0, AceGUI-3.0 (loaded from the shared Ace3 addon — must be installed)
• Master Looter API: Uses GetMasterLootCandidate / GiveMasterLoot — requires the player to be the Master Looter in the raid
• SavedVariables: All settings and rotation state persist across sessions via WoW's SavedVariables system
• No External Dependencies: Beyond Ace3, requires no other addons

Frequently Asked Questions

Do I have to be Master Looter?
Yes. BijouRR uses the WoW Master Loot API to distribute items. You must be the Master Looter in your raid group.

Will it distribute epic gear?
No. BijouRR only distributes the item categories you explicitly enable (coins, bijous, scarabs, greens, gems, lockboxes). Boss epics are left untouched for manual distribution.

What happens to items not in any data pack or category?
They are ignored entirely — left in the loot window for you to distribute manually.

I'm on a connected realm — will candidate detection work?
Yes. BijouRR v1.2.7+ includes realm-aware candidate matching. PlayerName-RealmName format from GetMasterLootCandidate is handled correctly.

How do I add an item to the Various (ignore) list?
Edit Data Packs\Various.lua and add the item ID to the BRR_VARIOUS_ITEMS table. Reload your UI.

Can I see what happened to all the loot last raid?
Use /brr history to see the full distribution log for the current session.

Bug Reports & Feature Requests

Found a bug or have a suggestion?

If you have any questions, comments or anything else, please feel free to reach out on Discord!

Recent Updates

v1.2.10 (2026-07-22) — Classic Era API Update Compatibility

• Fixed: BijouRR failed to load after the latest WoW Classic Era game update; it loads and runs normally again. Grab this version if the addon stopped working on patch day

v1.2.9 (2026-07-09) — Common Item Distribution, AQ Idol Split & Fixes

• New: "Distribute Common Items" — one toggle that round-robins all common (white) items (Hourglass Sand, Runecloth, white gear) to the raid and lowers the loot threshold to Common when you lead a raid. Off by default. While on, all white items route through the Master Looter, and a dropped stack goes to one player since the game cannot split a stack while looting. Coins, bijous, scarabs, gems, and lockboxes keep their own rotations
• New: "Distribute Junk Items" — the same one tier lower for grey/junk items, lowering the threshold to Poor. Enable both Common and Junk and the Master Looter hands out essentially everything the raid drops
• New: Separate AQ20 and AQ40 idol toggles — route Ruins of Ahn'Qiraj idols to the Master Looter independently of Temple of Ahn'Qiraj. If you had the old combined "AQ Items" option on, enable the new AQ20 toggle to keep routing AQ20 idols
• Fixed: Items added to a data pack in an update now apply automatically on your next login instead of being ignored until you toggled the pack off and on again
• Fixed: "Completed X/Y" counts and the per-player status breakdown now display correct, properly formatted totals
• Fixed: Corrected a mislabeled item in the exclusion list (Onyxia Hide Backpack); no change in play, just cleaner data

v1.2.8 (2026-04-02) — Core Bug Fixes

• Fixed: Rotation lists wiped on every login — logged_off_time was local and invisible to SavedVariables, defeating the 1-hour session guard
• Fixed: Per-loot-window duplicate-receive guard non-functional for coins, bijous, scarabs, gems, and lockboxes — session receiver tables were never passed into the distribute functions
• Fixed: Master loot candidate matching broken on connected realms — GetMasterLootCandidate returns PlayerName-RealmName; new CandidateMatches helper handles realm-aware comparison for both ML designation branches
• Fixed: Named-player ML branch used wrong loop cap (GetNumGroupMembers() instead of nil-break at 40)
• Fixed: Hardcoded "pickyminer" fallback ML name removed — defaults to nil, fails gracefully; configure with /bijoumaster setmaster <name>
• Removed: Dead IsClassBook function and itemIsClassBook variable (zero callers)

v1.2.7 (2026-04-02) — Persistence & Settings Fixes

• Fixed: BRR_LOGGING verbosity setting not listed in SavedVariables — the debug toggle reverted to true (debug spam on) every login; now correctly persists across sessions
• Fixed: BRR_VARIOUS_ENABLED and BRR_AQ40_ITEMS_TO_MASTER had no default values — evaluated as nil instead of false on a fresh install, causing inconsistent boolean logic in loot guards
• Changed: BRR_LOGGING now defaults to false — debug output is opt-in; existing users with logging saved as enabled are unaffected

2025-11-20 — Mojo of Madness to Various Pack

• New: Added Mojo of Madness drops to the Various data pack — these items are now completely ignored by the auto-distributor and left for manual handling

Credits

Developed by:

• Kaytooben — Original Developer
• Pimptasty — BijouRR Revived Fork Developer

Special Thanks:

• The Old Gods guild community for testing and feedback
• Ace3 library maintainers for the excellent framework
• WoW Classic community for feedback and support

License

BijouRR is All Rights Reserved. It is a maintained fork of the original BijouRR by Kaytooben (All Rights Reserved); the original author retains full rights to the original work. See the LICENSE file for details.

---

Download BijouRR today and free your raid leader from distributing coins and bijous by hand!