docs: The Arbiter Discord role mappings completed by Holly
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 <claude@firefrostgaming.com>
This commit is contained in:
227
docs/systems/arbiter-discord-role-mappings.md
Normal file
227
docs/systems/arbiter-discord-role-mappings.md
Normal file
@@ -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
|
||||
Reference in New Issue
Block a user