2906ab776b
The top subscription tier is Sovereign, not Founder. This has been corrected multiple times across sessions — fixing at source. FILES UPDATED: - docs/core/tasks.md - docs/core/project-scope.md - docs/tasks/rank-system-deployment/rank-structure.md - docs/tasks/paymenter-pterodactyl-integration/README.md - docs/archive/2026-02-09-consolidation/luckperms-structure.md - docs/planning/subscription-tiers.md - docs/planning/awakened-gateway.md - docs/guides/subscription-automation-guide.md - docs/guides/holly-discord-roles-setup.md - docs/guides/holly-wanderer-permissions-setup.md - docs/systems/arbiter-discord-role-mappings.md - docs/branding/trinity-leadership-artwork.md NOTE: References to 'founders' meaning Michael/Meg/Holly as company founders were intentionally preserved. Only tier name updated. Signed-off-by: claude@firefrostgaming.com
228 lines
6.7 KiB
Markdown
228 lines
6.7 KiB
Markdown
# 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:** Sovereign ($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
|