diff --git a/docs/awakened-gateway.md b/docs/awakened-gateway.md new file mode 100644 index 0000000..15ce7fe --- /dev/null +++ b/docs/awakened-gateway.md @@ -0,0 +1,556 @@ +# The Awakened Gateway: The $1.00 Handshake Philosophy + +**Version:** 1.0 +**Created:** February 8, 2026 +**Purpose:** Internal documentation - reasoning behind the $1 gateway +**Audience:** Team training, future staff, operational reference +**Status:** Finalized strategy + +--- + +## Executive Summary + +The **$1.00 Awakened Gateway** (branded as "The Handshake") is **not a revenue stream**—it is a **security and community protocol** that protects Firefrost Gaming from bots, trolls, and griefers while establishing psychological buy-in from legitimate members. + +**Core Philosophy:** +> *"If you want to be an asshole, you have to pay for it."* + +**Primary Goal:** Create a financial barrier that stops 99% of bad actors while maintaining low friction for genuine community members. + +--- + +## The Problem We're Solving + +### **Challenge 1: Bot & Troll Attacks** + +**The Reality of Free Minecraft Servers:** +- Automated bot attacks (grief bots, spam bots, DDoS attempts) +- Drive-by trolls looking for easy targets +- Griefers who create disposable accounts to harass communities +- Zero accountability for bad behavior (burner emails, VPNs, alt accounts) + +**Traditional Solutions (and why they fail):** +- IP bans → VPNs bypass instantly +- Email verification → Disposable email services render useless +- Whitelist applications → Time-consuming manual review, inconsistent enforcement +- CAPTCHA → Annoying for real users, increasingly bypassable by bots + +**The Financial Friction Solution:** +- Bots can't pay (no credit card automation at scale) +- Trolls won't pay (they target free servers for easy harassment) +- Griefers CAN pay, but now they're traceable and each ban costs them money (unsustainable) + +**Success Metric:** 99% reduction in automated attacks and drive-by harassment. + +--- + +### **Challenge 2: No Accountability** + +**The Free Account Problem:** +- User creates account with burner email +- Griefs server, harasses players +- Gets banned +- Creates new account with different burner email +- Repeat infinitely at zero cost + +**The Payment Trail Solution:** +- Every payment creates financial identity (Stripe customer ID, transaction history) +- Bans are permanent and tied to payment method +- Creating alt accounts requires new payment method (cards, PayPal accounts) +- Each ban costs the bad actor real money +- After 2-3 bans, harassment becomes financially unsustainable + +**Success Metric:** Permanent, enforceable bans that actually stop bad actors. + +--- + +### **Challenge 3: Psychological Investment** + +**The Free User Mentality:** +- "I didn't pay for this, so I don't owe anyone respect" +- No skin in the game = no emotional investment +- Disposable account = disposable behavior + +**The Paid User Mentality:** +- "I paid for this, so I'm a member, not a visitor" +- Financial investment (even $1) creates psychological ownership +- Sunk cost effect = more likely to follow community standards +- Sense of belonging to something exclusive (not everyone can/will pay) + +**Success Metric:** Shift from "tourists" to "citizens" in community culture. + +--- + +## Why $1.00 Specifically? + +### **The Psychology of One Dollar** + +**Low Enough:** +- Not a financial barrier for genuine players (cost of a candy bar) +- Accessible globally (even with currency conversion) +- Doesn't feel like a "paywall" (feels like verification) + +**High Enough:** +- Eliminates bots (automation can't scale credit card payments) +- Deters trolls (they seek zero-friction targets) +- Creates traceability (financial identity required) +- Provides psychological sunk cost (not "free," so has perceived value) + +**Not Zero:** +- $0 = no barrier, no accountability, no investment +- Any amount > $0 = financial friction, traceability, psychological shift + +**Not Higher:** +- $5 = starts feeling like a paywall, reduces conversion +- $10+ = significantly limits accessibility, especially for younger players +- $1 = sweet spot between accessibility and effectiveness + +--- + +## What The Handshake Provides + +### **1. Server Whitelist Access** + +**Before Payment:** +- User can browse Discord public channels +- User can see what Firefrost offers +- User CANNOT join any Minecraft servers (not whitelisted) + +**After Payment:** +- User automatically whitelisted on all 13+ servers +- Can log in, explore, play with limited perks (1 home, 0 chunks) +- Can interact with community, decide if they want to commit to a Path ($5 Elemental) + +**Flow:** +1. User discovers Firefrost (website, social media, friend referral) +2. Joins Discord as "Wanderer" (free, public channels only) +3. Sees community, likes what they see +4. Pays $1 for "The Handshake" → becomes "The Awakened" +5. Instantly whitelisted on all servers +6. Plays, explores, engages with community +7. Decides whether to upgrade to $5 Elemental (choose Fire or Frost) + +--- + +### **2. Financial Accountability** + +**Stripe Transaction Record:** +- Customer ID (permanent) +- Payment method fingerprint (credit card, PayPal, etc.) +- Email address (verified by payment processor) +- IP address (at time of payment) +- Geographic location (billing address) + +**Ban Enforcement:** +- User banned → Stripe customer ID flagged +- Attempting to create new account with same payment method → auto-rejected +- User must use NEW payment method (new card, new PayPal) → costs money +- Each ban = financial cost to bad actor + +**Traceability for Legal Issues:** +- If serious harassment/threats occur, payment trail provides legal identity +- Can cooperate with law enforcement if necessary (rare, but possible) +- Much stronger legal position than "anonymous user on free server" + +--- + +### **3. Psychological Shift** + +**From Visitor to Citizen:** +- "I paid for this" = I belong here +- Sunk cost (even $1) creates investment mentality +- More likely to respect community standards +- Less likely to engage in throwaway toxic behavior + +**Social Proof:** +- "Everyone here paid to be here" = this is a curated community +- Not a random public server with open access +- Membership implies standards and expectations + +**Exclusivity Without Elitism:** +- $1 is accessible to almost everyone (not truly exclusive) +- But the ACT of paying creates perception of exclusivity +- "I'm part of something that requires commitment" + +--- + +## What The Handshake Does NOT Do + +### **❌ NOT Age Verification** + +**Critical Correction:** +- The $1 payment does NOT serve as age verification +- Payment methods are NOT reliable age proxies (minors can have debit cards, use parent's PayPal, etc.) +- Legal age verification requires proper, compliant systems + +**Separate System Required:** +- 18+ content (if implemented) will have separate, proper age verification +- Legal consultation required for age-gated content +- $1 payment is security protocol ONLY, not age gate + +**Lesson Learned:** +- Previous documentation incorrectly conflated payment with age verification +- Gemini added this assumption without explicit approval +- Corrected in current strategy + +--- + +### **❌ NOT a Revenue Stream** + +**Financial Reality:** +- $1 per user (one-time) is not meaningful revenue +- 1,000 users = $1,000 total (one-time, not recurring) +- Stripe fees (2.9% + $0.30) = $0.68 net per transaction +- Server costs for 1,000 users > $1,000/month + +**Purpose:** +- Security protocol, not profit center +- Barrier to entry for bad actors +- Foundation for upsell to real tiers ($5-$20/month) + +**Real Revenue:** +- Elemental+ subscriptions ($5-$20/month recurring) +- Sovereign lifetime memberships ($499 one-time) + +--- + +## Messaging: "The Handshake" + +### **Why This Branding?** + +**"The Handshake" = Agreement, not payment** +- Implies mutual respect (we trust you, you respect us) +- Feels like joining something (not just buying access) +- Cultural framing (handshake = deal, commitment, trust) + +**Meg's Pitch (The Emissary):** +> *"One dollar, one time, one family. The Handshake proves you're here to build with us, not break what we've made."* + +**Michael's Framing (The Wizard):** +> *"The Handshake isn't a paywall—it's a firewall. It keeps the bots outside so we can keep the community safe inside."* + +--- + +### **How We Talk About It (Publicly)** + +**✅ GOOD Messaging:** +- "The Handshake protects our community" +- "One dollar keeps the trolls away" +- "Small barrier, big difference in community quality" +- "Prove you're here to build, not break" + +**❌ BAD Messaging:** +- "Pay to play" (sounds like paywall) +- "Age verification" (legally problematic, factually incorrect) +- "We need the money" (not the purpose) +- "Rich kids only" (undermines accessibility) + +--- + +### **How We Talk About It (Internally)** + +**✅ Honest Framing:** +- Security protocol first, community building second +- Financial friction deters bad actors +- Psychological investment shifts user behavior +- Traceability enables permanent bans + +**Team Training:** +- Support staff: "The $1 payment creates accountability" +- Community managers: "Paid members have more investment in community health" +- Technical staff: "Payment creates audit trail for abuse reports" + +--- + +## Conversion Funnel + +### **Step 1: Discovery (Free)** + +**Channels:** +- Google search ("modded Minecraft servers") +- Social media (YouTube, TikTok, Reddit) +- Friend referrals +- Server lists (if we list publicly) + +**Landing:** firefrostgaming.com (website) or Discord invite + +--- + +### **Step 2: Browse (Free - Wanderer)** + +**Discord Access:** +- Public channels (Arrival Hall) +- Can see server list, community activity +- Can read announcements, rules + +**No Server Access:** +- Cannot join Minecraft servers (not whitelisted) +- Can see what's available, but can't play yet + +**Goal:** Show value, create desire to join + +--- + +### **Step 3: The Handshake ($1 - The Awakened)** + +**Decision Point:** "Is this community worth $1 to me?" + +**If Yes:** +- Pay $1 via Stripe (Ghost CMS / Paymenter checkout) +- Instant Discord role: "The Awakened" +- Instant whitelist: All 13+ Minecraft servers +- Access to The Crossroads (Awakened Discord channels) + +**If No:** +- Stays as Wanderer (can browse but not play) +- Can come back later if they change their mind + +**Conversion Rate Target:** 10-20% of Discord joiners → Awakened + +--- + +### **Step 4: Explore (The Awakened - $1)** + +**Server Access:** +- Whitelisted on all 13+ servers +- 1 home (minimal but functional) +- 0 chunks (can't claim territory yet) +- No /rtp (limited exploration) + +**Discord Access:** +- The Crossroads channels +- Can SEE Fire/Frost path channels (locked, creates FOMO) +- Can interact with Awakened community + +**Goal:** Experience Firefrost, decide if they want deeper commitment + +--- + +### **Step 5: Commit to a Path ($5 - Elemental)** + +**Decision Point:** "Do I want Fire (Meg's community) or Frost (Michael's community)?" + +**If Fire:** +- Fire Elemental role (Discord + in-game) +- Access to Fire Path exclusive channels +- 5 homes, 25 chunks, /rtp 60min cooldown + +**If Frost:** +- Frost Elemental role (Discord + in-game) +- Access to Frost Path exclusive channels +- 5 homes, 25 chunks, /rtp 60min cooldown + +**If Neither:** +- Stays as Awakened (limited perks) +- Can upgrade anytime + +**Conversion Rate Target:** 30-50% of Awakened → Elemental (within 30 days) + +--- + +### **Step 6: Deepen Commitment ($10-$20)** + +**Knight, Master, Legend tiers:** +- Progressive perk increases +- Deeper community integration +- More invested in Firefrost success + +**Conversion Rate Target:** 20-40% of Elemental → higher tiers (over 90 days) + +--- + +### **Step 7: Lifetime (Optional - $499)** + +**Sovereign (Founder's):** +- Lifetime access to everything +- Both Fire AND Frost paths +- Elite recognition +- Governance rights + +**Conversion Rate Target:** 1-5% of active subscribers → Sovereign (aspirational) + +--- + +## Success Metrics + +### **Security Metrics:** + +**Bot/Troll Reduction:** +- Target: 99% reduction in automated attacks +- Measurement: Compare ban rates before/after $1 gateway + +**Ban Effectiveness:** +- Target: 95% of bans are permanent (no successful alt account creation) +- Measurement: Track repeat offenders vs. one-time bans + +--- + +### **Community Health Metrics:** + +**Toxic Behavior:** +- Target: 80% reduction in harassment reports +- Measurement: Support tickets related to griefing/harassment + +**Community Engagement:** +- Target: Awakened members 3x more active than free browsers +- Measurement: Discord activity, server playtime + +--- + +### **Financial Metrics:** + +**Conversion Rates:** +- Wanderer → Awakened: 10-20% +- Awakened → Elemental: 30-50% +- Elemental → Higher tiers: 20-40% + +**Revenue (Long-term):** +- $1 gateway is NOT the revenue source +- Elemental+ subscriptions are the real revenue +- $1 is the TOP of the funnel, not the monetization layer + +--- + +## Common Objections (and Responses) + +### **Objection 1: "Minecraft servers should be free!"** + +**Response:** +- Many servers ARE free, and you can play there +- We're building a curated community with higher standards +- $1 keeps the griefers out so the real players can thrive +- You get access to 13+ servers, not just one + +--- + +### **Objection 2: "I don't have a credit card."** + +**Response:** +- Stripe accepts PayPal, debit cards, many international payment methods +- If you truly can't pay, we understand—but we can't compromise security for exceptions +- Consider asking a parent/guardian if you're underage + +--- + +### **Objection 3: "This feels like a paywall."** + +**Response:** +- It's not a paywall, it's a firewall +- We're protecting the community from bots and trolls +- $1 is less than a candy bar—if the community is worth anything to you, it's worth $1 +- Think of it as a cover charge at a club—it keeps out people who aren't serious + +--- + +### **Objection 4: "What if I pay and then get banned unfairly?"** + +**Response:** +- We have a transparent appeal process +- Bans require documented rule violations +- If you're wrongfully banned, we'll review and refund if appropriate +- But: If you're banned for legitimate harassment/griefing, the $1 is forfeit (that's the point) + +--- + +### **Objection 5: "Why can't you just use better moderation?"** + +**Response:** +- Moderation is reactive (bans AFTER bad behavior) +- The $1 gateway is preventative (stops bad actors from joining) +- We use BOTH: Gateway stops 99%, moderation handles the 1% that slips through +- Better to prevent problems than clean up messes + +--- + +## Legal & Compliance + +### **Payment Processing:** + +**Stripe Compliance:** +- PCI-DSS compliant (we never handle raw card data) +- GDPR compliant (EU data protection) +- International payment support + +**Our Responsibilities:** +- Store minimal payment data (Stripe customer ID only) +- Provide refund mechanism for legitimate disputes +- Honor chargebacks (and ban associated accounts) + +--- + +### **Refund Policy:** + +**Standard Policy:** +- No refunds for $1 Awakened payment (one-time security fee) +- Exception: Wrongful ban with successful appeal +- Exception: Technical issue preventing server access + +**Reasoning:** +- $1 is nominal amount (cost of payment processing) +- Refunds would enable ban evasion (pay $1, grief, chargeback, repeat) + +--- + +### **Terms of Service:** + +**Key Clauses:** +- Payment is non-refundable security deposit +- Ban = forfeiture of access, no refund +- We reserve right to refuse service (with or without cause) +- No guarantee of server uptime (best-effort basis) + +**Legal Review:** +- Consult lawyer before going live with payment system +- Ensure ToS is enforceable in relevant jurisdictions + +--- + +## Future Considerations + +### **What We Might Add:** + +**Referral Program:** +- Existing Awakened members invite friends +- Friend pays $1, referrer gets bonus (extra home, cosmetic, etc.) +- Incentivizes community growth + +**Promotional Codes:** +- Partner with content creators (free $1 gateway for their viewers) +- Limited-time promotions ("First 100 users: $1 waived") +- We still collect payment info for accountability, just charge $0 + +**Multi-Game Expansion:** +- $1 gateway unlocks Minecraft + Hytale + FoundryVTT (as player) +- Increases value proposition +- Unified account across all Firefrost games + +--- + +### **What We Will NOT Do:** + +**❌ Remove the gateway:** +- Once implemented, it's permanent +- Community quality depends on this barrier +- Removing it would invite back the problems it solves + +**❌ Increase the price:** +- $1 is the sweet spot +- Higher price reduces accessibility without improving security +- If we need more revenue, we upsell to Elemental+ tiers, not raise the gateway + +**❌ Use it for age verification:** +- Legally problematic +- Not reliable +- Separate system required for 18+ content + +--- + +## Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| **1.0** | 2026-02-08 | Michael | Initial documentation. Corrected age verification misconception. Finalized $1 gateway strategy. | + +--- + +**END OF DOCUMENT** diff --git a/docs/discord-structure-complete.md b/docs/discord-structure-complete.md new file mode 100644 index 0000000..27dedd1 --- /dev/null +++ b/docs/discord-structure-complete.md @@ -0,0 +1,413 @@ +# Firefrost Gaming: Discord Structure Complete + +**Version:** 1.0 +**Created:** February 8, 2026 +**Status:** Approved by Michael & Meg +**Community Size:** 3 active members (Michael, Meg, Holly) +**Server Boost Status:** 2/28 Boosts + +--- + +## Philosophy: Fire + Frost Discord Architecture + +The Firefrost Discord reflects the dual-path community identity: + +- **🔥 Fire Path** - Social, creative, community-focused (Meg's domain) +- **❄️ Path of Frost** - Technical, systems, infrastructure-focused (Michael's domain) +- **⚡ The Nexus** - Founder-exclusive space where Fire meets Frost + +**Competitive Element:** Michael vs Meg - who can recruit more subscribers to their path? + +--- + +## Server Information + +**Server Name:** Firefrost Gaming +**Tagline:** *"Where Fire meets Frost - A Minecraft community forged in passion and precision"* + +**Top-Level Navigation:** +- 📅 Events +- 📜 Browse Channels +- 🛒 Server Shop +- 👥 Members +- 🚀 Server Boosts + +--- + +## Complete Channel Structure + +### **📍 ARRIVAL HALL** (Public - No subscription required) + +**Purpose:** First impression, orientation, basic community access + +**Channels:** +- **#🌅-welcome** - Automated greeting, server overview, brand introduction +- **#📜-the-charter** - Community values and conduct expectations (not "rules") +- **#📣-proclamations** - Official announcements from leadership +- **#🎭-awaken-your-path** - Role assignment after $1 Awakened purchase + +**Visibility:** Everyone (no subscription needed) + +--- + +### **🎮 THE CROSSROADS** (The Awakened - $1 subscribers) + +**Purpose:** Shared space for all Awakened members before Path commitment at $5 Elemental + +**Channels:** +- **#🗨️-the-commons** - General chat for Awakened members +- **#❓-seek-guidance** - Questions about Paths, how to choose, game help +- **#🎯-choose-your-destiny** - Information about Fire vs Frost benefits + +**Visibility:** Awakened tier ($1) and above +**Note:** Users can SEE Path-exclusive channels from here, but they're locked until $5 Elemental subscription + +--- + +### **🎮 SERVER NETWORKS** (Awakened + All Path subscribers) + +**Purpose:** In-game synced channels - bidirectional Discord ↔ Minecraft chat relay + +**Implementation:** One channel per server (15 total) + +#### **NC1 Charlotte Servers:** +- **#⚔️-ember-project** ↔️ The Ember Project (216.239.104.130:25565) +- **#🏰-minecolonies** ↔️ Minecolonies (216.239.104.131:25565) +- **#☮️-peace-of-mind** ↔️ Peace of Mind (216.239.104.132:25565) +- **#📦-sandbox-vacuum** ↔️ Sandbox in a Vacuum (216.239.104.133:25565) +- **#⚗️-all-the-mods-10** ↔️ All The Mods 10 (216.239.104.134:25565) +- **#🚜-farming-crossing-5** ↔️ Farming Crossing 5 (216.239.104.134:25566) +- **#🏡-homestead** ↔️ Homestead (216.239.104.133:25566) +- **#🎮-hytale** ↔️ Hytale (216.239.104.131:5520) +- **#⛏️-emc-subterra** ↔️ EMC Subterra Tech (216.239.104.132:25566) + +#### **TX1 Dallas Servers:** +- **#🪨-stoneblock-4** ↔️ Stoneblock 4 (38.68.14.26:25565) +- **#🌱-reclamation** ↔️ Reclamation (38.68.14.27:25565) +- **#🌄-sunlit-valley** ↔️ Society: Sunlit Valley (38.68.14.28:25565) +- **#🍦-vanilla-1211** ↔️ Vanilla 1.21.1 (38.68.14.29:25565) +- **#👾-all-the-mons** ↔️ All The Mons (38.68.14.30:25565) +- **#🎲-foundryvtt** ↔️ FoundryVTT (38.68.14.26:30000) + +**Technical Implementation:** +- DiscordSRV or similar plugin +- Messages from Discord appear in-game +- Messages from in-game appear in Discord +- Server name prefix shown in Discord for cross-server context + +**Visibility:** Awakened ($1) and above + +--- + +### **🔥 PATH OF FIRE** (Elemental+ Fire subscribers only) + +**Category Description:** *"The heart of the community. Where passion burns bright and bonds are forged."* + +**Purpose:** Meg's social/creative community space - Flamecrafters unite + +**Channels:** +- **#🔥-ignition-lounge** - Main Fire Path social hub +- **#🎨-creative-forge** - Community projects, builds, collaborative art +- **#🎉-ember-events** - Fire Path exclusive events and activities +- **#🎭-emissary-court** - Direct line to Meg, community leadership discussions +- **#📸-hall-of-flames** - Screenshot showcase, build galleries, achievements + +**Voice Channels:** +- **🔊 The Hearth** - Fire Path voice lounge (social hangout) +- **🔊 Forge Hall** - Fire Path gaming sessions + +**Category Header Display:** 🔥 PATH OF FIRE (Meg: [count] Flamecrafters) + +**Visibility:** Fire Elemental ($5) and above + Founders +**Chat Color:** `#FF3D00` (Deep Orange/Red) + +--- + +### **❄️ PATH OF FROST** (Elemental+ Frost subscribers only) + +**Category Description:** *"Where precision meets perfection. The architects of stability."* + +**Purpose:** Michael's technical/systems community space - Crystal Engineers unite + +**Channels:** +- **#❄️-frost-sanctum** - Main Frost Path technical hub +- **#🧊-the-laboratory** - Redstone, automation, technical builds discussion +- **#⚙️-system-insights** - Infrastructure discussion, behind-the-scenes tech +- **#📊-analytics-chamber** - Server performance data, optimization strategies +- **#🛠️-workshop** - Collaborative technical projects and planning +- **#🔬-wizard-council** - Direct line to Michael, technical leadership + +**Voice Channels:** +- **🔊 The Archive** - Frost Path voice lounge (technical hangout) +- **🔊 Engineering Bay** - Frost Path gaming/planning sessions + +**Category Header Display:** ❄️ PATH OF FROST (Michael: [count] Crystal Engineers) + +**Visibility:** Frost Elemental ($5) and above + Founders +**Chat Color:** `#00E5FF` (Electric Cyan) + +--- + +### **⚡ THE NEXUS** (Founder's Members Only - $499 lifetime) + +**Category Description:** *"Where Fire meets Frost. The bridge between passion and precision."* + +**Purpose:** Elite Founder-exclusive space - The Ascended + +**Channels:** +- **#⚡-ascension-hall** - Founder's exclusive lounge (social + technical) +- **#👑-founder-archives** - Legacy content, behind-the-scenes history, original planning docs +- **#🎁-ascended-perks** - Exclusive benefits, early access announcements +- **#💬-council-of-balance** - Direct governance input to both Michael & Meg + +**Voice Channel:** +- **🔊 The Throne Room** - Founder's voice lounge + +**Category Header Display:** ⚡ THE NEXUS (The Ascended) + +**Visibility:** Sovereign (Founder's) tier only +**Chat Color:** `#FFD600` (Amber Gold) + +--- + +### **🎲 FOUNDRY REALMS** (FoundryVTT Integration - Separate from Paths) + +**Purpose:** FoundryVTT campaign hosting, LFG, GM coordination + +**Public Channels (Visible to all):** +- **#📋-campaign-board** - Active campaigns, looking for players +- **#🎲-lfg-foundry** - Looking for group/GM matchmaking + +**Subscriber Channels (Awakened+):** +- **#💬-player-lounge** - General FoundryVTT discussion for players +- **#📚-rules-and-resources** - Tips, modules, how-to guides + +**GM Channels (GM Addon subscribers only):** +- **#🎩-gm-workshop** - GM-only discussion, prep help, storytelling tips +- **#⚙️-technical-support** - FoundryVTT setup, module troubleshooting +- **#🎨-asset-sharing** - Maps, tokens, custom content exchange + +**Note:** FoundryVTT GM addon is separate purchase from Fire/Frost paths + +**Visibility:** +- Public channels: Everyone +- Player channels: Awakened+ +- GM channels: GM addon subscribers only + +--- + +### **❄️ THE FROSTWALL** (Infrastructure & Support - Public visibility) + +**Purpose:** Transparency and public-facing infrastructure status + +**Channels:** +- **#❄️-network-status** - Uptime Kuma automated feed (Firefrost infrastructure monitoring) +- **#🔧-support-desk** - Player technical issues, help requests, troubleshooting +- **#📡-provider-watch** - Breezehost maintenance notifications (EXTERNAL provider, not Firefrost) + +**Visibility:** Everyone (transparency builds trust) +**Purpose:** Shows infrastructure stability, separates Firefrost systems from hosting provider issues + +--- + +### **⚡ COMMAND CENTER** (Staff Only - Hidden from members) + +**Purpose:** Leadership war room - Michael + Meg coordination + +**Channels:** +- **#⚡-war-council** - Strategic planning, leadership decisions +- **#🔐-moderator-command** - Future moderator coordination (when hired) +- **#📊-intelligence-room** - Analytics, metrics, Fire vs Frost competitive tracking +- **#🎯-campaign-planning** - Marketing, events, growth strategy + +**Visibility:** Leadership only (Michael, Meg) +**Future:** Moderators will gain access to #moderator-command when hired + +--- + +## Role Structure (Complete Hierarchy) + +### **👑 LEADERSHIP TIER** +- **🧙‍♂️ The Wizard** (Michael) - Owner, infrastructure lead, Path of Frost leader +- **🎭 The Emissary** (Meg) - Co-owner, community manager, Path of Fire leader + +**Colors:** +- The Wizard: `#00E5FF` (Cyan) +- The Emissary: `#FF3D00` (Orange/Red) + +--- + +### **⚡ ASCENDED TIER (Founders)** +- **⚡ Founder** - Lifetime members, access to BOTH Fire + Frost + +**Color:** `#FFD600` (Amber Gold) +**Access:** All Fire channels + All Frost channels + The Nexus + +--- + +### **🔥 FIRE PATH ROLES (Monthly Subscribers)** + +| Tier | Price | Discord Role | In-Game Prefix | +|------|-------|--------------|----------------| +| Elemental | $5/mo | 🔥 Fire Elemental | [🔥 Fire Elemental] | +| Knight | $10/mo | 🔥 Fire Knight | [🔥 Fire Knight] | +| Master | $15/mo | 🔥 Fire Master | [🔥 Fire Master] | +| Legend | $20/mo | 🔥 Fire Legend | [🔥 Fire Legend] | + +**Color:** `#FF3D00` (Deep Orange/Red) - matches Design Bible Fire Primary +**Access:** Fire Path exclusive channels + Server Networks + The Crossroads + +--- + +### **❄️ FROST PATH ROLES (Monthly Subscribers)** + +| Tier | Price | Discord Role | In-Game Prefix | +|------|-------|--------------|----------------| +| Elemental | $5/mo | ❄️ Frost Elemental | [❄️ Frost Elemental] | +| Knight | $10/mo | ❄️ Frost Knight | [❄️ Frost Knight] | +| Master | $15/mo | ❄️ Frost Master | [❄️ Frost Master] | +| Legend | $20/mo | ❄️ Frost Legend | [❄️ Frost Legend] | + +**Color:** `#00E5FF` (Electric Cyan) - matches Design Bible Frost Primary +**Access:** Frost Path exclusive channels + Server Networks + The Crossroads + +--- + +### **🌅 BASE TIER** +- **🌅 The Awakened** - $1 one-time payment, whitelisted on servers + +**Color:** `#FFFFFF` (White) +**Access:** The Crossroads + Server Networks (can SEE but not ACCESS Path channels) + +--- + +### **👤 PUBLIC TIER** +- **👤 Wanderer** - No subscription, Discord browsing only + +**Color:** Default gray +**Access:** Arrival Hall only, no server access + +--- + +## Gamification & Competition + +### **The Path Wars: Michael vs Meg** + +**Display Format:** +Discord category headers show live subscriber counts: +- 🔥 PATH OF FIRE (Meg: 124 Flamecrafters) +- ❄️ PATH OF FROST (Michael: 137 Crystal Engineers) + +**Competition Mechanics:** +- Both recruit from same Awakened ($1) pool +- Conversion battle: Awakened → Fire/Frost at $5 Elemental +- Monthly winner gets recognition +- Losing path leader does something fun/embarrassing (TBD) +- Founders can support both but choose allegiance per challenge + +**Path-Specific Events:** +- **Fire Path:** Community build competitions, social events, creative showcases +- **Frost Path:** Technical challenges, automation showcases, optimization competitions + +--- + +## Technical Integration + +### **Payment → Discord Role Flow** +1. User subscribes via Paymenter/Ghost CMS +2. Stripe processes payment +3. Webhook sent to Discord bot +4. Bot assigns appropriate role automatically +5. User instantly gains channel access +6. Leaderboard updates in category header + +### **Discord ↔ Minecraft Sync** +- **Plugin:** DiscordSRV or custom solution +- **Channels:** 15 server-specific channels (bidirectional relay) +- **Rank Display:** Discord role syncs to in-game chat prefix via LuckPerms + +### **Uptime Kuma → #network-status** +- Automated status updates +- Color-coded alerts: + - 🟢 All Systems Operational + - 🟡 Degraded Performance + - 🔴 Service Outage +- Server-specific incident reports + +--- + +## Channel Visibility Matrix + +| Channel Category | Wanderer | Awakened | Fire Path | Frost Path | Founder | +|------------------|----------|----------|-----------|------------|---------| +| Arrival Hall | ✅ | ✅ | ✅ | ✅ | ✅ | +| The Crossroads | ❌ | ✅ | ✅ | ✅ | ✅ | +| Server Networks | ❌ | ✅ | ✅ | ✅ | ✅ | +| Path of Fire | 🔒 Visible | 🔒 Visible | ✅ | 🔒 Visible | ✅ | +| Path of Frost | 🔒 Visible | 🔒 Visible | 🔒 Visible | ✅ | ✅ | +| The Nexus | ❌ Hidden | ❌ Hidden | ❌ Hidden | ❌ Hidden | ✅ | +| Foundry Realms (public) | ✅ | ✅ | ✅ | ✅ | ✅ | +| Foundry Realms (GM) | ❌ | GM addon | GM addon | GM addon | GM addon | +| The Frostwall | ✅ | ✅ | ✅ | ✅ | ✅ | +| Command Center | ❌ Hidden | ❌ Hidden | ❌ Hidden | ❌ Hidden | ❌ Staff | + +**Legend:** +- ✅ = Full access +- 🔒 Visible = Can see channel exists, but locked (drives FOMO/upgrades) +- ❌ Hidden = Cannot see channel at all + +--- + +## Current Community Members + +| Name | Role | Path Affiliation | Responsibilities | +|------|------|------------------|------------------| +| **Michael "Frostystyle"** | 🧙‍♂️ The Wizard | Frost Leader | Infrastructure, technical systems, Path of Frost recruitment | +| **Meg "Gingerfury"** | 🎭 The Emissary | Fire Leader | Community management, social events, Path of Fire recruitment | +| **Holly** | 👤 Member | TBD | Founding member, community support | + +**Target Growth:** 900+ members (referenced in planning docs) + +--- + +## Future Expansion + +### **Planned Additions:** + +**Moderator Tier:** +- **⚔️ Guardian** role (future moderators) +- Access to #moderator-command in Command Center +- Moderation permissions across all public channels + +**Additional Voice Channels:** +- Expand as community grows +- Event-specific temporary channels +- Private voice rooms for groups + +**Bot Integration:** +- Custom Firefrost bot for role assignment +- Welcome messages with personality +- Server info commands (`!servers`, `!tiers`, `!paths`) +- Uptime Kuma status bot + +--- + +## Builder Terminology (Community Language) + +When discussing Minecraft players: + +- **Fire Path members:** Flamecrafters (creative, community-focused) +- **Frost Path members:** Crystal Engineers (technical, automation-focused) +- **Founders:** Nexus Builders (balanced mastery) + +--- + +## Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| **1.0** | 2026-02-08 | Michael & Meg | Complete Discord structure finalized. Fire/Frost paths defined. Competitive framework established. | + +--- + +**END OF DOCUMENT** diff --git a/docs/luckperms-structure.md b/docs/luckperms-structure.md new file mode 100644 index 0000000..f75fde3 --- /dev/null +++ b/docs/luckperms-structure.md @@ -0,0 +1,704 @@ +# Firefrost Gaming: LuckPerms Structure + +**Version:** 1.0 +**Created:** February 8, 2026 +**Purpose:** Permission group hierarchy for multi-server Minecraft network +**Scope:** 13+ servers (NC1 Charlotte, TX1 Dallas) +**Implementation Status:** Planning phase + +--- + +## Overview + +LuckPerms manages all permission-based perks across the Firefrost Gaming network. This document defines the group hierarchy, inheritance structure, and specific permissions for each subscription tier. + +--- + +## Group Hierarchy + +### **Inheritance Tree:** +``` +default (no subscription) + └── awakened (Tier 1: $1 one-time) + ├── fire_elemental (Tier 2 Fire: $5/mo) + │ └── fire_knight (Tier 3 Fire: $10/mo) + │ └── fire_master (Tier 4 Fire: $15/mo) + │ └── fire_legend (Tier 5 Fire: $20/mo) + │ └── founder (Tier 6: $499 lifetime) + └── frost_elemental (Tier 2 Frost: $5/mo) + └── frost_knight (Tier 3 Frost: $10/mo) + └── frost_master (Tier 4 Frost: $15/mo) + └── frost_legend (Tier 5 Frost: $20/mo) + └── founder (Tier 6: $499 lifetime) +``` + +**Note:** Founder group inherits from BOTH `fire_legend` AND `frost_legend`, gaining all perks from both paths. + +--- + +## Permission Breakdown by Tier + +### **Tier 0: Default (No Subscription)** + +**Group Name:** `default` +**Subscription:** None +**Server Access:** NONE (not whitelisted) + +**Permissions:** +```yaml +permissions: + - essentials.list # Can see who's online + - essentials.motd # Can see server MOTD +``` + +**Purpose:** Placeholder group for unsubscribed users. No actual server access. + +--- + +### **Tier 1: The Awakened ($1 One-Time)** + +**Group Name:** `awakened` +**Subscription:** $1.00 one-time payment +**Server Access:** All 13+ servers (whitelisted) +**Inherits From:** `default` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.1 # 1 home maximum + - ftbessentials.sethome # Can set home + - ftbessentials.home # Can teleport home + + # Chunk Claims + - ftbchunks.max_claimed.0 # 0 claimed chunks + - ftbchunks.max_force_loaded.0 # 0 force-loaded chunks + + # Random Teleport + # NO /rtp access at this tier + + # Chat Formatting + - luckperms.prefix.awakened +``` + +**Chat Prefix:** +```yaml +prefix: "[The Awakened] " +color: "#FFFFFF" # White +``` + +**Purpose:** Basic server access with minimal perks. Users explore and decide if they want to commit to a Path. + +--- + +### **Tier 2: Elemental ($5/month) - FIRE PATH** + +**Group Name:** `fire_elemental` +**Subscription:** $5.00/month (Fire Path) +**Server Access:** All 13+ servers +**Inherits From:** `awakened` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.5 # 5 homes (overrides awakened limit) + + # Chunk Claims + - ftbchunks.max_claimed.25 # 25 claimed chunks + - ftbchunks.max_force_loaded.0 # 0 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp # /rtp access + - ftbessentials.rtp.cooldown.3600 # 60 minute cooldown (3600 seconds) + + # Chat Formatting + - luckperms.prefix.fire_elemental +``` + +**Chat Prefix:** +```yaml +prefix: "[🔥 Fire Elemental] " +color: "#FF3D00" # Deep Orange/Red (Fire Primary) +``` + +--- + +### **Tier 2: Elemental ($5/month) - FROST PATH** + +**Group Name:** `frost_elemental` +**Subscription:** $5.00/month (Frost Path) +**Server Access:** All 13+ servers +**Inherits From:** `awakened` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.5 # 5 homes (overrides awakened limit) + + # Chunk Claims + - ftbchunks.max_claimed.25 # 25 claimed chunks + - ftbchunks.max_force_loaded.0 # 0 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp # /rtp access + - ftbessentials.rtp.cooldown.3600 # 60 minute cooldown (3600 seconds) + + # Chat Formatting + - luckperms.prefix.frost_elemental +``` + +**Chat Prefix:** +```yaml +prefix: "[❄️ Frost Elemental] " +color: "#00E5FF" # Electric Cyan (Frost Primary) +``` + +**Note:** Fire and Frost Elemental have IDENTICAL mechanical permissions. Only prefix/color differ. + +--- + +### **Tier 3: Knight ($10/month) - FIRE PATH** + +**Group Name:** `fire_knight` +**Subscription:** $10.00/month (Fire Path) +**Inherits From:** `fire_elemental` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.10 # 10 homes (overrides elemental limit) + + # Chunk Claims + - ftbchunks.max_claimed.49 # 49 claimed chunks + - ftbchunks.max_force_loaded.4 # 4 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp.cooldown.1800 # 30 minute cooldown (1800 seconds) + + # Chat Formatting + - luckperms.prefix.fire_knight +``` + +**Chat Prefix:** +```yaml +prefix: "[🔥 Fire Knight] " +color: "#FF3D00" +``` + +--- + +### **Tier 3: Knight ($10/month) - FROST PATH** + +**Group Name:** `frost_knight` +**Subscription:** $10.00/month (Frost Path) +**Inherits From:** `frost_elemental` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.10 # 10 homes + + # Chunk Claims + - ftbchunks.max_claimed.49 # 49 claimed chunks + - ftbchunks.max_force_loaded.4 # 4 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp.cooldown.1800 # 30 minute cooldown + + # Chat Formatting + - luckperms.prefix.frost_knight +``` + +**Chat Prefix:** +```yaml +prefix: "[❄️ Frost Knight] " +color: "#00E5FF" +``` + +--- + +### **Tier 4: Master ($15/month) - FIRE PATH** + +**Group Name:** `fire_master` +**Subscription:** $15.00/month (Fire Path) +**Inherits From:** `fire_knight` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.20 # 20 homes + + # Chunk Claims + - ftbchunks.max_claimed.100 # 100 claimed chunks + - ftbchunks.max_force_loaded.9 # 9 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp.cooldown.900 # 15 minute cooldown (900 seconds) + + # Chat Formatting + - luckperms.prefix.fire_master +``` + +**Chat Prefix:** +```yaml +prefix: "[🔥 Fire Master] " +color: "#FF3D00" +``` + +--- + +### **Tier 4: Master ($15/month) - FROST PATH** + +**Group Name:** `frost_master` +**Subscription:** $15.00/month (Frost Path) +**Inherits From:** `frost_knight` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.20 # 20 homes + + # Chunk Claims + - ftbchunks.max_claimed.100 # 100 claimed chunks + - ftbchunks.max_force_loaded.9 # 9 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp.cooldown.900 # 15 minute cooldown + + # Chat Formatting + - luckperms.prefix.frost_master +``` + +**Chat Prefix:** +```yaml +prefix: "[❄️ Frost Master] " +color: "#00E5FF" +``` + +--- + +### **Tier 5: Legend ($20/month) - FIRE PATH** + +**Group Name:** `fire_legend` +**Subscription:** $20.00/month (Fire Path) +**Inherits From:** `fire_master` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.35 # 35 homes + + # Chunk Claims + - ftbchunks.max_claimed.121 # 121 claimed chunks + - ftbchunks.max_force_loaded.16 # 16 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp.cooldown.600 # 10 minute cooldown (600 seconds) + + # Chat Formatting + - luckperms.prefix.fire_legend +``` + +**Chat Prefix:** +```yaml +prefix: "[🔥 Fire Legend] " +color: "#FF3D00" +``` + +--- + +### **Tier 5: Legend ($20/month) - FROST PATH** + +**Group Name:** `frost_legend` +**Subscription:** $20.00/month (Frost Path) +**Inherits From:** `frost_master` + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.35 # 35 homes + + # Chunk Claims + - ftbchunks.max_claimed.121 # 121 claimed chunks + - ftbchunks.max_force_loaded.16 # 16 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp.cooldown.600 # 10 minute cooldown + + # Chat Formatting + - luckperms.prefix.frost_legend +``` + +**Chat Prefix:** +```yaml +prefix: "[❄️ Frost Legend] " +color: "#00E5FF" +``` + +--- + +### **Tier 6: Sovereign (Founder's) ($499 Lifetime)** + +**Group Name:** `founder` +**Subscription:** $499.00 lifetime +**Inherits From:** `fire_legend` AND `frost_legend` (both simultaneously) + +**Permissions:** +```yaml +permissions: + # Home Management + - ftbessentials.home.limit.50 # 50 homes + + # Chunk Claims + - ftbchunks.max_claimed.225 # 225 claimed chunks + - ftbchunks.max_force_loaded.81 # 81 force-loaded chunks + + # Random Teleport + - ftbessentials.rtp # /rtp access + - ftbessentials.rtp.bypass # NO COOLDOWN (bypass cooldown check) + + # Chat Formatting + - luckperms.prefix.founder +``` + +**Chat Prefix:** +```yaml +prefix: "[⚡ Founder] " +color: "#FFD600" # Amber Gold +``` + +**Special Note:** Founder group inherits ALL permissions from BOTH `fire_legend` AND `frost_legend`, gaining complete access to both paths. + +--- + +## Discord Role → LuckPerms Sync + +### **Mapping Table:** + +| Discord Role | LuckPerms Group | Auto-Assign | +|--------------|-----------------|-------------| +| 🌅 The Awakened | `awakened` | ✅ | +| 🔥 Fire Elemental | `fire_elemental` | ✅ | +| 🔥 Fire Knight | `fire_knight` | ✅ | +| 🔥 Fire Master | `fire_master` | ✅ | +| 🔥 Fire Legend | `fire_legend` | ✅ | +| ❄️ Frost Elemental | `frost_elemental` | ✅ | +| ❄️ Frost Knight | `frost_knight` | ✅ | +| ❄️ Frost Master | `frost_master` | ✅ | +| ❄️ Frost Legend | `frost_legend` | ✅ | +| ⚡ Founder | `founder` | ✅ | + +**Implementation Method:** DiscordSRV or custom Discord bot with LuckPerms API integration + +**Flow:** +1. User subscribes via Paymenter/Ghost CMS +2. Stripe webhook triggers Discord role assignment +3. Discord bot detects role change +4. Bot calls LuckPerms API to assign corresponding group +5. User logs into any server → permissions instantly active + +--- + +## Multi-Server Implementation Strategy + +### **Challenge:** +13+ Minecraft servers need identical permission configurations + +### **Recommended Solution: LuckPerms MySQL Backend** + +**Architecture:** +``` +[MySQL Database] (Single source of truth) + ↓ + ┌───┴───┬───────┬───────┐ + ↓ ↓ ↓ ↓ +[Server1][Server2][Server3]...[Server13+] +``` + +**Benefits:** +- ✅ Single database for all servers +- ✅ Update once, applies everywhere instantly +- ✅ No config file syncing required +- ✅ Centralized management +- ✅ Real-time permission changes across network + +**Setup:** +1. Install MySQL on Command Center (or dedicated database server) +2. Create `firefrost_perms` database +3. Configure each server's LuckPerms to use MySQL storage +4. All servers read/write from same database +5. Manage permissions from any server (or web interface) + +### **Alternative: Config File Distribution (Not Recommended)** + +**If MySQL not viable:** +- Use Ansible/scripting to push LuckPerms configs via SSH +- Manual updates required +- Risk of desync between servers +- More maintenance overhead + +**Recommendation:** Use MySQL backend for production. It's the industry standard for multi-server networks. + +--- + +## FTB Chunks Configuration + +### **Per-Server Config File:** `config/ftbchunks/config.snbt` + +**Key Settings:** +```snbt +{ + max_claimed_chunks: { + default: 0, + awakened: 0, + fire_elemental: 25, + frost_elemental: 25, + fire_knight: 49, + frost_knight: 49, + fire_master: 100, + frost_master: 100, + fire_legend: 121, + frost_legend: 121, + founder: 225 + }, + + max_force_loaded_chunks: { + default: 0, + awakened: 0, + fire_elemental: 0, + frost_elemental: 0, + fire_knight: 4, + frost_knight: 4, + fire_master: 9, + frost_master: 9, + fire_legend: 16, + frost_legend: 16, + founder: 81 + } +} +``` + +**Note:** FTB Chunks reads LuckPerms groups directly. No separate permission nodes needed. + +--- + +## FTB Essentials Configuration + +### **Per-Server Config File:** `config/ftbessentials.snbt` + +**Key Settings:** +```snbt +{ + homes: { + max_homes: { + default: 0, + awakened: 1, + fire_elemental: 5, + frost_elemental: 5, + fire_knight: 10, + frost_knight: 10, + fire_master: 20, + frost_master: 20, + fire_legend: 35, + frost_legend: 35, + founder: 50 + } + }, + + rtp: { + enabled: true, + cooldown: { + awakened: -1, # Disabled (no /rtp access) + fire_elemental: 3600, # 60 minutes + frost_elemental: 3600, # 60 minutes + fire_knight: 1800, # 30 minutes + frost_knight: 1800, # 30 minutes + fire_master: 900, # 15 minutes + frost_master: 900, # 15 minutes + fire_legend: 600, # 10 minutes + frost_legend: 600, # 10 minutes + founder: 0 # No cooldown + } + } +} +``` + +--- + +## Chat Formatting (LuckPerms Prefixes) + +### **Per-Group Prefix Configuration:** +```yaml +# awakened +meta: + prefix: "&f[The Awakened] " # White color + +# fire_elemental +meta: + prefix: "&#FF3D00[🔥 Fire Elemental] " # Deep Orange/Red + +# frost_elemental +meta: + prefix: "�E5FF[❄️ Frost Elemental] " # Electric Cyan + +# fire_knight +meta: + prefix: "&#FF3D00[🔥 Fire Knight] " + +# frost_knight +meta: + prefix: "�E5FF[❄️ Frost Knight] " + +# fire_master +meta: + prefix: "&#FF3D00[🔥 Fire Master] " + +# frost_master +meta: + prefix: "�E5FF[❄️ Frost Master] " + +# fire_legend +meta: + prefix: "&#FF3D00[🔥 Fire Legend] " + +# frost_legend +meta: + prefix: "�E5FF[❄️ Frost Legend] " + +# founder +meta: + prefix: "&#FFD600[⚡ Founder] " # Amber Gold +``` + +**Note:** Hex color codes use `&#RRGGBB` format in LuckPerms. + +--- + +## Implementation Checklist + +### **Phase 1: Database Setup** +- [ ] Install MySQL on Command Center (or dedicated server) +- [ ] Create `firefrost_perms` database +- [ ] Create LuckPerms database user with appropriate permissions +- [ ] Document database credentials (store securely, not in Git) + +### **Phase 2: LuckPerms Configuration** +- [ ] Install LuckPerms on all 13+ servers +- [ ] Configure each server to use MySQL storage +- [ ] Verify all servers connect to same database +- [ ] Create all permission groups (awakened → founder) +- [ ] Set up group inheritance hierarchy +- [ ] Configure chat prefixes and colors + +### **Phase 3: FTB Integration** +- [ ] Configure FTB Chunks per-server (chunk limits) +- [ ] Configure FTB Essentials per-server (homes, /rtp) +- [ ] Test chunk claiming at each tier +- [ ] Test home limits at each tier +- [ ] Test /rtp cooldowns at each tier + +### **Phase 4: Discord Integration** +- [ ] Set up Discord bot with LuckPerms API access +- [ ] Configure Discord role → LuckPerms group mapping +- [ ] Test automatic group assignment on subscription +- [ ] Test group changes on tier upgrades +- [ ] Test Founder dual-inheritance (Fire + Frost) + +### **Phase 5: Testing & Validation** +- [ ] Create test accounts at each tier +- [ ] Verify permissions work correctly per tier +- [ ] Test across multiple servers (verify MySQL sync) +- [ ] Test tier upgrades (Elemental → Knight → Master) +- [ ] Test path switching (if implemented) +- [ ] Verify Founder gets all Fire + Frost perks + +--- + +## Troubleshooting + +### **Common Issues:** + +**Problem:** Permissions not syncing across servers +**Solution:** Verify all servers connect to same MySQL database. Check `config/luckperms/config.yml` storage settings. + +**Problem:** User has wrong permissions after subscription +**Solution:** Check Discord role assignment. Verify LuckPerms group matches Discord role. Use `/lp user info` to debug. + +**Problem:** /rtp cooldown not working correctly +**Solution:** FTB Essentials reads cooldown from config file, not LuckPerms permissions. Update `ftbessentials.snbt` directly. + +**Problem:** Chunk claim limits not enforcing +**Solution:** FTB Chunks reads group names from LuckPerms. Verify group names match exactly (case-sensitive). + +**Problem:** Chat prefixes not displaying colors +**Solution:** Verify hex color format (`&#RRGGBB`). Ensure chat plugin supports hex colors (MC 1.16+). + +--- + +## Security Considerations + +### **MySQL Database:** +- Use strong password for `firefrost_perms` user +- Restrict database access to Firefrost server IPs only +- Regular backups (daily recommended) +- Store credentials in `.env` file, NOT in Git + +### **LuckPerms Web Editor:** +- Enable only if needed +- Use strong authentication +- Restrict IP access if possible +- Disable after bulk edits complete + +--- + +## Maintenance + +### **Regular Tasks:** + +**Weekly:** +- Review active groups and user counts +- Check for permission conflicts or issues + +**Monthly:** +- Database backup verification +- Review group hierarchy for optimization +- Update documentation if structure changes + +**Per-Update:** +- Test new Minecraft/mod versions for compatibility +- Verify FTB Chunks/Essentials still read LuckPerms correctly +- Update permission nodes if mods change + +--- + +## Future Enhancements + +### **Potential Additions:** + +- **Cosmetic perks** - Particle effects, custom skins (when implemented) +- **Quality-of-life commands** - `/workbench`, `/hat`, etc. (when approved) +- **WorldEdit permissions** - For creative/technical builds (tier-specific limits) +- **Flight permissions** - Creative flight in claimed chunks (higher tiers) +- **Additional modpack-specific perks** - Per-server customization + +**Note:** Only add perks that are actually implementable and tested. Don't promise features that don't exist yet. + +--- + +## Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| **1.0** | 2026-02-08 | Michael | Initial LuckPerms structure documented. MySQL backend recommended. Complete group hierarchy defined. | + +--- + +**END OF DOCUMENT** diff --git a/docs/path-philosophy.md b/docs/path-philosophy.md new file mode 100644 index 0000000..bad428b --- /dev/null +++ b/docs/path-philosophy.md @@ -0,0 +1,349 @@ +# Firefrost Gaming: Path Philosophy + +**Version:** 1.0 +**Created:** February 8, 2026 +**Purpose:** Ghost CMS content - explaining Fire vs Frost to potential subscribers +**Target Audience:** New members deciding which path to choose + +--- + +## The Choice That Defines Your Journey + +At Firefrost Gaming, we believe in **balance**. Not the kind that makes everything bland and identical, but the kind that emerges when two powerful forces stand in perfect opposition. + +**Fire** - Passion, creativity, community +**Frost** - Precision, systems, infrastructure + +When you reach the Elemental tier ($5/month), you'll make a choice that shapes your entire Firefrost experience: + +> **Will you walk the Path of Fire, or the Path of Frost?** + +--- + +## 🔥 Path of Fire: The Way of the Flamecrafter + +### **The Philosophy** + +*"Magic is not chaos—it's creation given form. We build worlds not with logic gates, but with imagination and community."* + +The Path of Fire celebrates the **creative heart** of Minecraft. We're inspired by the organic beauty of magic mods, the collaborative spirit of community builds, and the joy of transforming raw materials into living art. + +### **Inspired By Magic Mods:** + +- **Mystical Agriculture** - Growing resources from nothing, transforming simple seeds into infinite possibility +- **Ars Nouveau** - Spell crafting, enchanting, and the arcane arts +- **Botania** - Living automation through flowers and mana, beauty with function + +**If you've ever:** +- Built a massive garden automation system and called it "pretty" +- Spent hours perfecting the aesthetics of your base +- Chosen a modpack because it had cool magic systems +- Loved collaborating on community projects +- Valued the social bonds of your server as much as the builds + +**...then the Fire Path is calling you.** + +### **What Fire Means:** + +🔥 **Community First** - Your fellow Flamecrafters are your strength +🔥 **Creative Freedom** - Build what inspires you, not just what's optimal +🔥 **Social Connection** - Discord channels focused on events, collaboration, and shared experiences +🔥 **Aesthetic Excellence** - Beauty matters as much as function + +### **Led By The Emissary** + +**Meg "Gingerfury"** - Community manager, social architect, keeper of the flame + +Meg believes that Minecraft is fundamentally a **social experience**. The best builds aren't measured in efficiency—they're measured in the memories made while creating them. + +**The Fire Path Discord** is your hearth. It's where friendships are forged, community events are planned, and creative ideas catch fire and spread. + +### **Your Fire Path Experience:** + +**Discord Channels:** +- 🔥 Ignition Lounge (main social hub) +- 🎨 Creative Forge (build showcases and collaborations) +- 🎉 Ember Events (Fire Path exclusive activities) +- 🎭 Emissary Court (direct line to Meg) +- 📸 Hall of Flames (screenshot galleries) + +**In-Game Identity:** +- Chat prefix: `[🔥 Fire Elemental]` → `[🔥 Fire Legend]` +- Color: `#FF3D00` (Deep Orange/Red - warm, welcoming, passionate) + +**Community Culture:** +- Build competitions and collaborative projects +- Social events and community gatherings +- Creative challenges and artistic showcases +- The warmth of belonging to something bigger + +--- + +## ❄️ Path of Frost: The Way of the Crystal Engineer + +### **The Philosophy** + +*"Efficiency is elegance. Automation is artistry. A well-designed system is the purest form of creation."* + +The Path of Frost honors the **technical mastery** of Minecraft. We're inspired by the precision of industrial automation, the satisfaction of optimized systems, and the beauty of machines working in perfect harmony. + +### **Inspired By Tech Mods:** + +- **Create** - Mechanical automation, gears and pistons, kinetic energy made tangible +- **Mekanism** - Industrial processing, power generation, the ultimate tech mod +- **Applied Energistics / Refined Storage** - Digital perfection, infinite storage, instant access + +**If you've ever:** +- Spent days optimizing a factory to run at maximum efficiency +- Felt genuine satisfaction watching redstone contraptions work flawlessly +- Chosen a modpack specifically for its tech tree depth +- Calculated ore processing multipliers for fun +- Valued the elegance of a perfectly designed system + +**...then the Frost Path awaits you.** + +### **What Frost Means:** + +❄️ **Technical Excellence** - Mastery through understanding and optimization +❄️ **Systematic Thinking** - Build systems, not just structures +❄️ **Infrastructure Focus** - The foundation matters as much as the facade +❄️ **Precision Engineering** - Every block placed with purpose + +### **Led By The Wizard** + +**Michael "Frostystyle"** - Infrastructure architect, technical lead, master of systems + +Michael believes that Minecraft is fundamentally a **problem-solving sandbox**. The best builds aren't judged by appearance—they're judged by how well they solve complex challenges with elegant solutions. + +**The Frost Path Discord** is your laboratory. It's where technical discussions happen, automation strategies are shared, and system designs are perfected. + +### **Your Frost Path Experience:** + +**Discord Channels:** +- ❄️ Frost Sanctum (main technical hub) +- 🧊 The Laboratory (redstone, automation, technical builds) +- ⚙️ System Insights (infrastructure deep-dives) +- 📊 Analytics Chamber (server performance data) +- 🔬 Wizard Council (direct line to Michael) + +**In-Game Identity:** +- Chat prefix: `[❄️ Frost Elemental]` → `[❄️ Frost Legend]` +- Color: `#00E5FF` (Electric Cyan - cool, precise, technical) + +**Community Culture:** +- Automation showcases and technical challenges +- Redstone contraption competitions +- Optimization strategies and efficiency discussions +- The satisfaction of systems running perfectly + +--- + +## ⚡ The Sovereign Path: The Ascended + +### **When Fire Meets Frost** + +*"True mastery isn't choosing between passion and precision—it's embodying both."* + +**Founders** ($499 lifetime) don't choose between Fire and Frost. +**They transcend the choice entirely.** + +### **The Nexus Builder** + +As a Sovereign, you are **The Ascended**—a bridge between two worlds: + +⚡ **Full Fire Path access** - All social channels, community events, creative spaces +⚡ **Full Frost Path access** - All technical channels, automation discussions, system insights +⚡ **Exclusive Founder channels** - The Nexus (elite-only space) +⚡ **Council voting rights** - Direct governance input to both Michael and Meg + +**Your in-game prefix:** `[⚡ Founder]` in `#FFD600` (Amber Gold) + +**You represent the complete Firefrost philosophy:** Passion AND Precision. Fire AND Frost. United. + +--- + +## Which Path Should You Choose? + +### **Choose Fire If:** + +- You love magic mods (Botania, Ars Nouveau, Mystical Agriculture) +- You value community and social connection +- You enjoy collaborative builds and group projects +- Aesthetics matter as much as function +- You want to be part of Meg's creative community + +### **Choose Frost If:** + +- You love tech mods (Create, Mekanism, industrial automation) +- You value efficiency and optimization +- You enjoy solo technical projects and complex systems +- Function and precision are your primary goals +- You want to be part of Michael's technical community + +### **Choose Sovereign (Both) If:** + +- You refuse to limit yourself to one playstyle +- You want the complete Firefrost experience +- You value both community AND technical excellence +- You're ready for lifetime commitment +- You want elite recognition and governance rights + +--- + +## The Competitive Element: Michael vs Meg + +### **The Path Wars** + +Fire and Frost aren't just philosophies—they're **competing communities** led by two passionate leaders: + +**🔥 Meg "The Emissary"** - Fighting for Fire, recruiting Flamecrafters +**❄️ Michael "The Wizard"** - Fighting for Frost, recruiting Crystal Engineers + +**The Competition:** +- Live subscriber counts displayed in Discord +- Monthly challenges and path-specific events +- Community bragging rights +- Losing leader faces fun consequences + +**You're not just choosing a playstyle—you're choosing a side in a friendly rivalry.** + +--- + +## What's The Same? (No Matter Which Path) + +### **Identical Mechanical Perks:** + +| Tier | Homes | Chunks | Force-Load | /rtp Cooldown | +|------|-------|--------|------------|---------------| +| Elemental ($5) | 5 | 25 | 0 | 60 min | +| Knight ($10) | 10 | 49 | 4 | 30 min | +| Master ($15) | 20 | 100 | 9 | 15 min | +| Legend ($20) | 35 | 121 | 16 | 10 min | +| Sovereign ($499) | 50 | 225 | 81 | None | + +**Your path choice does NOT affect:** +- Server access (all 13+ servers regardless of path) +- In-game perks (homes, chunks, force-load, /rtp) +- Server performance or priority +- Technical capabilities + +**Your path choice DOES affect:** +- Discord channel access (Fire channels vs Frost channels) +- Community you're part of (Flamecrafters vs Crystal Engineers) +- Leadership you interact with (Meg vs Michael) +- Chat color and prefix display in-game + +--- + +## Can I Switch Paths? + +**Short answer:** Not currently. + +**Why:** Your path choice represents a **community commitment**, not just a feature toggle. When you choose Fire, you're joining Meg's community. When you choose Frost, you're joining Michael's community. + +**Exception:** Sovereign (Founder's) tier gets BOTH paths permanently. + +**Future consideration:** Path migration may be allowed in special circumstances, but it's designed to be a meaningful choice, not a casual swap. + +--- + +## The Philosophy in Action + +### **Fire Path Example:** + +Imagine you're building a massive enchanted garden using Botania and Mystical Agriculture. You're not optimizing for maximum efficiency—you're creating a beautiful, living space that uses magic to automate resource generation. + +You share progress screenshots in #hall-of-flames. Other Flamecrafters offer design suggestions. Meg hosts a community build event where everyone collaborates on a central magical hub. You spend an entire weekend working together, laughing in voice chat, building something beautiful as a team. + +**That's the Fire Path.** + +### **Frost Path Example:** + +Imagine you're building a massive ore processing factory using Create and Mekanism. Every conveyor belt is calculated. Every machine placement is optimized. You're achieving 10x ore multiplication with zero bottlenecks. + +You share your system schematic in #the-laboratory. Other Crystal Engineers analyze your design and suggest efficiency improvements. Michael posts server performance analytics showing your factory is the most optimized on the network. You spend hours fine-tuning belt speeds and power distribution until it's perfect. + +**That's the Frost Path.** + +### **Sovereign Example:** + +Imagine you're building a megabase that combines BOTH approaches. The exterior is a stunning artistic masterpiece using magical aesthetics. The interior is a technical marvel of industrial automation. You discuss design in Fire channels and optimization in Frost channels. You embody the complete Firefrost philosophy. + +**That's The Ascended.** + +--- + +## Your Journey Starts at The Awakened + +**Before you choose a path, you start at The Awakened ($1 one-time):** + +- Access all 13+ Minecraft servers +- Join The Crossroads Discord channels +- Explore both playstyles +- Talk to Fire and Frost members +- Decide which community fits you + +**At Elemental ($5/month), you commit to a path and unlock:** +- Path-exclusive Discord channels +- In-game chat colors and prefix +- Community identity and belonging +- Your role in the Fire vs Frost competition + +--- + +## The Question You Must Answer + +**When you reach the crossroads, you'll face this choice:** + +> **Do you burn with passion, or freeze with precision?** +> **Do you build with magic, or engineer with machinery?** +> **Do you value community warmth, or systematic excellence?** + +There is no wrong answer. + +**Fire and Frost are equal in power, opposite in philosophy.** + +The only question is: + +**Which one is YOU?** + +--- + +## Ready to Choose? + +Visit [firefrostgaming.com](https://firefrostgaming.com) to start your journey. + +**$1 - The Awakened** - Entry to the family +**$5 - Elemental** - Choose Fire or Frost +**$499 - Sovereign** - Ascend beyond choice + +--- + +**🔥 Fire + Frost ❄️** +**Passion + Precision** +**Magic + Machinery** +**Community + Systems** + +**Where will you stand?** + +--- + +## Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| **1.0** | 2026-02-08 | Michael & Meg | Initial path philosophy document for Ghost CMS | + + +--- + +## **TODO - Next Revision:** + +- [ ] Remove "Michael" references - use only "Frostystyle" (public-facing doc) +- [ ] Remove "Meg" references - use only "Gingerfury" (public-facing doc) +- [ ] Review entire document for any other real name usage + + +--- + +**END OF DOCUMENT** diff --git a/docs/subscription-tiers-final.md b/docs/subscription-tiers-final.md new file mode 100644 index 0000000..abd010c --- /dev/null +++ b/docs/subscription-tiers-final.md @@ -0,0 +1,515 @@ +# Firefrost Gaming: Subscription Tier Structure + +**Version:** 1.0 +**Created:** February 8, 2026 +**Status:** Final - Approved by Michael & Meg +**Payment Processor:** Stripe +**Primary Platform:** Minecraft (13+ servers) + +--- + +## The Foundation: Fire + Frost Philosophy + +Firefrost Gaming operates on a **dual-path subscription model** that reflects the balance of passion and precision: + +- **🔥 Path of Fire** - *The Way of the Flamecrafter* +- **❄️ Path of Frost** - *The Way of the Crystal Engineer* + +Both paths offer **identical mechanical perks** but different **community identity and Discord access**. + +--- + +## The $1.00 "Awakened" Gateway (The Handshake) + +### Purpose +The $1.00 one-time payment is **not a revenue stream** - it is a **security protocol**. + +**Core Philosophy:** +> *"If you want to be an asshole, you have to pay for it."* + +### What The Handshake Provides: +1. **🛡️ Bot & Troll Frostwall** - Financial friction stops 99% of automated spam and drive-by harassment +2. **📋 Traceability & Accountability** - Payment creates financial identity trail, enables permanent bans +3. **🧠 Psychological Investment** - Even $1 creates "citizen mindset" and community respect +4. **🎮 Server Whitelist** - Access to all 13+ Firefrost Minecraft servers +5. **⚙️ Technical Gateway** - Automated webhook → Discord role → whitelist sync + +### What It Does NOT Do: +- ❌ Age verification (handled separately with proper legal methods) +- ❌ Revenue generation (this is infrastructure protection) + +**Meg's Pitch (The Emissary):** +*"One dollar, one time, one family. The Handshake proves you're here to build with us, not break what we've made."* + +--- + +## Complete Tier Progression + +| Tier | Price | Server Access | Homes | Chunks | Force-Load | /rtp Cooldown | Path | +|------|-------|---------------|-------|--------|------------|---------------|------| +| **Wanderer** | Free | ❌ None | 0 | 0 | 0 | ❌ None | None | +| **Awakened** | $1 (once) | ✅ All servers | 1 | 0 | 0 | ❌ None | Pre-Path | +| **Elemental** | $5/mo | ✅ All servers | 5 | 25 | 0 | 60 min | **Fire OR Frost** | +| **Knight** | $10/mo | ✅ All servers | 10 | 49 | 4 | 30 min | Fire OR Frost | +| **Master** | $15/mo | ✅ All servers | 20 | 100 | 9 | 15 min | Fire OR Frost | +| **Legend** | $20/mo | ✅ All servers | 35 | 121 | 16 | 10 min | Fire OR Frost | +| **Sovereign** | $499 (life) | ✅ All servers | 50 | 225 | 81 | None | **BOTH** | + +--- + +## Tier Descriptions + +### Tier 0: Wanderer (Free) +**Status:** No subscription +**Access:** Discord public channels only +**Server Access:** None (not whitelisted) +**Purpose:** Browse community, see what Firefrost offers, decide if they want to join + +--- + +### Tier 1: The Awakened ($1.00 One-Time) +**Status:** Pre-Path (no Fire/Frost assignment yet) +**Server Access:** Whitelisted on all 13+ Minecraft servers +**Discord Access:** The Crossroads channels (can see Path channels, but locked until $5 Elemental) + +**In-Game Perks:** +- **1 home** - `/sethome` and `/home` commands +- **0 claimed chunks** - Cannot claim territory yet +- **0 force-loaded chunks** - No persistent chunk loading +- **No `/rtp` access** - Cannot random teleport + +**Chat Display:** +``` +[The Awakened] PlayerName: message here +``` +Color: `#FFFFFF` (White) + +**Purpose:** Entry to the family. Prove you're serious. Explore servers with minimal perks. Decide if you want to commit to a Path at $5. + +**The Handshake:** This payment unlocks permanent server whitelist and Discord community membership. + +--- + +### Tier 2: Elemental ($5.00/month) +**Status:** **CHOOSE YOUR PATH** - Fire OR Frost +**Server Access:** All 13+ Minecraft servers +**Discord Access:** Path-exclusive channels unlock + +**In-Game Perks:** +- **5 homes** - Multiple safe points across servers +- **25 claimed chunks** - Protected territory +- **0 force-loaded chunks** - Chunks unload when offline +- **`/rtp` with 60 minute cooldown** - Random teleport exploration + +**Discord Roles & Chat Display:** + +**Fire Elemental:** +``` +[🔥 Fire Elemental] Gingerfury: message here +``` +Color: `#FF3D00` (Deep Orange/Red - Fire Primary) + +**Frost Elemental:** +``` +[❄️ Frost Elemental] Frostystyle: message here +``` +Color: `#00E5FF` (Electric Cyan - Frost Primary) + +**Path Identity:** +- **Fire Path:** Access to Fire-exclusive Discord channels, Flamecrafter community +- **Frost Path:** Access to Frost-exclusive Discord channels, Crystal Engineer community + +**Purpose:** Commit to a path. Join either Meg's Fire community or Michael's Frost infrastructure. Begin building with territory protection. + +--- + +### Tier 3: Knight ($10.00/month) +**Status:** Fire OR Frost (chosen at Elemental) +**Server Access:** All 13+ Minecraft servers + +**In-Game Perks:** +- **10 homes** - Expanded mobility across network +- **49 claimed chunks** - Medium-sized protected base +- **4 force-loaded chunks** - Small automation stays active 24/7 +- **`/rtp` with 30 minute cooldown** - More frequent exploration + +**Chat Display:** + +**Fire Knight:** +``` +[🔥 Fire Knight] PlayerName: message here +``` +Color: `#FF3D00` + +**Frost Knight:** +``` +[❄️ Frost Knight] PlayerName: message here +``` +Color: `#00E5FF` + +**Purpose:** Deeper commitment. Automation begins with force-loaded chunks. Larger builds supported. + +--- + +### Tier 4: Master ($15.00/month) +**Status:** Fire OR Frost +**Server Access:** All 13+ Minecraft servers + +**In-Game Perks:** +- **20 homes** - Maximum mobility and organization +- **100 claimed chunks** - Large-scale protected territory +- **9 force-loaded chunks** - Medium automation networks +- **`/rtp` with 15 minute cooldown** - Regular exploration capability + +**Chat Display:** + +**Fire Master:** +``` +[🔥 Fire Master] PlayerName: message here +``` +Color: `#FF3D00` + +**Frost Master:** +``` +[❄️ Frost Master] PlayerName: message here +``` +Color: `#00E5FF` + +**Purpose:** Serious player. Large-scale builds and moderate automation systems. Advanced territorial control. + +--- + +### Tier 5: Legend ($20.00/month) +**Status:** Fire OR Frost +**Server Access:** All 13+ Minecraft servers + +**In-Game Perks:** +- **35 homes** - Elite mobility across entire network +- **121 claimed chunks** - Massive protected territory +- **16 force-loaded chunks** - Large automation networks run continuously +- **`/rtp` with 10 minute cooldown** - Near-constant exploration access + +**Chat Display:** + +**Fire Legend:** +``` +[🔥 Fire Legend] PlayerName: message here +``` +Color: `#FF3D00` + +**Frost Legend:** +``` +[❄️ Frost Legend] PlayerName: message here +``` +Color: `#00E5FF` + +**Purpose:** Elite player. Massive builds and complex automation systems. Maximum territorial control for single-path subscribers. + +--- + +### Tier 6: Sovereign (Founder's) ($499.00 Lifetime) +**Status:** **The Ascended** - Access to BOTH Fire + Frost +**Server Access:** All 13+ Minecraft servers (forever) + +**In-Game Perks:** +- **50 homes** - Ultimate mobility and organization +- **225 claimed chunks** - Enormous protected territory +- **81 force-loaded chunks** - Massive automation networks running 24/7 +- **`/rtp` with NO COOLDOWN** - Unlimited random teleport access + +**Chat Display:** +``` +[⚡ Founder] PlayerName: message here +``` +Color: `#FFD600` (Amber Gold - Fire Accent) + +**Discord Access:** +- ALL Fire Path exclusive channels +- ALL Frost Path exclusive channels +- Exclusive Founder-only channels (The Nexus) +- Permanent council voting rights + +**Purpose:** Lifetime commitment. The bridge between Fire and Frost. Elite status and recognition. Maximum perks across all dimensions. + +**The Ascended:** Founders embody the complete Firefrost philosophy - passion AND precision united. + +--- + +## Path Philosophy + +### 🔥 Path of Fire - The Flamecrafters +**Identity:** Keepers of the Flame +**Focus:** Community, creativity, social connection +**Inspired By:** Magic mods (Mystical Agriculture, Ars Nouveau, Botania) +**Chat Color:** `#FF3D00` (Deep Orange/Red) + +**Playstyle:** +- Aesthetic builds and artistic expression +- Collaborative community projects +- Social spaces and events +- Creative freedom and experimentation + +**Leader:** Meg "Gingerfury" (The Emissary) +**Discord:** Fire Path exclusive channels, community-focused + +--- + +### ❄️ Path of Frost - The Crystal Engineers +**Identity:** Guardians of the Foundation +**Focus:** Technical mastery, automation, systems +**Inspired By:** Tech mods (Create, Mekanism, industrial automation) +**Chat Color:** `#00E5FF` (Electric Cyan) + +**Playstyle:** +- Redstone contraptions and automation +- Efficient systems and optimization +- Technical excellence and precision +- Infrastructure and performance + +**Leader:** Michael "Frostystyle" (The Wizard) +**Discord:** Frost Path exclusive channels, technical-focused + +--- + +### ⚡ Sovereign (The Ascended) - Nexus Builders +**Identity:** The bridge between Fire and Frost +**Focus:** Mastery of both passion and precision +**Chat Color:** `#FFD600` (Amber Gold) + +**Access:** +- All Fire AND Frost exclusive Discord channels +- Exclusive Founder channels (The Nexus) +- Direct access to both The Wizard and The Emissary + +**Purpose:** Elite founders who embody the complete Firefrost philosophy. + +--- + +## Competitive Structure + +### Michael vs Meg: The Path Wars + +Both The Wizard (Michael) and The Emissary (Meg) recruit from the same pool of **Awakened** members ($1 tier). + +**The Competition:** +- Who can convert more Awakened → their Path at $5 Elemental tier? +- Fire vs Frost subscriber counts displayed in Discord category headers +- Monthly challenges and recognition for winning path +- Founders (Sovereign) can support both sides but choose allegiance per challenge + +**Fair Competition:** +- Both paths start from same $1 gateway (The Awakened) +- Identical mechanical perks at each tier (homes/chunks/force-load/rtp) +- Different community identity and Discord access creates genuine choice +- Neither path has mechanical advantage + +--- + +## Technical Implementation + +### Current Implementable Perks (Minecraft) + +**Via LuckPerms:** +- Permission group hierarchy (Awakened → Elemental → Knight → Master → Legend → Sovereign) +- Chat formatting and color codes +- Rank prefix display in game chat + +**Via FTB Chunks:** +- Claimed chunk limits per tier +- Force-loaded chunk limits per tier +- Territory protection + +**Via FTB Essentials:** +- Home set limits (`/sethome`, `/home`) +- Random teleport with cooldowns (`/rtp`) +- Basic quality-of-life commands + +### Payment Flow (Stripe) +1. User checks out via Paymenter/Ghost CMS +2. Stripe processes payment +3. Webhook triggers on successful payment +4. Discord bot receives webhook +5. Assigns appropriate role (Awakened, Fire Elemental, Frost Knight, etc.) +6. LuckPerms syncs Discord role → in-game permissions +7. User gains instant access + +### Multi-Server Sync Strategy +**Challenge:** 13+ Minecraft servers need identical rank configurations + +**Recommended Solution:** LuckPerms MySQL backend +- Single database for all servers +- All servers read permissions from same source +- Update once, applies everywhere instantly +- No manual config syncing required + +**Alternative:** Ansible/scripting to push configs via SSH + +--- + +## Future Expansion: Multi-Game Vision + +### Currently Supported Games +- ✅ **Minecraft** - 13+ servers (NC1 Charlotte, TX1 Dallas) +- 🔄 **Hytale** - 1 server (waiting for game release) +- 🔄 **FoundryVTT** - 1 instance (separate GM addon system) + +### Future Game Integration +Firefrost Gaming is building toward a **multi-game community platform** with unified subscriptions. + +**Potential Future Games:** +- Valheim servers +- Terraria servers +- ARK: Survival Ascended +- Palworld +- Other community-requested games + +**Framework:** The $1 Awakened gateway and tier system will extend to future games with game-appropriate perks. + +--- + +## FoundryVTT Integration (Separate System) + +**Note:** FoundryVTT access is handled separately from Fire/Frost paths. + +### Player Access +- **Awakened+ subscribers** can join GM-hosted campaigns as players +- Create characters, participate in games +- Standard player permissions + +### GM Time Add-On (Separate Purchase) +- **Independent from tier subscriptions** - any subscriber can purchase +- Grants ability to host and run campaigns +- Pricing TBD (e.g., $X/month = Y hours GM time) + +### Campaign Lifecycle Policy +**Active GM Subscription:** +- Campaign live and accessible to players + +**Grace Period (Subscription Lapses):** +- **14 days** - Campaign remains live +- Warning emails sent (Day 1, 7, 14) +- Encourages renewal before archiving + +**Archive Phase:** +- Campaign automatically archived after 14 days +- Secure download link generated +- Email sent to GM with download instructions + +**Download Window:** +- **30 days** - Secure download link remains active +- GM can retrieve campaign backup +- After 30 days, file permanently deleted from server + +**Reactivation:** +- GM renews subscription → can re-upload archived campaign + +### Discord Integration +Separate Discord category: **🎲 FOUNDRY REALMS** +- Not tied to Fire/Frost paths +- GM-only channels for GM addon subscribers +- Player discussion channels for all subscribers + +--- + +## Builder Terminology + +When discussing Minecraft builders in the community: + +- **🔥 Fire Path:** Flamecrafters (creative, magic-inspired builds) +- **❄️ Frost Path:** Crystal Engineers (technical, automation-focused) +- **⚡ Founders:** Nexus Builders (balanced mastery of both) + +--- + +## Chat Rank Display (Minecraft) + +### Color Specifications +All colors from Firefrost Design Bible v1.1: + +| Path | Color Code | Usage | +|------|------------|-------| +| **Fire Path** | `#FF3D00` | Deep Orange/Red - Fire Primary | +| **Frost Path** | `#00E5FF` | Electric Cyan - Frost Primary | +| **Founder** | `#FFD600` | Amber Gold - Fire Accent | +| **Awakened** | `#FFFFFF` | Pure White | + +### Implementation +- LuckPerms chat formatting +- FTB Ranks integration +- Prefix displays tier + path in chat +- Color codes applied per tier + +**Example Chat Appearance:** +``` +[The Awakened] NewPlayer: How do I claim chunks? +[🔥 Fire Elemental] Gingerfury: Use /fchunks claim! +[❄️ Frost Master] Frostystyle: Check the tutorial at spawn +[⚡ Founder] Holly: Welcome to Firefrost! +``` + +--- + +## Revenue Model + +### Monthly Recurring Revenue (MRR) Potential +- Elemental: $5/mo × subscribers +- Knight: $10/mo × subscribers +- Master: $15/mo × subscribers +- Legend: $20/mo × subscribers + +### One-Time Revenue +- The Awakened: $1 × new members (security gate, not profit center) +- Sovereign: $499 × lifetime founders + +**Primary Goal:** Sustainable infrastructure funding and community growth, NOT profit maximization. + +--- + +## Implementation Tasks + +### Immediate (Phase 0.5) +- [ ] LuckPerms MySQL backend setup +- [ ] FTB Chunks configuration per tier +- [ ] FTB Essentials home/rtp limits +- [ ] Chat formatting and color codes +- [ ] Discord role → LuckPerms sync + +### Future Phases +- [ ] Multi-server permission sync system +- [ ] FoundryVTT campaign archive automation +- [ ] Hytale integration (when game releases) +- [ ] Additional game platform integrations +- [ ] Cosmetic perk system (optional future enhancement) + +--- + +## Notes & Limitations + +### Current Implementation Scope +**What we CAN deliver now:** +- ✅ Home set limits +- ✅ Chunk claim limits +- ✅ Force-loaded chunk limits +- ✅ `/rtp` cooldowns +- ✅ Chat rank display with colors +- ✅ Discord role integration + +**What we CANNOT deliver yet:** +- ❌ Cosmetic perks (particle effects, custom skins, etc.) +- ❌ In-game auras or visual effects +- ❌ WorldEdit permissions (not applicable to most modpacks) +- ❌ Game mode changes or flight outside creative servers + +**Future Enhancement:** As infrastructure matures, cosmetic and quality-of-life perks may be added to differentiate Fire vs Frost paths beyond Discord access. + +--- + +## Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| **1.0** | 2026-02-08 | Michael & Meg | Initial tier structure finalized. Implementable perks only. Multi-game vision documented. | + +--- + +**END OF DOCUMENT**