firefrost-operations-manual/docs/guides/holly-wanderer-permissions-setup.md

# Discord Wanderer Role - Channel Permissions Setup Guide

**For:** Holly (unicorn20089 / The Catalyst)  
**Created:** March 28, 2026  
**Purpose:** Configure Wanderer role so free users see Fire/Frost paths but can't access them (FOMO driver)

---

## 📖 BACKGROUND: What is Wanderer?

**Wanderer** is the **FREE tier** for Firefrost Gaming.

**How it works:**
1. Someone joins the Discord server (no payment required)
2. **Carl-bot** automatically assigns them the "Wanderer" role
3. They can browse and chat in Community Hub channels
4. They see Fire/Frost paths exist but can't access them (🔒 locked)
5. They try to join a Minecraft server → denied (no subscription)
6. **FOMO kicks in** → They subscribe to get full access

**The strategy:** Give them enough to get hooked, show them what they're missing, make subscribing irresistible.

---

## 🧠 WHY THE FOMO STRATEGY WORKS

### **What We're Doing:**
Making Fire Path and Frost Path **visible but locked** to Wanderers.

### **Why This Works Better Than Hiding:**

**❌ BAD (Hiding Everything):**
- Free user joins Discord
- Sees: Welcome, Community Hub, Support
- Thinks: "This is all there is"
- Never knows about Fire/Frost paths
- No reason to upgrade
- **Conversion rate: Low**

**✅ GOOD (Visible But Locked - FOMO):**
- Free user joins Discord
- Sees: Welcome, Community Hub, Support, AND 🔒 Fire Path, 🔒 Frost Path
- Thinks: "Whoa, there's fire-general, fire-strategy... but I can't access it!"
- Clicks on locked channel → Discord shows lock icon
- Realizes they're missing exclusive content
- **Conversion rate: Much Higher (10-20% target)**

### **The Psychology:**
- **Scarcity** - "This content is locked, I want what I can't have"
- **Social proof** - "Other people are chatting in there, I'm missing out"
- **Curiosity** - "What are they talking about in fire-strategy?"
- **Exclusivity** - "I want to be part of the Fire Path community"

**This is the same strategy used by:**
- Spotify (free tier shows premium features grayed out)
- Discord Nitro (shows locked emojis/stickers)
- Gaming demos (shows locked levels)
- Freemium SaaS products

---

## 🤖 CARL-BOT: Auto-Assign Wanderer on Join

Before we configure permissions, you should know about **Carl-bot**.

### **What is Carl-bot?**
Carl-bot is a Discord bot that automatically assigns the Wanderer role when someone joins the server.

**How it works:**
1. New person joins Firefrost Gaming Discord
2. Carl-bot detects the join event
3. Immediately assigns "Wanderer" role
4. Person can now access Wanderer channels

**This is already configured by Michael**, but here's how to check/modify it:

### **Verify Carl-bot Configuration:**

1. Go to: **https://carl.gg/dashboard**
2. Log in with Discord
3. Select **Firefrost Gaming** server
4. Click **"Autoroles"** in the left sidebar
5. You should see **"Wanderer"** in the "Autoroles" dropdown
6. This means Carl-bot will auto-assign Wanderer on join

**If you ever need to change it:**
- Select a different role from the dropdown
- Click "Save"

**That's it!** Carl-bot handles the auto-assignment, you just need to configure what Wanderer can see.

---

## 🎯 GOAL

**What Wanderer should see:**

✅ **CAN ACCESS (Read + Send):**
- Welcome & Info channels
- Community Hub (all channels)
- Support channels
- Voice channels (Lobby, Game Rooms, AFK)

