diff --git a/docs/guides/holly-wanderer-permissions-setup.md b/docs/guides/holly-wanderer-permissions-setup.md new file mode 100644 index 0000000..f3d1fe9 --- /dev/null +++ b/docs/guides/holly-wanderer-permissions-setup.md @@ -0,0 +1,300 @@ +# 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) + +--- + +## 🎯 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 + +--- + +## 📊 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 + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️ + +**Created by:** Chronicler #44 +**Date:** March 28, 2026