firefrost-operations-manual/docs/systems/arbiter-discord-role-mappings.md

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