diff --git a/docs/subscription-tiers-final.md b/docs/subscription-tiers-final.md deleted file mode 100644 index abd010c..0000000 --- a/docs/subscription-tiers-final.md +++ /dev/null @@ -1,515 +0,0 @@ -# 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**