Add Phase 0.5 Planning: Subscription Tiers, Discord Structure, and Multi-Game Vision

- subscription-tiers-final.md: Complete tier structure (-99) with Fire/Frost paths
- discord-structure-complete.md: Full channel/role architecture (approved by Meg)
- path-philosophy.md: Fire vs Frost marketing content for Ghost CMS
- luckperms-structure.md: Permission hierarchy for 13+ server network
- awakened-gateway.md:  Handshake security protocol documentation

Establishes foundation for competitive Fire (Gingerfury) vs Frost (Frostystyle) community model.
This commit is contained in:
2026-02-08 13:30:41 -06:00
parent 282011da4b
commit 881b2c216f
5 changed files with 2537 additions and 0 deletions

556
docs/awakened-gateway.md Normal file
View File

@@ -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**

View File

@@ -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**

704
docs/luckperms-structure.md Normal file
View File

@@ -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: "&#00E5FF[❄️ Frost Elemental] " # Electric Cyan
# fire_knight
meta:
prefix: "&#FF3D00[🔥 Fire Knight] "
# frost_knight
meta:
prefix: "&#00E5FF[❄️ Frost Knight] "
# fire_master
meta:
prefix: "&#FF3D00[🔥 Fire Master] "
# frost_master
meta:
prefix: "&#00E5FF[❄️ Frost Master] "
# fire_legend
meta:
prefix: "&#FF3D00[🔥 Fire Legend] "
# frost_legend
meta:
prefix: "&#00E5FF[❄️ 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 <name> 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**

349
docs/path-philosophy.md Normal file
View File

@@ -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**

View File

@@ -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**