docs: Enhance Holly's Wanderer guide with reasoning and Carl-bot info
MAJOR ADDITIONS: - Background section explaining what Wanderer tier is - FOMO strategy psychology and reasoning (why visible-but-locked works) - Carl-bot configuration details and verification steps - Complete subscription flow (Discord join → Paymenter → role assignment) - Business strategy and conversion funnel explanation - Why we use multiple bots (separation of concerns) - Success metrics to track - Future enhancement ideas EDUCATIONAL CONTENT: - Psychology behind FOMO (scarcity, social proof, curiosity) - Real-world examples (Spotify, Discord Nitro, gaming demos) - Conversion funnel math (1000 joins → 100-200 subscribers) - Engineering principles (right tool for the job) Guide now explains: - WHAT to do (step-by-step instructions) - WHY we're doing it (business/psychology reasoning) - HOW it all connects (Carl-bot → Wanderer → Arbiter → paid tiers) This gives Holly full context so she understands the strategy, not just follows instructions blindly. Updated by: Chronicler #44 Date: March 28, 2026 Signed-off-by: Claude <claude@firefrostgaming.com>
This commit is contained in:
Claude
@@ -6,6 +6,91 @@
|
||||
|
||||
---
|
||||
|
||||
## 📖 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:**
|
||||
@@ -294,7 +379,218 @@ They can participate in Community Hub for free, but they KNOW there's more conte
|
||||
|
||||
---
|
||||
|
||||
## 🔄 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.** ✨
|
||||
|
||||
Reference in New Issue
Block a user