docs: add Carl-bot role hierarchy troubleshooting entry
WHAT WAS DONE: - Added troubleshooting entry to holly-wanderer-permissions-setup.md - Documents the gray circle symptom in Carl-bot Autoroles dashboard - Explains root cause: bot role must be above any role it assigns - Includes fix steps and verification method WHY: Encountered live on 2026-03-28. New members were joining and receiving no role. Root cause was Carl-bot's role positioned below Wanderer in the Discord role hierarchy. One-drag fix. Documented immediately so this is never a mystery again. FILES MODIFIED: - docs/guides/holly-wanderer-permissions-setup.md Signed-off-by: Chronicler #45 <claude@firefrostgaming.com>
This commit is contained in:
@@ -343,6 +343,30 @@ They can participate in Community Hub for free, but they KNOW there's more conte
|
||||
|
||||
---
|
||||
|
||||
### **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 |
|
||||
|
||||
Reference in New Issue
Block a user