🔒 **CAN SEE BUT LOCKED (FOMO Driver):**
- 🔥 Fire Path category + all fire channels (visible but can't access)
- ❄️ Frost Path category + all frost channels (visible but can't access)

❌ **CANNOT SEE AT ALL:**
- Subscriber Lounge
- Game Servers
- Staff Area
- modlog

---

## 🚨 CURRENT ISSUES TO FIX

Based on "View Server As Role" test:

1. **Fire Path & Frost Path are completely hidden** → Should be visible but locked
2. **modlog is visible to Wanderer** → Should be hidden (staff only)
3. **Support category might be incomplete** → Verify network-status and breezehost-service-alerts are visible

---

## 🔧 FIX #1: Make Fire Path Visible But Locked

### **Step 1: Configure Fire Path Category**

1. **Right-click** the **"🔥 Fire Path"** category name
2. Click **"Edit Category"**
3. Go to **"Permissions"** tab
4. Click **"Advanced permissions"** (if you see it)
5. Click **"+ Add members or roles"**
6. Select **"Wanderer"** from the dropdown
7. Set these permissions for Wanderer:

**ALLOW (Green ✅):**
- ✅ View Channel

**DENY (Red ❌):**
- ❌ Send Messages
- ❌ Send Messages in Threads
- ❌ Create Public Threads
- ❌ Create Private Threads
- ❌ Embed Links
- ❌ Attach Files
- ❌ Add Reactions
- ❌ Connect (if there are voice channels)
- ❌ Speak (if there are voice channels)

8. Click **"Save Changes"**

---

### **Step 2: Sync All Fire Channels**

For each channel in Fire Path (fire-general, fire-strategy, fire-events, fire-leaderboards):

1. **Right-click** the channel
2. Click **"Edit Channel"**
3. Go to **"Permissions"** tab
4. **Make sure** the toggle at the top says **"Sync permissions with category"** (should be ON/enabled)
5. If it says "permissions are synced" → perfect, move to next channel
6. If it says "permissions are not synced" → click the sync button
7. Click **"Save Changes"**

**Repeat for all 4 Fire Path channels.**

---

## 🔧 FIX #2: Make Frost Path Visible But Locked

### **Step 1: Configure Frost Path Category**

Same process as Fire Path:

1. **Right-click** the **"❄️ Frost Path"** category
2. Click **"Edit Category"**
3. **Permissions** tab
4. **"+ Add members or roles"** → Select **"Wanderer"**
5. Set permissions:
   - ✅ **View Channel** = GREEN (allow)
   - ❌ **Send Messages** = RED (deny)
   - ❌ All other message/voice permissions = RED (deny)
6. **Save Changes**

---

### **Step 2: Sync All Frost Channels**

For each channel (frost-general, frost-builds, frost-events, frost-gallery):

1. Right-click → **Edit Channel**
2. **Permissions** tab
3. Verify **"Sync permissions with category"** is ON
4. Save

**Repeat for all 4 Frost Path channels.**

---

## 🔧 FIX #3: Hide modlog from Wanderer

The #modlog channel should be staff-only, not visible to free users.

1. **Right-click** the **#modlog** channel
2. Click **"Edit Channel"**
3. Go to **"Permissions"** tab
4. Click **"+ Add members or roles"**
5. Select **"Wanderer"**
6. Set permission:
   - ❌ **View Channel** = RED (deny)
7. Click **"Save Changes"**

Now Wanderer won't see modlog at all.

---

## 🔧 FIX #4: Verify Support Category

**Check if these channels exist in the Support category:**
- network-status
- breezehost-service-alerts
- support-tickets

**If they exist, make sure Wanderer can see them:**

1. Right-click **"Support"** category
2. **Edit Category** → **Permissions**
3. Find **"Wanderer"** role
4. Make sure:
   - ✅ **View Channel** = GREEN (allow)
   - ✅ **Read Message History** = GREEN (allow)
   - ✅ **Send Messages** = GREEN (allow) - *for support-tickets only*

**OR just verify the category permissions allow Wanderer to view.**

---

## ✅ VERIFICATION: Test Your Changes

After making all the changes above:

### **Option A: Use "View Server As Role"**

1. Go to **Server Settings** → **Roles**
2. **Right-click** "Wanderer" role
3. Click **"View Server As Role"**
4. You should now see:

**What you SHOULD see:**
```
Welcome & Info
  ✅ welcome, rules, announcements, get-roles

🔥 Fire Path
  🔒 fire-general (you can see it but it's locked)
  🔒 fire-strategy (locked)
  🔒 fire-events (locked)
  🔒 fire-leaderboards (locked)

❄️ Frost Path
  🔒 frost-general (locked)
  🔒 frost-builds (locked)
  🔒 frost-events (locked)
  🔒 frost-gallery (locked)

Community Hub
  ✅ general-chat, memes, introductions, showcase, 
     off-topic-chat, suggestions, support, feedback

Voice Channels
  ✅ Lobby, Game Room 1, Game Room 2, AFK

Support
  ✅ support-tickets (and others if they exist)
```

**What you should NOT see:**
- ❌ modlog (hidden)
- ❌ Subscriber Lounge (hidden)
- ❌ Game Servers (hidden)
- ❌ Staff Area (hidden)

---

### **Option B: Test with Alt Account**

1. Create a test Discord account (or use an alt)
2. Join Firefrost Gaming
3. Carl-bot should auto-assign Wanderer role
4. Check what channels you can see
5. Try to click on fire-general → should see 🔒 lock icon
6. Leave the test account in the server or kick it when done

---

## 🎨 WHAT THIS ACHIEVES (The FOMO Strategy)

**Free users (Wanderer) will see:**

> "Oh wow, there's a Fire Path with fire-general, fire-strategy... but I can't access it!"
> 
> "I can see Frost Path exists but all the channels are locked!"
> 
> "I need to subscribe to unlock these!"

**This is WAY more effective than hiding the paths completely.**

They can participate in Community Hub for free, but they KNOW there's more content waiting if they subscribe.

---

## 🆘 TROUBLESHOOTING

### **Problem: Channel still shows as accessible instead of locked**

**Solution:**
- Go back to the category permissions
- Make sure Wanderer has View Channel = GREEN
- Make sure Wanderer has Send Messages = RED
- Re-sync the individual channels

---

### **Problem: Wanderer can't see the Fire/Frost categories at all**

**Solution:**
- Check category permissions
- Wanderer needs View Channel = GREEN (allowed) at the category level
- Individual channel denies come from Send Messages = RED

---

### **Problem: Channel shows "Sync permissions" but changes don't take effect**

**Solution:**
- Click "Save Changes" on the category first
- Then go to the individual channel
- Toggle "Sync permissions" OFF then back ON
- Save again

---

### **Problem: Carl-bot not assigning Wanderer role to new members (role shows gray in dashboard)**

**Symptoms:**
- New members join and receive no role at all
- In Carl-bot dashboard → Autoroles, the Wanderer role tag shows a **gray circle** on the left instead of a colored one

**Root Cause:**
Discord requires a bot's role to be **higher in the role hierarchy** than any role it tries to assign. If Carl-bot's role sits below Wanderer in the list, Discord silently blocks the assignment.

**Fix:**
1. Go to **Server Settings → Roles**
2. Find Carl-bot's role in the list
3. **Drag it above Wanderer**
4. Save

**Verification:**
The Wanderer role tag in Carl-bot's Autoroles dashboard will show a **colored circle** (not gray) once the hierarchy is correct. Test with a fresh join or by removing Wanderer from a test account and rejoining.

**Date Encountered:** March 28, 2026
**Fixed By:** Michael (Frostystyle)
**Diagnosed By:** Chronicler #45

---

## 📊 PERMISSION SUMMARY CHEAT SHEET

| Role | View Channel | Send Messages | Access |
|------|--------------|---------------|--------|
| **Wanderer in Community Hub** | ✅ Green | ✅ Green | Full access |
| **Wanderer in Fire/Frost Paths** | ✅ Green | ❌ Red | Can see, can't send (LOCKED) |
| **Wanderer for modlog** | ❌ Red | ❌ Red | Completely hidden |
| **Wanderer for Staff Area** | ❌ Red | ❌ Red | Completely hidden |

---

## ✨ WHEN YOU'RE DONE

**Ping Michael in Discord:**

"@Frostystyle Wanderer permissions are configured! Fire/Frost paths are now visible but locked. Ready for testing."

**Or just let him know in #staff-lounge that it's done!**

---

## 📝 NOTES

- These are CATEGORY-level permissions that apply to all channels in that category
- Individual channels inherit from their parent category (that's the "sync" feature)
- If you need a channel to behave differently, you can override at the channel level
- @everyone role permissions apply to EVERYONE including Wanderer (so be careful with those)

---

**Questions?** Ask Michael or Meg in #staff-lounge!

**Estimated time:** 10-15 minutes

---

## 🔄 THE COMPLETE SUBSCRIPTION FLOW

Once you configure Wanderer permissions, here's how the entire system works together:

### **Step 1: Person Joins Discord (Free)**
```
New person joins Firefrost Gaming
   ↓
Carl-bot detects join event
   ↓
Carl-bot assigns "Wanderer" role
   ↓
Person can now access:
  ✅ Welcome & Info
  ✅ Community Hub (can chat!)
  ✅ Support
  🔒 Can SEE Fire/Frost paths but locked
```

### **Step 2: Wanderer Browses Discord**
```
Free user explores Discord
   ↓
Chats in #general-chat, posts memes
   ↓
Sees 🔒 fire-general, 🔒 frost-strategy
   ↓
Clicks on locked channel → "You need a subscription"
   ↓
Curiosity builds... what are they talking about?
```

### **Step 3: Wanderer Tries to Join Minecraft**
```
Tries to join a Firefrost Minecraft server
   ↓
Server checks LuckPerms group
   ↓
LuckPerms: "You are in group 'wanderer' - no server access"
   ↓
Kicked from server with message:
"Subscribe at firefrostgaming.com to play!"
```

### **Step 4: Conversion - They Subscribe!**
```
User goes to firefrostgaming.com
   ↓
Clicks "Subscribe" / "Join Now"
   ↓
Chooses tier: Awakened ($1), Elemental ($5), etc.
   ↓
Chooses path: Fire or Frost
   ↓
Pays via Paymenter
   ↓
Paymenter sends webhook to The Arbiter bot
```

### **Step 5: Automatic Role Assignment**
```
The Arbiter receives webhook from Paymenter
   ↓
Webhook says: "User X subscribed to Fire Elemental"
   ↓
The Arbiter assigns "Fire Elemental" Discord role
   ↓
User KEEPS Wanderer role + GAINS Fire Elemental role
   ↓
Discord permissions update instantly
```

### **Step 6: User Gets Full Access**
```
User refreshes Discord
   ↓
🔒 Fire Path channels are now UNLOCKED!
   ↓
Can access: fire-general, fire-strategy, fire-events, fire-leaderboards
   ↓
LuckPerms syncs Discord role → Minecraft group
   ↓
Can now join Minecraft servers and PLAY!
```

---

## 💡 WHY WE USE MULTIPLE SYSTEMS

You might wonder: "Why Carl-bot AND The Arbiter? Why not just one bot?"

**Here's why:**

### **Carl-bot (Free Tier Management)**
- **Job:** Assign Wanderer when someone joins Discord
- **Trigger:** Discord join event
- **Good at:** Auto-role on join (this is what Carl-bot is built for)
- **Simple, reliable, battle-tested by millions of servers**

### **The Arbiter (Paid Tier Management)**
- **Job:** Assign subscription tiers based on Paymenter payments
- **Trigger:** Paymenter webhook (subscription created/cancelled/expired)
- **Good at:** Integration between payment system and Discord
- **Custom-built for Firefrost's specific needs**

**Separation of Concerns:**
- Carl-bot handles Discord joins → Wanderer
- The Arbiter handles Paymenter payments → Paid tiers
- Each bot does ONE thing really well
- Easier to maintain, troubleshoot, and update

**Could we make The Arbiter handle both?** Yes, but:
- Would require rewriting The Arbiter (2-3 hours)
- Mixing two different triggers (join events + webhooks)
- More complex code = more bugs
- Carl-bot is already proven and works perfectly

**Engineering principle:** Use the right tool for the job. Carl-bot IS the right tool for auto-roles on join.

---

## 🎨 THE BUSINESS STRATEGY

**Wanderer tier is a marketing funnel:**

### **Conversion Funnel:**
```
1000 people join Discord (Wanderer - Free)
   ↓
800 chat in Community Hub (engaged users)
   ↓
400 try to join Minecraft servers (want to play)
   ↓
100-200 subscribe (10-20% conversion rate)
   ↓
Revenue: $100-2000/month from this cohort
```

**What makes them convert?**
1. ✅ **Community first** - They get to know people before paying
2. 🔒 **Visible FOMO** - They see what they're missing
3. 🎮 **Server access** - They want to actually PLAY
4. 💰 **Low barrier** - $1/month Awakened tier = impulse buy

**Why this works better than paid-only:**
- No free tier = No one joins (too big commitment)
- Free tier with nothing = No conversion (nothing to upgrade to)
- Free tier with VISIBLE locked content = Perfect FOMO driver

---

## 📊 SUCCESS METRICS

After you configure Wanderer permissions, we can track:

**Discord Analytics:**
- How many Wanderers join per week
- How many Wanderers engage in Community Hub
- How many click on locked Fire/Frost channels (shows interest)

**Conversion Metrics:**
- Wanderer → Awakened conversion rate (target: 10-20%)
- Average time from join to first subscription
- Which path converts better (Fire vs Frost)

**This data helps us optimize:**
- Channel naming (make locked content more enticing)
- Welcome messages (guide Wanderers toward subscription)
- Pricing strategy (are tiers priced right?)

---

## 🔮 FUTURE ENHANCEMENTS

**Once Wanderer permissions are working, we can add:**

1. **Welcome DM from Carl-bot**
   - "Welcome to Firefrost Gaming! You're a Wanderer (free tier)..."
   - "Want to unlock Fire/Frost paths? Subscribe at..."

2. **Custom lock messages**
   - Instead of generic Discord lock icon
   - Custom message: "🔥 Fire Elemental+ required. Subscribe to unlock!"

3. **Timed trials**
   - Give new Wanderers 24-hour trial access to Fire/Frost
   - After 24 hours, lock it again → stronger FOMO

4. **Engagement triggers**
   - If Wanderer chats 10+ times in Community Hub
   - Send DM: "You're active! Want to unlock more channels? $1/month"

**But first:** Get the foundation working. These are optimizations for later.

---

**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️

**Created by:** Chronicler #44  
**Date:** March 28, 2026

---

## 📞 NEED HELP?

**If you get stuck:**
- Ask in #staff-lounge
- Ping @Frostystyle (Michael) or @Gingerfury (Meg)
- Or just do your best - you can always test with "View Server As Role"

**You got this, Holly!** 💪

The whole setup is designed to be user-friendly. Worst case, if something doesn't work, we can fix it together. The most important thing is getting Fire/Frost paths VISIBLE to Wanderers.

**That's the FOMO magic.** ✨