From 75ce9c9bd6d581e9bf3b48d2a92142bf4a600ab8 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 27 Mar 2026 20:01:24 +0000 Subject: [PATCH] docs: The Arbiter Discord role mappings completed by Holly MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit COMPLETE DISCORD ROLE CONFIGURATION: - All 10 subscriber tiers mapped to Discord roles - Fire Path: Elemental, Knight, Master, Legend (4 tiers) - Frost Path: Elemental, Knight, Master, Legend (4 tiers) - Universal: Awakened, Sovereign (2 tiers) FIRE PATH ROLE IDS: - Fire Elemental ($5): 1487181476755996823 - Fire Knight ($10): 1487183625751880818 - Fire Master ($15): 1487183822951895546 - Fire Legend ($20): 1487184056387748935 FROST PATH ROLE IDS: - Frost Elemental ($5): 1487184348474218778 - Frost Knight ($10): 1487184476371222558 - Frost Master ($15): 1487184618860249261 - Frost Legend ($20): 1487184718152138865 UNIVERSAL TIER ROLE IDS: - The Awakened ($1): 1482490386634248273 - The Sovereign ($499): 1482488242677874778 INTEGRATION FLOW: Paymenter → The Arbiter → Discord Users automatically receive roles based on subscription tier and path choice DOCUMENTATION INCLUDES: - Complete mapping table - Role hierarchy - How it works explanation - Testing checklist - Troubleshooting guide - Future enhancements plan Completed by: Holly (unicorn20089 / The Catalyst) Date: March 27, 2026 Signed-off-by: Chronicler #43 --- docs/systems/arbiter-discord-role-mappings.md | 227 ++++++++++++++++++ 1 file changed, 227 insertions(+) create mode 100644 docs/systems/arbiter-discord-role-mappings.md diff --git a/docs/systems/arbiter-discord-role-mappings.md b/docs/systems/arbiter-discord-role-mappings.md new file mode 100644 index 0000000..af46157 --- /dev/null +++ b/docs/systems/arbiter-discord-role-mappings.md @@ -0,0 +1,227 @@ +# The Arbiter - Discord Role Mappings + +**Completed By:** Holly (unicorn20089 / The Catalyst) +**Date Completed:** March 27, 2026 +**Purpose:** Discord role assignments for Firefrost Gaming subscription tiers + +--- + +## 🎯 OVERVIEW + +The Arbiter is a Discord bot that automatically assigns roles to subscribers based on their Paymenter subscription tier and chosen path (Fire or Frost). + +**Integration:** Paymenter → The Arbiter → Discord +**Result:** Subscribers get instant Discord access with appropriate tier role + +--- + +## 🔥 FIRE PATH TIERS + +### Fire Elemental ($5/month) +- **Role Name:** Fire Elemental +- **Discord Role ID:** `1487181476755996823` +- **Paymenter Tier:** Fire Elemental ($5) + +### Fire Knight ($10/month) +- **Role Name:** Fire Knight +- **Discord Role ID:** `1487183625751880818` +- **Paymenter Tier:** Fire Knight ($10) + +### Fire Master ($15/month) +- **Role Name:** Fire Master +- **Discord Role ID:** `1487183822951895546` +- **Paymenter Tier:** Fire Master ($15) + +### Fire Legend ($20/month) +- **Role Name:** Fire Legend +- **Discord Role ID:** `1487184056387748935` +- **Paymenter Tier:** Fire Legend ($20) + +--- + +## ❄️ FROST PATH TIERS + +### Frost Elemental ($5/month) +- **Role Name:** Frost Elemental +- **Discord Role ID:** `1487184348474218778` +- **Paymenter Tier:** Frost Elemental ($5) + +### Frost Knight ($10/month) +- **Role Name:** Frost Knight +- **Discord Role ID:** `1487184476371222558` +- **Paymenter Tier:** Frost Knight ($10) + +### Frost Master ($15/month) +- **Role Name:** Frost Master +- **Discord Role ID:** `1487184618860249261` +- **Paymenter Tier:** Frost Master ($15) + +### Frost Legend ($20/month) +- **Role Name:** Frost Legend +- **Discord Role ID:** `1487184718152138865` +- **Paymenter Tier:** Frost Legend ($20) + +--- + +## ⚡ UNIVERSAL TIERS + +### The Awakened ($1/month) +- **Role Name:** The Awakened +- **Discord Role ID:** `1482490386634248273` +- **Paymenter Tier:** Awakened ($1) +- **Notes:** Entry-level tier, access to all servers regardless of path + +### The Sovereign ($499/month) +- **Role Name:** The Sovereign +- **Discord Role ID:** `1482488242677874778` +- **Paymenter Tier:** Founder ($50) + Custom tier +- **Notes:** Lifetime founder tier with exclusive benefits + +--- + +## 📊 COMPLETE MAPPING TABLE + +| Tier Name | Price | Path | Discord Role ID | Role Name | +|-----------|-------|------|-----------------|-----------| +| Awakened | $1 | Universal | 1482490386634248273 | The Awakened | +| Fire Elemental | $5 | Fire | 1487181476755996823 | Fire Elemental | +| Frost Elemental | $5 | Frost | 1487184348474218778 | Frost Elemental | +| Fire Knight | $10 | Fire | 1487183625751880818 | Fire Knight | +| Frost Knight | $10 | Frost | 1487184476371222558 | Frost Knight | +| Fire Master | $15 | Fire | 1487183822951895546 | Fire Master | +| Frost Master | $15 | Frost | 1487184618860249261 | Frost Master | +| Fire Legend | $20 | Fire | 1487184056387748935 | Fire Legend | +| Frost Legend | $20 | Frost | 1487184718152138865 | Frost Legend | +| Sovereign | $499 | Universal | 1482488242677874778 | The Sovereign | + +--- + +## 🔧 HOW IT WORKS + +1. **User subscribes** via Paymenter (firefrostgaming.com/subscribe) +2. **User selects tier** (Awakened, Elemental, Knight, Master, Legend, Founder) +3. **User chooses path** (Fire or Frost) - *except Awakened and Sovereign which are universal* +4. **Paymenter webhook** sends subscription data to The Arbiter +5. **The Arbiter** assigns corresponding Discord role +6. **User gains access** to subscriber channels and their path-specific areas + +--- + +## 🎨 ROLE HIERARCHY + +**Highest → Lowest:** +1. The Sovereign (Founder $50) +2. Fire/Frost Legend ($20) +3. Fire/Frost Master ($15) +4. Fire/Frost Knight ($10) +5. Fire/Frost Elemental ($5) +6. The Awakened ($1) + +**Note:** Higher tiers include all benefits of lower tiers within their path. + +--- + +## 🔐 SECURITY & TESTING + +**Testing Checklist:** +- [ ] Test Awakened ($1) subscription → Role assignment +- [ ] Test Fire Elemental ($5) subscription → Role assignment +- [ ] Test Frost Elemental ($5) subscription → Role assignment +- [ ] Test Fire Knight ($10) subscription → Role assignment +- [ ] Test Frost Knight ($10) subscription → Role assignment +- [ ] Test Fire Master ($15) subscription → Role assignment +- [ ] Test Frost Master ($15) subscription → Role assignment +- [ ] Test Fire Legend ($20) subscription → Role assignment +- [ ] Test Frost Legend ($20) subscription → Role assignment +- [ ] Test Sovereign ($499) subscription → Role assignment +- [ ] Test role removal on subscription cancellation +- [ ] Test role update on tier upgrade/downgrade + +--- + +## 📝 ADMIN NOTES + +**The Arbiter Admin Panel:** +- **URL:** [Insert Arbiter admin URL] +- **Access:** Michael (frostystyle), Meg (GingerFury), Holly (unicorn20089) +- **Last Updated:** March 27, 2026 by Holly + +**Role Color Scheme:** +- Fire roles: Orange/Red tones (#FF6B35) +- Frost roles: Cyan/Teal tones (#4ECDC4) +- Universal roles: Purple/Gold tones (#A855F7, #FFD700) + +--- + +## 🚨 TROUBLESHOOTING + +**Issue: User subscribed but no Discord role** +1. Check Paymenter webhook logs +2. Check The Arbiter logs +3. Verify Discord role IDs match +4. Manually assign role if needed + +**Issue: Wrong role assigned** +1. Verify user selected correct path in Paymenter +2. Check role mapping table +3. Remove incorrect role, assign correct role +4. Report bug to The Arbiter developer + +**Issue: Role not removed on cancellation** +1. Check Paymenter cancellation webhook +2. Check The Arbiter webhook reception +3. Manually remove role if needed +4. Update webhook configuration + +--- + +## 📞 SUPPORT + +**For Role Issues:** +- Contact: Michael (The Wizard) - Technical/Backend +- Contact: Meg (The Emissary) - Discord/Community +- Contact: Holly (The Catalyst) - The Arbiter configuration + +**The Arbiter Developer:** +- [Developer contact info if applicable] + +--- + +## 🔄 MAINTENANCE + +**Regular Tasks:** +- Weekly: Verify role assignments are working +- Monthly: Audit role assignments vs active subscriptions +- Quarterly: Review role hierarchy and permissions + +**Change Log:** +- **2026-03-27:** Initial role mapping completed by Holly + - 10 tiers configured + - All Discord role IDs assigned + - Fire/Frost paths configured + - Universal tiers (Awakened, Sovereign) configured + +--- + +## 🎯 FUTURE ENHANCEMENTS + +**Planned:** +- [ ] Automatic role color assignment based on path +- [ ] Tier-specific channel access automation +- [ ] Welcome messages with tier benefits +- [ ] Anniversary role badges +- [ ] Path-switching capability + +**Under Consideration:** +- Custom role icons for higher tiers +- Tier-specific emojis +- Exclusive voice channels per tier +- Tier achievements and milestones + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️ + +**Completed by:** Holly (The Catalyst) +**Documented by:** Chronicler #43 +**Last Updated:** March 27, 2026