promotional bannermobile promotional banner
premium banner

BijouRR - Revived

A Bijou and Scarab auto rolling tool for ZG and AQ20 raids.

Description

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.8 (2026-04-02) - Core Bug Fixes & Documentation

  • PERSIST-003: Fixed rotation lists (coins, bijous, scarabs, etc.) being wiped on every login — logged_off_time was declared local and never saved, defeating the 1-hour session guard entirely
  • DIST-001: Fixed per-loot-window duplicate-receive guard being non-functional for all categories except greens — five session receiver tables were declared but never passed into their distribute functions
  • MASTER-001/002: Fixed master loot candidate matching broken on connected-realm clusters — GetMasterLootCandidate returns PlayerName-RealmName which was never handled; added CandidateMatches helper with realm-aware logic used by both branches of DistributeMasterLoot
  • MASTER-003: Removed hardcoded "pickyminer" fallback master looter name — BRR_MASTER_LOOTER_NAME now defaults to nil and fails gracefully with a log message; use /bijoumaster setmaster <name> to configure
  • DEAD-001: Removed unused IsClassBook function and itemIsClassBook local variable (dead code, zero callers)

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

  • PERSIST-001: BRR_LOGGING verbosity setting now correctly persists across sessions — was reverting to debug-on every login
  • PERSIST-002: Added missing defaults for BRR_VARIOUS_ENABLED and BRR_AQ40_ITEMS_TO_MASTER — both evaluated as nil on a fresh install
  • QOL-001: Debug logging now defaults to off — no more debug spam for new installs

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

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 — Toggle individual categories
  • /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.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

2025-11-18 — Ony Hide Backpack to Various Pack

  • New: Added Onyxia Hide Backpack to the Various data pack — prevents it from being rolled out or sent to the ML bag; left for the raid officer to handle manually

2025-11-15 — AQ Data Pack

  • New: Added Ahn'Qiraj data pack covering all Qiraji Idols from AQ20 and AQ40; AQ40 items are behind a separate toggle (Auto-Designate AQ Items) so guilds progressing AQ20-only can enable selectively

2025-11-15 — Various Data Pack, Readme & Config Updates

  • New: Added Various data pack — items excluded from both rolling and the ML bag; completely ignored by the addon and left for manual looting
  • New: Created readme with quick-start guide and command reference
  • Improved: Added UI config options for the Various and AQ data packs

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 open-source software. See LICENSE file for details.

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