From 1c79ea6535e2633629e89dd978f62d24ae16869e Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 28 Mar 2026 02:19:31 +0000 Subject: [PATCH] docs: Enhance Holly's Wanderer guide with reasoning and Carl-bot info MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .../holly-wanderer-permissions-setup.md | 296 ++++++++++++++++++ 1 file changed, 296 insertions(+) diff --git a/docs/guides/holly-wanderer-permissions-setup.md b/docs/guides/holly-wanderer-permissions-setup.md index f3d1fe9..d4087ae 100644 --- a/docs/guides/holly-wanderer-permissions-setup.md +++ b/docs/guides/holly-wanderer-permissions-setup.md @@ -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.** ✨