# Discord Roles Setup Guide for Holly
**Project:** Firefrost Gaming Subscription Automation  
**Task:** Create missing Discord roles for subscription tiers  
**Assigned to:** Holly (unicorn20089)  
**Estimated time:** 20-30 minutes

---

## Overview

We're setting up The Arbiter bot to automatically assign Discord roles based on Paymenter subscriptions. You've already created some roles, but we need to create the missing ones and rename one existing role to match our official tier structure.

**What this enables:**
- When someone subscribes via Paymenter, The Arbiter automatically gives them the correct Discord role
- Roles grant access to subscriber-only channels
- Roles sync with LuckPerms to give in-game permissions on all 13 Minecraft servers

---

## Current State

**Roles you've already created:**
- ✅ The Awakened ($1 tier) - Role ID: `1482490386634248273`
- ⚠️ Sovereign ($50 tier) - Role ID: `1482488242677874770` - **NEEDS RENAME**
- ✅ Fire Path (identity choice, not a tier)
- ✅ Frost Path (identity choice, not a tier)

**Missing roles we need:**
- Fire Elemental ($5)
- Frost Elemental ($5)
- Fire Knight ($10)
- Frost Knight ($10)
- Fire Master ($15)
- Frost Master ($15)
- Fire Legend ($20)
- Frost Legend ($20)

---

## Why Rename "Founder" to "The Sovereign"

**The Issue:**
The current "Founder" role name doesn't match our official tier structure documented in:
- Ghost CMS Subscribe page (firefrostgaming.com/subscribe)
- Paymenter product configuration
- Operations manual documentation

**Official $499 tier name:** **The Sovereign**

**Reasoning:**
- "Founder" implies early adopter status (time-limited)
- "The Sovereign" is our permanent top-tier name for the $499/month subscription
- Consistency across all systems (website, billing, Discord, in-game) is critical for brand integrity

**We're in soft launch** — this is the perfect time to align everything before public launch.

---

## Step-by-Step Instructions

### Part 1: Rename "Founder" to "The Sovereign"

1. **Open Discord** → **Firefrost Gaming server**
2. **Click server name** at top → **Server Settings**
3. **Click "Roles"** in left sidebar
4. **Find "⚡ Sovereign"** in the roles list
5. **Click the pencil icon** (edit) next to "Founder"
6. **Change the name** from `Founder` to `The Sovereign`
7. **Click "Save Changes"** at the bottom
8. **Close the role editor**

**Important:** Don't change the role color, permissions, or icon — just the name.

---

### Part 2: Create Missing Fire Path Roles

**For each Fire Path role, follow these steps:**

#### Fire Elemental ($5 tier)

