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 20 results. 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_SYNC over 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