# 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
