From 41a35a4382d68fa7c8e0cbeaf6f607b8fbf06498 Mon Sep 17 00:00:00 2001 From: mkrause612 Date: Thu, 12 Feb 2026 00:59:50 -0600 Subject: [PATCH] Reorg: Move subscription tiers to docs/planning/ --- docs/planning/subscription-tiers.md | 515 ++++++++++++++++++++++++++++ 1 file changed, 515 insertions(+) create mode 100644 docs/planning/subscription-tiers.md diff --git a/docs/planning/subscription-tiers.md b/docs/planning/subscription-tiers.md new file mode 100644 index 0000000..abd010c --- /dev/null +++ b/docs/planning/subscription-tiers.md @@ -0,0 +1,515 @@ +# Firefrost Gaming: Subscription Tier Structure + +**Version:** 1.0 +**Created:** February 8, 2026 +**Status:** Final - Approved by Michael & Meg +**Payment Processor:** Stripe +**Primary Platform:** Minecraft (13+ servers) + +--- + +## The Foundation: Fire + Frost Philosophy + +Firefrost Gaming operates on a **dual-path subscription model** that reflects the balance of passion and precision: + +- **🔥 Path of Fire** - *The Way of the Flamecrafter* +- **❄️ Path of Frost** - *The Way of the Crystal Engineer* + +Both paths offer **identical mechanical perks** but different **community identity and Discord access**. + +--- + +## The $1.00 "Awakened" Gateway (The Handshake) + +### Purpose +The $1.00 one-time payment is **not a revenue stream** - it is a **security protocol**. + +**Core Philosophy:** +> *"If you want to be an asshole, you have to pay for it."* + +### What The Handshake Provides: +1. **🛡️ Bot & Troll Frostwall** - Financial friction stops 99% of automated spam and drive-by harassment +2. **📋 Traceability & Accountability** - Payment creates financial identity trail, enables permanent bans +3. **🧠 Psychological Investment** - Even $1 creates "citizen mindset" and community respect +4. **🎮 Server Whitelist** - Access to all 13+ Firefrost Minecraft servers +5. **⚙️ Technical Gateway** - Automated webhook → Discord role → whitelist sync + +### What It Does NOT Do: +- ❌ Age verification (handled separately with proper legal methods) +- ❌ Revenue generation (this is infrastructure protection) + +**Meg's Pitch (The Emissary):** +*"One dollar, one time, one family. The Handshake proves you're here to build with us, not break what we've made."* + +--- + +## Complete Tier Progression + +| Tier | Price | Server Access | Homes | Chunks | Force-Load | /rtp Cooldown | Path | +|------|-------|---------------|-------|--------|------------|---------------|------| +| **Wanderer** | Free | ❌ None | 0 | 0 | 0 | ❌ None | None | +| **Awakened** | $1 (once) | ✅ All servers | 1 | 0 | 0 | ❌ None | Pre-Path | +| **Elemental** | $5/mo | ✅ All servers | 5 | 25 | 0 | 60 min | **Fire OR Frost** | +| **Knight** | $10/mo | ✅ All servers | 10 | 49 | 4 | 30 min | Fire OR Frost | +| **Master** | $15/mo | ✅ All servers | 20 | 100 | 9 | 15 min | Fire OR Frost | +| **Legend** | $20/mo | ✅ All servers | 35 | 121 | 16 | 10 min | Fire OR Frost | +| **Sovereign** | $499 (life) | ✅ All servers | 50 | 225 | 81 | None | **BOTH** | + +--- + +## Tier Descriptions + +### Tier 0: Wanderer (Free) +**Status:** No subscription +**Access:** Discord public channels only +**Server Access:** None (not whitelisted) +**Purpose:** Browse community, see what Firefrost offers, decide if they want to join + +--- + +### Tier 1: The Awakened ($1.00 One-Time) +**Status:** Pre-Path (no Fire/Frost assignment yet) +**Server Access:** Whitelisted on all 13+ Minecraft servers +**Discord Access:** The Crossroads channels (can see Path channels, but locked until $5 Elemental) + +**In-Game Perks:** +- **1 home** - `/sethome` and `/home` commands +- **0 claimed chunks** - Cannot claim territory yet +- **0 force-loaded chunks** - No persistent chunk loading +- **No `/rtp` access** - Cannot random teleport + +**Chat Display:** +``` +[The Awakened] PlayerName: message here +``` +Color: `#FFFFFF` (White) + +**Purpose:** Entry to the family. Prove you're serious. Explore servers with minimal perks. Decide if you want to commit to a Path at $5. + +**The Handshake:** This payment unlocks permanent server whitelist and Discord community membership. + +--- + +### Tier 2: Elemental ($5.00/month) +**Status:** **CHOOSE YOUR PATH** - Fire OR Frost +**Server Access:** All 13+ Minecraft servers +**Discord Access:** Path-exclusive channels unlock + +**In-Game Perks:** +- **5 homes** - Multiple safe points across servers +- **25 claimed chunks** - Protected territory +- **0 force-loaded chunks** - Chunks unload when offline +- **`/rtp` with 60 minute cooldown** - Random teleport exploration + +**Discord Roles & Chat Display:** + +**Fire Elemental:** +``` +[🔥 Fire Elemental] Gingerfury: message here +``` +Color: `#FF3D00` (Deep Orange/Red - Fire Primary) + +**Frost Elemental:** +``` +[❄️ Frost Elemental] Frostystyle: message here +``` +Color: `#00E5FF` (Electric Cyan - Frost Primary) + +**Path Identity:** +- **Fire Path:** Access to Fire-exclusive Discord channels, Flamecrafter community +- **Frost Path:** Access to Frost-exclusive Discord channels, Crystal Engineer community + +**Purpose:** Commit to a path. Join either Meg's Fire community or Michael's Frost infrastructure. Begin building with territory protection. + +--- + +### Tier 3: Knight ($10.00/month) +**Status:** Fire OR Frost (chosen at Elemental) +**Server Access:** All 13+ Minecraft servers + +**In-Game Perks:** +- **10 homes** - Expanded mobility across network +- **49 claimed chunks** - Medium-sized protected base +- **4 force-loaded chunks** - Small automation stays active 24/7 +- **`/rtp` with 30 minute cooldown** - More frequent exploration + +**Chat Display:** + +**Fire Knight:** +``` +[🔥 Fire Knight] PlayerName: message here +``` +Color: `#FF3D00` + +**Frost Knight:** +``` +[❄️ Frost Knight] PlayerName: message here +``` +Color: `#00E5FF` + +**Purpose:** Deeper commitment. Automation begins with force-loaded chunks. Larger builds supported. + +--- + +### Tier 4: Master ($15.00/month) +**Status:** Fire OR Frost +**Server Access:** All 13+ Minecraft servers + +**In-Game Perks:** +- **20 homes** - Maximum mobility and organization +- **100 claimed chunks** - Large-scale protected territory +- **9 force-loaded chunks** - Medium automation networks +- **`/rtp` with 15 minute cooldown** - Regular exploration capability + +**Chat Display:** + +**Fire Master:** +``` +[🔥 Fire Master] PlayerName: message here +``` +Color: `#FF3D00` + +**Frost Master:** +``` +[❄️ Frost Master] PlayerName: message here +``` +Color: `#00E5FF` + +**Purpose:** Serious player. Large-scale builds and moderate automation systems. Advanced territorial control. + +--- + +### Tier 5: Legend ($20.00/month) +**Status:** Fire OR Frost +**Server Access:** All 13+ Minecraft servers + +**In-Game Perks:** +- **35 homes** - Elite mobility across entire network +- **121 claimed chunks** - Massive protected territory +- **16 force-loaded chunks** - Large automation networks run continuously +- **`/rtp` with 10 minute cooldown** - Near-constant exploration access + +**Chat Display:** + +**Fire Legend:** +``` +[🔥 Fire Legend] PlayerName: message here +``` +Color: `#FF3D00` + +**Frost Legend:** +``` +[❄️ Frost Legend] PlayerName: message here +``` +Color: `#00E5FF` + +**Purpose:** Elite player. Massive builds and complex automation systems. Maximum territorial control for single-path subscribers. + +--- + +### Tier 6: Sovereign (Founder's) ($499.00 Lifetime) +**Status:** **The Ascended** - Access to BOTH Fire + Frost +**Server Access:** All 13+ Minecraft servers (forever) + +**In-Game Perks:** +- **50 homes** - Ultimate mobility and organization +- **225 claimed chunks** - Enormous protected territory +- **81 force-loaded chunks** - Massive automation networks running 24/7 +- **`/rtp` with NO COOLDOWN** - Unlimited random teleport access + +**Chat Display:** +``` +[⚡ Founder] PlayerName: message here +``` +Color: `#FFD600` (Amber Gold - Fire Accent) + +**Discord Access:** +- ALL Fire Path exclusive channels +- ALL Frost Path exclusive channels +- Exclusive Founder-only channels (The Nexus) +- Permanent council voting rights + +**Purpose:** Lifetime commitment. The bridge between Fire and Frost. Elite status and recognition. Maximum perks across all dimensions. + +**The Ascended:** Founders embody the complete Firefrost philosophy - passion AND precision united. + +--- + +## Path Philosophy + +### 🔥 Path of Fire - The Flamecrafters +**Identity:** Keepers of the Flame +**Focus:** Community, creativity, social connection +**Inspired By:** Magic mods (Mystical Agriculture, Ars Nouveau, Botania) +**Chat Color:** `#FF3D00` (Deep Orange/Red) + +**Playstyle:** +- Aesthetic builds and artistic expression +- Collaborative community projects +- Social spaces and events +- Creative freedom and experimentation + +**Leader:** Meg "Gingerfury" (The Emissary) +**Discord:** Fire Path exclusive channels, community-focused + +--- + +### ❄️ Path of Frost - The Crystal Engineers +**Identity:** Guardians of the Foundation +**Focus:** Technical mastery, automation, systems +**Inspired By:** Tech mods (Create, Mekanism, industrial automation) +**Chat Color:** `#00E5FF` (Electric Cyan) + +**Playstyle:** +- Redstone contraptions and automation +- Efficient systems and optimization +- Technical excellence and precision +- Infrastructure and performance + +**Leader:** Michael "Frostystyle" (The Wizard) +**Discord:** Frost Path exclusive channels, technical-focused + +--- + +### ⚡ Sovereign (The Ascended) - Nexus Builders +**Identity:** The bridge between Fire and Frost +**Focus:** Mastery of both passion and precision +**Chat Color:** `#FFD600` (Amber Gold) + +**Access:** +- All Fire AND Frost exclusive Discord channels +- Exclusive Founder channels (The Nexus) +- Direct access to both The Wizard and The Emissary + +**Purpose:** Elite founders who embody the complete Firefrost philosophy. + +--- + +## Competitive Structure + +### Michael vs Meg: The Path Wars + +Both The Wizard (Michael) and The Emissary (Meg) recruit from the same pool of **Awakened** members ($1 tier). + +**The Competition:** +- Who can convert more Awakened → their Path at $5 Elemental tier? +- Fire vs Frost subscriber counts displayed in Discord category headers +- Monthly challenges and recognition for winning path +- Founders (Sovereign) can support both sides but choose allegiance per challenge + +**Fair Competition:** +- Both paths start from same $1 gateway (The Awakened) +- Identical mechanical perks at each tier (homes/chunks/force-load/rtp) +- Different community identity and Discord access creates genuine choice +- Neither path has mechanical advantage + +--- + +## Technical Implementation + +### Current Implementable Perks (Minecraft) + +**Via LuckPerms:** +- Permission group hierarchy (Awakened → Elemental → Knight → Master → Legend → Sovereign) +- Chat formatting and color codes +- Rank prefix display in game chat + +**Via FTB Chunks:** +- Claimed chunk limits per tier +- Force-loaded chunk limits per tier +- Territory protection + +**Via FTB Essentials:** +- Home set limits (`/sethome`, `/home`) +- Random teleport with cooldowns (`/rtp`) +- Basic quality-of-life commands + +### Payment Flow (Stripe) +1. User checks out via Paymenter/Ghost CMS +2. Stripe processes payment +3. Webhook triggers on successful payment +4. Discord bot receives webhook +5. Assigns appropriate role (Awakened, Fire Elemental, Frost Knight, etc.) +6. LuckPerms syncs Discord role → in-game permissions +7. User gains instant access + +### Multi-Server Sync Strategy +**Challenge:** 13+ Minecraft servers need identical rank configurations + +**Recommended Solution:** LuckPerms MySQL backend +- Single database for all servers +- All servers read permissions from same source +- Update once, applies everywhere instantly +- No manual config syncing required + +**Alternative:** Ansible/scripting to push configs via SSH + +--- + +## Future Expansion: Multi-Game Vision + +### Currently Supported Games +- ✅ **Minecraft** - 13+ servers (NC1 Charlotte, TX1 Dallas) +- 🔄 **Hytale** - 1 server (waiting for game release) +- 🔄 **FoundryVTT** - 1 instance (separate GM addon system) + +### Future Game Integration +Firefrost Gaming is building toward a **multi-game community platform** with unified subscriptions. + +**Potential Future Games:** +- Valheim servers +- Terraria servers +- ARK: Survival Ascended +- Palworld +- Other community-requested games + +**Framework:** The $1 Awakened gateway and tier system will extend to future games with game-appropriate perks. + +--- + +## FoundryVTT Integration (Separate System) + +**Note:** FoundryVTT access is handled separately from Fire/Frost paths. + +### Player Access +- **Awakened+ subscribers** can join GM-hosted campaigns as players +- Create characters, participate in games +- Standard player permissions + +### GM Time Add-On (Separate Purchase) +- **Independent from tier subscriptions** - any subscriber can purchase +- Grants ability to host and run campaigns +- Pricing TBD (e.g., $X/month = Y hours GM time) + +### Campaign Lifecycle Policy +**Active GM Subscription:** +- Campaign live and accessible to players + +**Grace Period (Subscription Lapses):** +- **14 days** - Campaign remains live +- Warning emails sent (Day 1, 7, 14) +- Encourages renewal before archiving + +**Archive Phase:** +- Campaign automatically archived after 14 days +- Secure download link generated +- Email sent to GM with download instructions + +**Download Window:** +- **30 days** - Secure download link remains active +- GM can retrieve campaign backup +- After 30 days, file permanently deleted from server + +**Reactivation:** +- GM renews subscription → can re-upload archived campaign + +### Discord Integration +Separate Discord category: **🎲 FOUNDRY REALMS** +- Not tied to Fire/Frost paths +- GM-only channels for GM addon subscribers +- Player discussion channels for all subscribers + +--- + +## Builder Terminology + +When discussing Minecraft builders in the community: + +- **🔥 Fire Path:** Flamecrafters (creative, magic-inspired builds) +- **❄️ Frost Path:** Crystal Engineers (technical, automation-focused) +- **⚡ Founders:** Nexus Builders (balanced mastery of both) + +--- + +## Chat Rank Display (Minecraft) + +### Color Specifications +All colors from Firefrost Design Bible v1.1: + +| Path | Color Code | Usage | +|------|------------|-------| +| **Fire Path** | `#FF3D00` | Deep Orange/Red - Fire Primary | +| **Frost Path** | `#00E5FF` | Electric Cyan - Frost Primary | +| **Founder** | `#FFD600` | Amber Gold - Fire Accent | +| **Awakened** | `#FFFFFF` | Pure White | + +### Implementation +- LuckPerms chat formatting +- FTB Ranks integration +- Prefix displays tier + path in chat +- Color codes applied per tier + +**Example Chat Appearance:** +``` +[The Awakened] NewPlayer: How do I claim chunks? +[🔥 Fire Elemental] Gingerfury: Use /fchunks claim! +[❄️ Frost Master] Frostystyle: Check the tutorial at spawn +[⚡ Founder] Holly: Welcome to Firefrost! +``` + +--- + +## Revenue Model + +### Monthly Recurring Revenue (MRR) Potential +- Elemental: $5/mo × subscribers +- Knight: $10/mo × subscribers +- Master: $15/mo × subscribers +- Legend: $20/mo × subscribers + +### One-Time Revenue +- The Awakened: $1 × new members (security gate, not profit center) +- Sovereign: $499 × lifetime founders + +**Primary Goal:** Sustainable infrastructure funding and community growth, NOT profit maximization. + +--- + +## Implementation Tasks + +### Immediate (Phase 0.5) +- [ ] LuckPerms MySQL backend setup +- [ ] FTB Chunks configuration per tier +- [ ] FTB Essentials home/rtp limits +- [ ] Chat formatting and color codes +- [ ] Discord role → LuckPerms sync + +### Future Phases +- [ ] Multi-server permission sync system +- [ ] FoundryVTT campaign archive automation +- [ ] Hytale integration (when game releases) +- [ ] Additional game platform integrations +- [ ] Cosmetic perk system (optional future enhancement) + +--- + +## Notes & Limitations + +### Current Implementation Scope +**What we CAN deliver now:** +- ✅ Home set limits +- ✅ Chunk claim limits +- ✅ Force-loaded chunk limits +- ✅ `/rtp` cooldowns +- ✅ Chat rank display with colors +- ✅ Discord role integration + +**What we CANNOT deliver yet:** +- ❌ Cosmetic perks (particle effects, custom skins, etc.) +- ❌ In-game auras or visual effects +- ❌ WorldEdit permissions (not applicable to most modpacks) +- ❌ Game mode changes or flight outside creative servers + +**Future Enhancement:** As infrastructure matures, cosmetic and quality-of-life perks may be added to differentiate Fire vs Frost paths beyond Discord access. + +--- + +## Revision History + +| Version | Date | Author | Changes | +|---------|------|--------|---------| +| **1.0** | 2026-02-08 | Michael & Meg | Initial tier structure finalized. Implementable perks only. Multi-game vision documented. | + +--- + +**END OF DOCUMENT**