1. **In Server Settings → Roles**, click **"Create Role"** button (top right)
2. **Role Name:** `Fire Elemental`
3. **Role Color:** Orange/warm color (matching Fire branding - suggest #FF6B35 or similar)
4. **Role Icon:** 🔥 (fire emoji) - optional but recommended
5. **Permissions:** Leave as default (inherits @everyone permissions)
6. **Display role members separately:** ❌ OFF (we don't need role hoisting for subscribers)
7. **Click "Save Changes"**

#### Fire Knight ($10 tier)

1. **Create Role**
2. **Role Name:** `Fire Knight`
3. **Role Color:** Orange/warm (same as Fire Elemental or slightly different shade)
4. **Role Icon:** ⚔️ (crossed swords emoji) - optional
5. **Permissions:** Default
6. **Display separately:** OFF
7. **Save Changes**

#### Fire Master ($15 tier)

1. **Create Role**
2. **Role Name:** `Fire Master`
3. **Role Color:** Orange/warm
4. **Role Icon:** 🎯 (direct hit emoji) or 🔥 - optional
5. **Permissions:** Default
6. **Display separately:** OFF
7. **Save Changes**

#### Fire Legend ($20 tier)

1. **Create Role**
2. **Role Name:** `Fire Legend`
3. **Role Color:** Orange/warm (can be brighter/more vibrant than lower tiers)
4. **Role Icon:** 👑 (crown) or 🔥 - optional
5. **Permissions:** Default
6. **Display separately:** OFF
7. **Save Changes**

---

### Part 3: Create Missing Frost Path Roles

**For each Frost Path role, follow these steps:**

#### Frost Elemental ($5 tier)

1. **Create Role**
2. **Role Name:** `Frost Elemental`
3. **Role Color:** Cyan/cool color (matching Frost branding - suggest #4ECDC4 or similar)
4. **Role Icon:** ❄️ (snowflake emoji) - optional
5. **Permissions:** Default
6. **Display separately:** OFF
7. **Save Changes**

#### Frost Knight ($10 tier)

1. **Create Role**
2. **Role Name:** `Frost Knight`
3. **Role Color:** Cyan/cool (same as Frost Elemental or slightly different shade)
4. **Role Icon:** 🛡️ (shield emoji) - optional
5. **Permissions:** Default
6. **Display separately:** OFF
7. **Save Changes**

#### Frost Master ($15 tier)

1. **Create Role**
2. **Role Name:** `Frost Master`
3. **Role Color:** Cyan/cool
4. **Role Icon:** 💎 (gem) or ❄️ - optional
5. **Permissions:** Default
6. **Display separately:** OFF
7. **Save Changes**

#### Frost Legend ($20 tier)

1. **Create Role**
2. **Role Name:** `Frost Legend`
3. **Role Color:** Cyan/cool (can be brighter/more vibrant than lower tiers)
4. **Role Icon:** 👑 (crown) or ❄️ - optional
5. **Permissions:** Default
6. **Display separately:** OFF
7. **Save Changes**

---

## Part 4: Copy All Role IDs

**After creating all roles, we need their Discord IDs for bot configuration.**

### Enable Developer Mode (if not already enabled)

1. **Click your profile picture** (bottom left of Discord)
2. **User Settings** → **Advanced** (left sidebar)
3. **Toggle "Developer Mode" ON** ✅
4. **Close settings**

### Copy Each Role ID

1. **Go to Server Settings → Roles**
2. **Right-click each role name** → **"Copy Role ID"**
3. **Paste all IDs into a Discord DM to Michael or in #staff-lounge**

**Format like this:**
```
The Awakened: 1482490386634248273
The Sovereign: 1482488242677874770
Fire Elemental: [PASTE ID HERE]
Frost Elemental: [PASTE ID HERE]
Fire Knight: [PASTE ID HERE]
Frost Knight: [PASTE ID HERE]
Fire Master: [PASTE ID HERE]
Frost Master: [PASTE ID HERE]
Fire Legend: [PASTE ID HERE]
Frost Legend: [PASTE ID HERE]
Fire Path: [PASTE ID HERE]
Frost Path: [PASTE ID HERE]
```

**Send this to Michael** — he'll update The Arbiter bot configuration with these IDs.

---

## Verification Checklist

Before telling Michael you're done, verify:

- ✅ "Founder" role renamed to "The Sovereign"
- ✅ All 8 missing roles created (4 Fire, 4 Frost)
- ✅ Fire roles use warm/orange colors
- ✅ Frost roles use cool/cyan colors
- ✅ All role IDs copied and sent to Michael
- ✅ Total subscriber roles: 10 (1 Awakened, 4 Fire tiers, 4 Frost tiers, 1 Sovereign)

---

## Role Hierarchy (For Reference)

**Subscription Tiers (lowest to highest):**
1. The Awakened - $1/month (shared entry tier for both paths)
2. Fire/Frost Elemental - $5/month
3. Fire/Frost Knight - $10/month
4. Fire/Frost Master - $15/month
5. Fire/Frost Legend - $20/month
6. The Sovereign - $499/month (neutral top tier)

**Identity Roles (not subscription tiers):**
- Fire Path - Cosmetic identity choice
- Frost Path - Cosmetic identity choice

**These are separate** — someone can be "Fire Elemental" ($5 tier) AND have "Fire Path" identity, or they could be "Frost Legend" ($20 tier) with "Fire Path" identity. The paths are about personality/playstyle, not tier.

---

## Questions?

**If you hit any issues:**
- Ask in #staff-lounge
- DM Michael (Frostystyle)
- Discord won't let you do something → Michael can adjust bot permissions

**Expected issues:**
- "I don't see Copy Role ID" → Enable Developer Mode (see instructions above)
- "I can't create roles" → Check that you have "Manage Roles" permission in your staff role
- "Colors don't look right" → Use hex codes #FF6B35 (Fire) and #4ECDC4 (Frost) for consistency
- "Holly's name appears gray in Discord" → Lead Builder role has lost its color. Go to Server Settings → Roles → Lead Builder → set color to `#A855F7`. This happened March 28, 2026 — the role had no color set. Always verify this is `#A855F7` (Arcane purple). It is Holly's Trinity founder identity color.

---

## Why This Matters

**This is the final piece of subscription automation:**
1. ✅ Ghost CMS Subscribe page (live)
2. ✅ Paymenter billing system (configured)
3. ✅ The Arbiter bot (deployed and running)
4. ⏳ **Discord roles** ← You're doing this now
5. ⏳ LuckPerms permission sync (next step after this)

**Once roles are done:**
- Test subscriptions work end-to-end
- Soft launch in April 2026 (next week!)
- Subscribers get instant access to all servers

**You're building the bridge between billing and in-game permissions.** 🔥❄️

---

**Created:** March 27, 2026  
**Last Updated:** March 27, 2026  
**Author:** The Verifier (Chronicler #42)  
**For:** Holly (unicorn20089 / The Catalyst)
