The Violet Ledger
A guild progression and requisition system for the Magus Senate of Dalaran.
The Violet Ledger is a full-featured in-game management addon built exclusively for the Magus Senate of Dalaran on Moon Guard (US). It brings the guild's requisition board, commendation point tracking, division reputation system, and officer tools directly into WoW — no spreadsheets, no external tools, no Discord forms.
✦ Features
📋 Requisition Board
Post, claim, and complete RP tasks directly in-game. Officers review submitted summaries and approve completions to award points and reputation.
- Division tagging — Tag requisitions to Collegium, Vanguard, Conservatory, or Chancellery
- D20 mechanic — Optional dice system auto-detects
/roll 20results. Full reward on 15–20, half on 10–14, none on 1–9 - Co-authoring — Unlocked at Division Reputation Level 12
- Expiry dates — Expired requisitions are automatically flagged by the sync authority
🏅 Commendation Points
Per-character point tracking with promotion thresholds. When a character qualifies for promotion, officers are alerted in the Officer Panel.
| From | To | Points Required |
|---|---|---|
| Junior Senator | Senator | 5 |
| Senator | Senior Senator | 15 |
| Senior Senator | Magocrat | 25 |
| Magocrat | Senior Magocrat | 35 |
| Senior Magocrat | High Magocrat | 50 |
Ranks above High Magocrat are filled by appointment only.
⚗️ Division Reputation
Three divisions — Collegium, Vanguard, and Conservatory — each with 20 reputation levels on a progressive curve (50 → 500 rep per level). Maximum of 4,800 rep per division.
- 15 title unlocks across all three divisions (at levels 5, 8, 12, 16, and 20)
- Access gates at levels 6, 12, and 18 unlock posting and co-authoring privileges
- The My Progress tab shows a full expandable breakdown of every level, title reward, and gate
👥 Guild Roster
A synced roster of every guild member running the addon. Click any character to open their full card: commendation points, division rep levels, notes, and (for officers) editing controls.
📢 Bulletin Board
Guild-wide announcement feed. Automated entries post for promotions, division recognition, and requisition completions. Officers can post and delete manual announcements.
⚔️ Officer Panel
Accessible to characters with officer permissions. Shows promotion-ready characters, pending RP completion reviews, and commendation recommendations awaiting approval.
💾 Backup & Restore
- Export/Import — Compressed, encoded backup strings for safekeeping or transfer
- Automatic snapshots — Up to 10 snapshots on logout, daily login, and after data changes
- Restore — Chancellor can restore from any snapshot or export string
- Data Wipe — Chancellor-initiated with a 60-second countdown; Councilors can cancel
⚙️ Guild Settings
The Chancellor can configure every permission in the addon by rank — from who can post requisitions to who can restore from backup — and settings sync guild-wide automatically.
🔄 Sync System
All guild members running the addon see the same live data through a distributed sync model:
- Authority election — The highest-ranking online officer (Chancellor › Councilor › Archmage) becomes the sync authority
- Delta broadcasting — All mutations are validated by the authority and broadcast as deltas
- Offline queuing — Members who come online receive queued updates from the authority
- Conflict resolution — Last-write-wins by version number
📦 Installation
Required Dependencies
- Ace3 — Install from CurseForge
- LibDBIcon-1.0 — Install from CurseForge
LibDeflate is bundled directly in the addon and does not need to be installed separately.
Steps
- Install Ace3 and LibDBIcon-1.0 from CurseForge (or let your client manager handle it)
- Install The Violet Ledger into your
Interface/AddOns/directory - Restart WoW or
/reload
⚠️ This addon only activates for members of the Magus Senate of Dalaran guild. It will silently do nothing for all other characters.
🖥️ Slash Commands
| Command | Action |
|---|---|
/vc |
Open or close the main window |
/vc help |
Show all available commands |
/vc reset |
Reset window position to center |
/vc debug |
Toggle debug output |
/vc version |
Display the addon version |
📑 Tabs
| Tab | Description |
|---|---|
| Board | Browse, filter, claim, and post requisitions |
| My Progress | Commendation points, division rep, titles, and access gates |
| Roster | Sortable guild member list with clickable character cards |
| Bulletin | Read announcements and post officer notices |
| Officers | Manage promotions, review completions, handle recommendations |
| Backup | Export, import, restore snapshots, initiate data wipes |
Officers and Backup tabs are only visible to characters with the appropriate rank permissions.
⚙️ Technical Details
- Game version: WoW Retail 12.x (Midnight) — Interface
120001 - Framework: Ace3 (AceAddon, AceComm, AceDB, AceSerializer, AceGUI)
- Minimap: LibDBIcon-1.0 with graceful fallback to a custom button if not installed
- Compression: LibDeflate (bundled) for sync payloads, snapshots, and export strings
- Sync channel:
VC_SYNCover AceComm GUILD - Saved variables:
VioletLedgerDB(guild-wide) ·VioletLedgerCharDB(per-character) - UI: Native WoW frames with Blizzard atlas textures (parchment, gold borders) for a Kirin Tor aesthetic
Created for the Magus Senate of Dalaran — Moon Guard (US). All rights reserved.
The The Violet Ledger Team
