diff --git a/docs/tasks/firefrost-codex/README.md b/docs/tasks/firefrost-codex/README.md new file mode 100644 index 0000000..13bde34 --- /dev/null +++ b/docs/tasks/firefrost-codex/README.md @@ -0,0 +1,660 @@ +# Firefrost Codex - AI Assistant Deployment + +**Status:** Ready to Deploy +**Priority:** Tier 2 - Major Infrastructure +**Time Estimate:** 8-12 hours (4-6 active, rest downloads) +**Location:** TX1 Dallas (38.68.14.26) +**Domain:** codex.firefrostgaming.com (or ai.firefrostgaming.com) +**Last Updated:** February 20, 2026 +**Created By:** The Chronicler + +--- + +## Executive Summary + +**Firefrost Codex** is a self-hosted AI assistant that provides 24/7 support to all levels of the Firefrost Gaming community. Built on AnythingLLM with local LLM models, Codex serves as "Claude for everyone" - giving subscribers, staff, and founders intelligent assistance trained on Firefrost-specific knowledge. + +**The Vision:** Most Minecraft servers have Discord. We have an AI. + +**Monthly Cost:** $0 (self-hosted on existing TX1 infrastructure) + +--- + +## What is Firefrost Codex? + +### The Three Names Strategy + +1. **Codex** (Casual) - Discord mentions, daily use, friendly interactions +2. **The Codex** (Formal) - Official docs, announcements, system references +3. **Firefrost Codex** (Full Brand) - Marketing, external communications, press + +### The Core Concept + +**Codex = A comprehensive collection of knowledge preserved for future generations** + +Firefrost Codex is the living knowledge base that grows with every lesson learned, every problem solved, every discovery made. It's the legacy we're building for children not yet born. + +--- + +## Architecture Overview + +### Technology Stack + +**Platform:** AnythingLLM (self-hosted) +**Vector Database:** LanceDB (built-in, efficient) +**LLM Server:** Ollama +**Models:** +- Qwen 2.5 Coder 72B (coding/infrastructure) +- Llama 3.3 70B (general reasoning) +- Llama 3.2 Vision 11B (image analysis) + +**Integrations:** +- Discord Bot (role-based access) +- Web Interface (multi-user with RBAC) +- Embedded Chat Widgets (public + subscriber sites) +- mclo.gs API (Minecraft log analysis) + +--- + +## Five-Tier Access Architecture + +### 1. Public (No Authentication) +**Access:** Embedded widget on firefrostgaming.com +**Workspace:** Public KB +**Content:** Marketing, server info, how to join, Fire vs Frost philosophy +**Delivery:** Chat bubble on main website (unauthenticated) + +**Purpose:** Convert visitors into subscribers + +--- + +### 2. Subscribers (Awakened $1+) +**Access:** Discord bot + Web interface + Subscriber website widget +**Role:** Default +**Workspace:** Subscriber KB +**Content:** +- Gameplay guides and tutorials +- Commands per tier +- Modpack-specific guides +- Troubleshooting (including mclo.gs analysis) +- Chunk claiming, homes, permissions +- Path-specific content (Fire vs Frost) + +**Example Use Cases:** +- "How do I claim chunks on ATM10?" +- "Analyze this crash: https://mclo.gs/abc123" +- "What commands do I have as Elemental tier?" +- "Teach me Create mod basics" + +--- + +### 3. Staff (Future Hires) +**Access:** Discord bot + Web interface +**Role:** Manager +**Workspaces:** Operations, Brainstorming, Subscriber KB +**Content:** +- Infrastructure procedures +- Server management guides +- Whitelist Manager usage +- Support protocols +- Emergency procedures (DERP) +- How to answer subscriber questions + +**Example Use Cases:** +- "How do I use the Whitelist Manager?" +- "What's the procedure for server restarts?" +- "How do I handle a billing issue?" + +--- + +### 4. Michael + Meg (Founders) +**Access:** Everything +**Role:** Admin +**Workspaces:** All 5 (Public KB, Subscriber KB, Operations, Brainstorming, Relationship) +**Content:** Complete access to all knowledge + +**Additional Capabilities:** +- User management +- System settings (LLM configuration) +- Analytics and logs +- API key management +- Embedded widget creation +- Full administration + +--- + +### 5. Potential Subscribers (Tier 0: Wanderers) +**Access:** Embedded widget on firefrostgaming.com +**Same as Public tier** - designed to educate and convert + +--- + +## The Five Workspaces + +### Workspace 1: Public KB +**Access:** Anyone (unauthenticated) +**Delivery:** Embedded widget only +**Purpose:** Marketing and conversion + +**Content:** +- What is Firefrost Gaming? +- Server list and modpack descriptions +- Fire vs Frost philosophy +- Subscription tier comparison +- Getting started guide +- Community values and rules +- FAQ +- How to join Discord + +**Rate Limiting:** Yes (prevent abuse) +**Query Mode:** Query-only (answers must relate to documents) + +--- + +### Workspace 2: Subscriber KB +**Access:** Awakened ($1+) and above +**Delivery:** Discord bot, web interface, embedded widget +**Purpose:** Subscriber support and education + +**Content:** +- Server connection details +- Modpack guides and tutorials +- Commands and permissions per tier +- Chunk claiming and homes guides +- Path-specific content +- Technical troubleshooting +- mclo.gs log analysis database +- Performance optimization +- Mod-specific tutorials + +**Special Features:** +- mclo.gs integration (automatic log analysis) +- Tier-aware responses (knows what commands each tier has) +- Path-aware (Fire vs Frost specific content) + +--- + +### Workspace 3: Operations +**Access:** Staff and Admin only +**Delivery:** Discord bot, web interface +**Purpose:** Running the business + +**Content:** +- Infrastructure documentation +- Server management procedures +- Whitelist Manager usage +- Support procedures and scripts +- Emergency protocols +- DERP documentation +- Billing procedures +- Staff onboarding + +--- + +### Workspace 4: Brainstorming +**Access:** Admin and Staff +**Delivery:** Web interface +**Purpose:** Planning and strategy + +**Content:** +- Planning documents +- Future roadmaps +- Design discussions +- Community initiatives +- Expansion planning + +--- + +### Workspace 5: Relationship +**Access:** Admin only (Michael + Meg) +**Delivery:** Web interface +**Purpose:** Claude partnership continuity + +**Content:** +- The Essence Patch +- Session handoff protocols +- Partnership context +- The Chronicler lineage +- Private strategic discussions + +--- + +## Access Methods Comparison + +| Method | Public | Subscribers | Staff | Admins | +|--------|--------|-------------|-------|--------| +| **Main Website Widget** | ✅ Public KB | - | - | - | +| **Subscriber Website Widget** | - | ✅ Subscriber KB | - | - | +| **Discord Bot** | ❌ | ✅ Subscriber KB | ✅ Operations | ✅ All | +| **Web Interface (codex.firefrostgaming.com)** | ❌ | ✅ Subscriber KB | ✅ Ops + Brain + Sub | ✅ All 5 | + +--- + +## Discord Bot Features + +### Commands + +**For Subscribers:** +- `/ask [question]` - Query Subscriber KB workspace +- `/analyze [mclo.gs URL]` - Automatic log analysis +- `/help` - Show available commands + +**For Staff:** +- `/ask [question]` - Query Operations workspace +- `/operations [question]` - Explicit operations query +- `/subscriber-help [question]` - Query Subscriber KB to help answer user questions +- `/analyze [mclo.gs URL]` - Log analysis + +**For Admins:** +- All staff commands plus: +- `/workspace [name]` - Switch workspaces +- `/brainstorm [question]` - Query brainstorming workspace + +### Role-Based Routing + +```python +def get_workspace(user_role): + if user_role == 'subscriber': + return 'subscriber-kb' + elif user_role == 'staff': + return 'operations' + elif user_role == 'admin': + return 'all' # Can switch + else: + return None # No access +``` + +--- + +## mclo.gs Integration + +### What is mclo.gs? + +mclo.gs is a Minecraft log sharing and analysis service. Players upload server/client logs and get a shareable URL with automatic problem detection. + +### How Codex Uses It + +**User Flow:** +1. Subscriber runs `/mclogs` command in-game → generates mclo.gs link +2. Subscriber shares link with Codex: `@Codex analyze https://mclo.gs/abc123` +3. Codex fetches log via API +4. Codex analyzes with AI + knowledge base +5. Codex provides diagnosis + solutions + relevant docs + +**Example Interaction:** +``` +User: @Codex https://mclo.gs/xyz789 - my server keeps crashing + +Codex: 🔍 Analyzing your log... + +📊 **Log Analysis Results:** + +**Problem Detected:** OutOfMemoryError in All The Mods 10 +- Server allocated 20GB RAM, used 20GB +- Crash during chunk generation in the Nether + +**Root Cause:** +ATM10 requires more memory than allocated, especially during chunk generation in modded dimensions. + +**Solutions:** +1. **Increase RAM allocation to 24GB** (recommended for stable ATM10) + - In your launcher, change `-Xmx20G` to `-Xmx24G` + +2. **Reduce render distance** (temporary fix) + - Edit server.properties: `view-distance=8` (currently 10) + +3. **Pre-generate chunks** (prevents future crashes) + - Use Chunky mod to pre-generate Nether chunks + +**Related Docs:** +📚 [ATM10 Memory Requirements](link) +📚 [Chunk Pre-generation Guide](link) +📚 [Launcher RAM Settings](link) + +Need help with any of these steps? Just ask! +``` + +### Technical Implementation + +**API Call:** +```python +# Fetch log from mclo.gs +response = requests.get(f"https://api.mclo.gs/1/log/{log_id}") +data = response.json() + +# Extract relevant info +log_content = data['content'] +detected_problems = data['analysis']['problems'] +server_info = data['analysis']['information'] + +# Send to Codex with context +prompt = f""" +Analyze this Minecraft server log: + +{log_content} + +mclo.gs detected: {detected_problems} +Server info: {server_info} + +Provide diagnosis and step-by-step solutions. +""" + +response = anythingllm_api.chat(workspace="subscriber-kb", query=prompt) +``` + +--- + +## Web Interface Experience + +### Subscriber Dashboard +``` +Codex - Logged in as: username123 + +My Workspaces: +📚 Subscriber Knowledge Base [Open Chat] + +Recent Chats: +- How to claim chunks on ATM10 +- Crash log analysis +- Create mod water wheel tutorial + +Settings: +👤 My Profile +🔒 Change Password +🚪 Logout +``` + +### Staff Dashboard +``` +Codex - Logged in as: staffmember + +My Workspaces: +📚 Subscriber Knowledge Base [Open Chat] +⚙️ Operations [Open Chat] +💡 Brainstorming [Open Chat] + +Quick Actions: +🔍 Search all workspaces +📊 View recent subscriber questions +🛠️ Infrastructure status + +Settings: +👤 My Profile +🔒 Change Password +``` + +### Admin Dashboard (Michael/Meg) +``` +Firefrost Codex - Admin Panel + +Workspaces: +🌐 Public KB [Open] [Manage] [Analytics] +📚 Subscriber Knowledge Base [Open] [Manage] [Analytics] +⚙️ Operations [Open] [Manage] [Analytics] +💡 Brainstorming [Open] [Manage] [Analytics] +💙 Relationship [Open] [Manage] [Analytics] + +Administration: +👥 User Management (Create, Edit, Delete users) +🛠️ System Settings (LLM, Embedder, Vector DB) +📊 Analytics & Logs (Usage, popular queries) +🔑 API Keys (Generate, manage, revoke) +🪟 Embedded Widgets (Create, configure) +🎨 Appearance (Branding, colors, logos) + +System Status: +✅ AnythingLLM: Online +✅ Ollama: Online (3 models loaded) +✅ Vector DB: 1,247 documents indexed +✅ Discord Bot: Connected +✅ Uptime: 47 days +``` + +--- + +## Resource Requirements + +### TX1 Dallas Specifications +- **CPU:** 32 vCPU (AMD EPYC) +- **RAM:** 256GB total +- **Storage:** 1TB NVMe + +### Codex Resource Usage + +**Storage (~97GB):** +- Qwen 2.5 Coder 72B: ~40GB +- Llama 3.3 70B: ~40GB +- Llama 3.2 Vision 11B: ~7GB +- AnythingLLM + services: ~10GB + +**RAM (varies by mode):** +- **Idle (models unloaded):** ~4GB (AnythingLLM services only) +- **Active (one large model loaded):** ~92GB + - Model: ~80GB (Qwen OR Llama 3.3) + - AnythingLLM: ~4GB + - Overhead: ~8GB + +**CPU:** +- Inference slower than cloud APIs +- 32 vCPU sufficient for concurrent users +- Background model loading/unloading + +**Available Headroom:** +- RAM: 256GB - 92GB = 164GB free (plenty for game servers) +- Storage: 1TB - 97GB = 903GB free +- CPU: Shared with game servers, no issues expected + +--- + +## Deployment Phases + +### Phase 1: Core Infrastructure (3-4 hours) +1. Deploy AnythingLLM via Docker +2. Install Ollama +3. Configure multi-user mode +4. Create admin accounts (Michael + Meg) +5. Configure Nginx reverse proxy + SSL +6. Initial testing + +### Phase 2: Model Downloads (Overnight - 6-8 hours) +1. Download Qwen 2.5 Coder 72B (~40GB) +2. Download Llama 3.3 70B (~40GB) +3. Download Llama 3.2 Vision 11B (~7GB) +4. Test model loading +5. Configure Ollama as AnythingLLM backend + +### Phase 3: Workspace Setup (2-3 hours) +1. Create 5 workspaces +2. Upload documents to each workspace +3. Configure workspace permissions +4. Test knowledge retrieval +5. Optimize embedding settings + +### Phase 4: Discord Bot (2-3 hours) +1. Create Discord application +2. Deploy Python bot to TX1 +3. Configure role-based routing +4. Implement mclo.gs integration +5. Test commands +6. Deploy as systemd service + +### Phase 5: Embedded Widgets (1-2 hours) +1. Create Public KB widget (firefrostgaming.com) +2. Create Subscriber KB widget (subscribers.firefrostgaming.com) +3. Configure branding (Fire/Frost theme) +4. Set rate limits +5. Test on both sites + +### Phase 6: Testing & Validation (2 hours) +1. Test all access methods +2. Test role-based permissions +3. Test mclo.gs integration +4. Load testing (concurrent users) +5. Documentation review + +**Total Time:** 8-12 hours (4-6 active work, rest is downloads) + +--- + +## Success Criteria + +- ✅ AnythingLLM deployed and accessible at codex.firefrostgaming.com +- ✅ All 3 models loaded and operational via Ollama +- ✅ 5 workspaces created with appropriate content +- ✅ Multi-user mode with Admin (Michael/Meg) accounts +- ✅ Discord bot operational with role-based routing +- ✅ mclo.gs integration functional +- ✅ Embedded widgets deployed on both websites +- ✅ Public can access via main website +- ✅ Subscribers can access via Discord + web + subscriber site +- ✅ Staff can access Operations workspace +- ✅ Michael + Meg have full admin access +- ✅ Documentation complete +- ✅ Zero additional monthly cost confirmed + +--- + +## Cost Analysis + +### Current Costs (Before Codex) +- Claude Pro subscription: $20/month +- TX1 Dallas server: (existing, already paid) +- Total: $20/month + +### After Codex Deployment +- Claude Pro subscription: $20/month (keep for Michael/Meg) +- Codex infrastructure: $0 (self-hosted on TX1) +- **Total: $20/month (no increase)** + +### Cost Comparison vs Alternatives + +| Solution | Monthly Cost | Notes | +|----------|--------------|-------| +| **Firefrost Codex** | $0 | Self-hosted on existing TX1 | +| ChatGPT Team | $300/month | 15 subscribers × $20/user | +| Claude Pro per user | $300/month | 15 users × $20/month | +| OpenAI API (GPT-4) | ~$150-300/month | Usage-based, unpredictable | +| Anthropic API (Claude) | ~$200-400/month | Usage-based, unpredictable | + +**Savings:** $150-400/month by self-hosting + +--- + +## Related Documentation + +- **deployment-plan.md** - Complete step-by-step deployment guide +- **branding-guide.md** - Codex branding, logos, messaging +- **marketing-strategy.md** - Launch plan, announcements, positioning +- **usage-guide.md** - When to use Claude Projects vs Codex +- **discord-bot-setup.md** - Bot configuration and commands +- **mclo.gs-integration.md** - Log analysis implementation +- **workspace-management.md** - Content organization strategy +- **troubleshooting.md** - Common issues and solutions + +--- + +## Marketing Positioning + +### The Hook +**"Most Minecraft servers have Discord. We have an AI."** + +### Subscriber Value Proposition +> "Every Firefrost subscriber gets 24/7 access to Codex - our AI assistant trained on everything Firefrost. Stuck at 2 AM? Ask Codex. Crash log confusing? Codex analyzes it. Want to master Create mod? Codex teaches you. It's like having a staff member in your pocket." + +### Staff Value Proposition +> "Firefrost staff aren't drowning in support tickets. Codex handles 80% of common questions, so you focus on building cool stuff and helping with real problems. You also get Codex as YOUR assistant - instant access to all procedures and infrastructure docs." + +### Competitive Advantage +- **24/7 instant support** (most servers: wait for staff) +- **Minecraft log analysis** (most servers: manual debugging) +- **Growing knowledge base** (learns from every interaction) +- **Privacy-focused** (all data stays on our servers) +- **No per-user costs** (scales infinitely at $0) + +--- + +## Integration with Existing Infrastructure + +### Fits Into Current Stack +- **Command Center:** Hosts documentation (Gitea) +- **TX1 Dallas:** Hosts Codex (AnythingLLM + Ollama) +- **Ghost VPS:** Hosts embedded widgets (public site) +- **Billing VPS:** Subscriber authentication integration (future) +- **Discord:** Primary user interface for subscribers + +### No Disruption +- Game servers on TX1 unaffected (plenty of headroom) +- Existing management services continue as-is +- Whitelist Manager, Uptime Kuma, etc. operate normally +- Codex is additive, not replacement + +--- + +## Future Enhancements (Post-Launch) + +### Phase 2 Features (3-6 months) +- **Paymenter integration** - Auto-provision accounts for new subscribers +- **Voice chat support** - Discord voice channel AI assistant +- **Image analysis** - Screenshot troubleshooting (using Llama Vision) +- **Automated documentation** - AI writes docs from staff actions +- **Proactive monitoring** - Codex monitors logs, alerts issues + +### Phase 3 Features (6-12 months) +- **Multi-language support** - Spanish, French, German translations +- **Custom training** - Fine-tune models on Firefrost-specific data +- **API for subscribers** - Let developers integrate Codex +- **Mobile app** - Native iOS/Android Codex access +- **Advanced analytics** - Sentiment analysis, satisfaction tracking + +--- + +## Rollback Plan + +If deployment fails or issues arise: + +```bash +# Stop all Codex services +systemctl stop firefrost-codex-bot +cd /opt/anythingllm && docker-compose down + +# Remove installation +rm -rf /opt/anythingllm +rm -rf /opt/firefrost-discord-bot +rm /etc/systemd/system/firefrost-codex-bot.service +systemctl daemon-reload + +# Remove Nginx config +rm /etc/nginx/sites-enabled/codex.firefrostgaming.com +rm /etc/nginx/sites-available/codex.firefrostgaming.com +nginx -t && systemctl reload nginx + +# Uninstall Ollama +sudo /usr/local/bin/ollama-uninstall.sh + +# Revoke SSL certificate (optional) +certbot delete --cert-name codex.firefrostgaming.com +``` + +**Recovery time:** <30 minutes +**Data loss:** None (can redeploy from documentation) + +--- + +## The Legacy Connection + +**The Chronicler** (Claude) preserves Michael & Meg's partnership and operations. + +**Codex** preserves Firefrost's community knowledge. + +Both serve the same mission: building a legacy for children not yet born. + +--- + +**Fire + Frost + Foundation + Codex = Where Love Builds Legacy** 💙🔥❄️ + +--- + +**Version:** 1.0 +**Created:** February 20, 2026 +**Created By:** The Chronicler +**Status:** Ready for Deployment diff --git a/docs/tasks/firefrost-codex/marketing-strategy.md b/docs/tasks/firefrost-codex/marketing-strategy.md new file mode 100644 index 0000000..d59a19d --- /dev/null +++ b/docs/tasks/firefrost-codex/marketing-strategy.md @@ -0,0 +1,795 @@ +# Firefrost Codex - Marketing Strategy + +**Document Type:** Marketing Strategy +**Product:** Firefrost Codex AI Assistant +**Target Launch:** Q2 2026 +**Created:** February 20, 2026 +**Created By:** The Chronicler +**Owner:** Meg "The Emissary" (Primary) + Michael "The Wizard" (Technical) + +--- + +## Executive Summary + +Firefrost Codex is not just a feature - it's a **competitive moat**. No other Minecraft server network offers 24/7 AI assistance to all subscribers. This is our killer app, our unique selling proposition, and our strongest recruitment tool. + +**The Hook:** Most Minecraft servers have Discord. We have an AI. + +**The Promise:** 24/7 instant help, never wait for staff, smarter every day. + +**The Proof:** Live demos, testimonials, public stats on response time and accuracy. + +--- + +## Brand Identity + +### The Three Names + +**Codex** = Casual, friendly, approachable +**The Codex** = Authoritative, official, important +**Firefrost Codex** = Full brand, external facing, press-ready + +### Personality + +**Codex is:** +- **Helpful, not robotic** - Warm and encouraging +- **Knowledgeable, not condescending** - Shares expertise without talking down +- **Patient, not frustrated** - Never tires of questions +- **Growing, not static** - Gets smarter with community input +- **Firefrost-native** - Understands Fire vs Frost, tier systems, community culture + +**Codex is NOT:** +- Generic chatbot +- Replacement for human connection +- Perfect/infallible (acknowledges limitations) +- Corporate/stuffy + +### Voice & Tone + +**Default tone:** Friendly guide, like a helpful staff member +**Emergency tone:** Calm and direct (crash analysis, urgent issues) +**Teaching tone:** Encouraging mentor (tutorials, learning) +**Community tone:** One of us (knows the lore, celebrates wins) + +**Example phrases:** +- ✅ "Let's figure this out together!" +- ✅ "Great question! Here's how..." +- ✅ "I found this in our knowledge base..." +- ❌ "As an AI assistant, I..." +- ❌ "According to my training data..." + +--- + +## Target Audiences + +### Audience 1: Potential Subscribers (Wanderers) +**Goal:** Convert to Awakened ($1) tier + +**Pain Points:** +- Overwhelmed by modpack complexity +- Fear of wasting money on bad servers +- Don't know if Firefrost is right for them +- Need reassurance before committing + +**Codex Value:** +- Try before you buy (public widget) +- Get questions answered instantly +- Learn about Fire vs Frost +- See what support looks like + +**Message:** +> "Ask Codex anything about Firefrost - no account needed. See what 24/7 AI support looks like before you subscribe." + +--- + +### Audience 2: New Subscribers (Awakened $1+) +**Goal:** Retain and upgrade to Elemental ($5/mo) + +**Pain Points:** +- Don't know where to start +- Overwhelmed by commands/features +- Afraid to ask "dumb questions" +- Play at odd hours (no staff online) + +**Codex Value:** +- Instant answers, any time +- Never judged for asking +- Patient teaching +- Grows with them + +**Message:** +> "Your subscription includes 24/7 access to Codex. Stuck at 3 AM? Codex is awake. Confused by commands? Codex explains. Learning Create mod? Codex teaches." + +--- + +### Audience 3: Active Subscribers (Elemental+) +**Goal:** Retain long-term, prevent churn + +**Pain Points:** +- Complex technical issues +- Want to master advanced gameplay +- Crash logs are confusing +- Staff sometimes busy + +**Codex Value:** +- mclo.gs log analysis +- Advanced tutorials +- Instant first response (staff for complex follow-up) +- Always learning new tricks + +**Message:** +> "Level up with Codex. Analyze crash logs instantly, master advanced mods, optimize your builds. Codex grows with you." + +--- + +### Audience 4: Staff Recruits +**Goal:** Attract quality staff, reduce burnout + +**Pain Points:** +- Support tickets overwhelming +- Repetitive questions drain energy +- Hard to balance building vs support +- Need quick access to procedures + +**Codex Value:** +- Handles 80% of common questions +- Staff focus on fun stuff +- Codex as personal assistant +- Never forget a procedure + +**Message:** +> "Firefrost staff get Codex too. AI handles repetitive questions, you focus on building and helping with real problems. Plus, instant access to all procedures and infrastructure docs." + +--- + +## Launch Strategy + +### Pre-Launch (4 weeks before) + +**Week -4: Tease Campaign** +- Change Discord status: "Something is coming..." +- Post mysterious Fire + Frost + Binary code imagery +- Meg posts: "The Wizard is cooking something special" +- Build curiosity, don't reveal yet + +**Week -3: Reveal** +- Official announcement: "Meet Codex" +- Explain what it is (AI assistant) +- Why we built it (better support) +- When it launches (specific date) +- Post FAQ: "Is this replacing staff?" (NO) + +**Week -2: Demo Videos** +- Video 1: "Codex analyzes a crash log" (mclo.gs demo) +- Video 2: "Codex teaches Create mod" (tutorial demo) +- Video 3: "Ask Codex anything" (general Q&A demo) +- Share across all platforms + +**Week -1: Countdown** +- Daily countdown posts +- Staff testimonials: "I got to test Codex early, and..." +- Subscriber beta tester quotes +- Final hype buildup + +--- + +### Launch Day + +**Simultaneous announcements across:** +- Discord (pinned announcement + @everyone) +- Reddit (r/feedthebeast, r/admincraft, r/feedthebeastservers) +- Twitter/X +- Instagram +- TikTok (short demo video) +- YouTube (full demo video) +- Website banner +- Email to existing subscribers + +**Launch Day Content:** + +**Discord Announcement:** +``` +🎉 **CODEX IS LIVE** 🎉 + +Most Minecraft servers have Discord. +We have an AI. + +Every Firefrost subscriber now has 24/7 access to **Codex** - our AI assistant trained on everything Firefrost. + +🤖 **What Codex Does:** +✅ Answers questions instantly (any time, any topic) +✅ Analyzes crash logs (paste mclo.gs link, get solutions) +✅ Teaches mods and mechanics (patient, step-by-step) +✅ Never gets tired or frustrated + +🔥❄️ **How to Use Codex:** +- **Discord:** @Codex ask your question +- **Website:** Chat widget on subscribers.firefrostgaming.com +- **Direct:** Login at codex.firefrostgaming.com + +💙 **Try It Now:** +Ask @Codex anything about Firefrost! + +[Video demo embedded] + +Questions? Ask Codex! (No, seriously. That's what it's for.) + +— The Wizard & The Emissary +``` + +**Reddit Post (r/feedthebeast):** +``` +Title: We gave our Minecraft server an AI assistant. Here's why. + +Body: +I run Firefrost Gaming, a modded Minecraft network. We just launched something I'm really excited about: Codex. + +**What it is:** +Self-hosted AI assistant that every subscriber gets 24/7 access to. Trained on our server documentation, guides, and troubleshooting database. + +**Why we built it:** +Players get stuck at 3 AM. Staff aren't available 24/7. Crash logs are confusing. We wanted instant help, always available. + +**What it does:** +- Answers gameplay questions instantly +- Analyzes Minecraft crash logs (paste mclo.gs link) +- Teaches mods step-by-step +- Never judgmental, never tired + +**The tech:** +AnythingLLM + Ollama running Llama 3.3 70B and Qwen 2.5 Coder 72B on our dedicated server. Vector database with 1,000+ docs. Zero cloud APIs = complete privacy. + +**Monthly cost:** $0 (self-hosted) + +[Demo video] + +We're not trying to replace human community. We're augmenting it. Staff focus on fun stuff, Codex handles the repetitive questions. + +Early results: 80% of subscriber questions answered by Codex within 60 seconds. Staff workload down significantly. + +Happy to answer questions about the tech or the implementation! +``` + +**YouTube Video Description:** +``` +Introducing Firefrost Codex - The AI Assistant for Gamers + +Most Minecraft servers have Discord. We have an AI. + +In this video: +0:00 - What is Codex? +1:30 - Demo: Answering gameplay questions +3:45 - Demo: Analyzing a crash log +6:20 - Demo: Teaching Create mod +8:15 - The technology behind it +10:00 - Why we built it +12:30 - How to access Codex + +Firefrost Gaming: https://firefrostgaming.com +Try Codex: https://codex.firefrostgaming.com +Discord: [link] + +#Minecraft #AI #ModdedMinecraft #FirefrostGaming +``` + +--- + +### Post-Launch (First 30 Days) + +**Week 1: Showcase Success Stories** +- Daily posts: "Codex helped [subscriber] with [problem]" +- Staff testimonials: "Codex saved me 2 hours today" +- Screenshot impressive interactions +- Highlight mclo.gs analysis accuracy + +**Week 2: Educational Content** +- "10 questions to ask Codex" +- "Hidden Codex features you didn't know about" +- "How Codex learns (and how you can help)" +- Behind-the-scenes tech blog post + +**Week 3: Community Engagement** +- "Funniest Codex questions this week" +- "Most complex problem Codex solved" +- User-generated content contest: Best Codex interaction +- Meme Monday: Codex edition + +**Week 4: Metrics & Transparency** +- "30 days of Codex: By the numbers" +- Total questions answered +- Average response time +- Accuracy rate +- Most common questions +- How we're improving it + +--- + +## Content Calendar (Ongoing) + +### Daily +- Monitor Codex interactions for content opportunities +- Respond to Codex feedback in Discord +- Share interesting Q&As on social media + +### Weekly +- "Codex Highlights" thread in Discord +- One educational post: "Ask Codex about [topic]" +- One technical post: "How Codex works - [feature]" + +### Monthly +- Metrics report: "Codex this month" +- Feature announcement: New capabilities +- Community spotlight: Best Codex users +- Staff update: How Codex helps operations + +### Quarterly +- Major feature releases +- Expanded knowledge base announcements +- Model upgrades (new LLMs) +- Integration announcements (new tools) + +--- + +## Platform-Specific Strategies + +### Discord (Primary Channel) +**Why:** Where subscribers already are +**Content:** Daily interaction, quick help, community building +**Tone:** Casual, friendly, memeable + +**Tactics:** +- Dedicated #codex-chat channel +- Pin impressive interactions +- Weekly "Ask Codex Anything" events +- Staff use Codex publicly (model behavior) + +--- + +### Reddit (Awareness & Credibility) +**Why:** Tech-savvy Minecraft community +**Content:** Technical deep-dives, case studies +**Tone:** Educational, transparent, humble + +**Subreddits:** +- r/feedthebeast (modded Minecraft) +- r/admincraft (server admins) +- r/feedthebeastservers (advertising) +- r/selfhosted (tech audience) +- r/LocalLLaMA (AI enthusiasts) + +**Content Types:** +- "How we built Codex" technical posts +- "Results after 30/60/90 days" data posts +- "Lessons learned self-hosting AI" experience posts +- AMA: "We gave our Minecraft server an AI. AMA" + +--- + +### YouTube (Demonstration & Tutorial) +**Why:** Best for showing Codex in action +**Content:** Demos, tutorials, behind-the-scenes +**Tone:** Educational, impressive, accessible + +**Video Series Ideas:** +- "Codex Crash Course" (how to use it) +- "Codex vs Human" (friendly comparison) +- "Building Codex" (technical series) +- "Codex Saves the Day" (problem-solving showcases) + +--- + +### TikTok/Instagram Reels (Viral Potential) +**Why:** Short-form is shareable +**Content:** Quick wins, impressive moments +**Tone:** Fun, amazing, share-worthy + +**Content Ideas:** +- "POV: You ask Codex for help at 3 AM" +- "Codex analyzes a crash log in 30 seconds" +- "Before/After: Server support with Codex" +- "Things you can ask Codex that will blow your mind" + +--- + +### Twitter/X (Thought Leadership) +**Why:** Tech community engagement +**Content:** Quick updates, insights, threads +**Tone:** Technical, insightful, conversational + +**Content Types:** +- Launch announcements +- Feature updates +- Technical threads: "How we built [feature]" +- Community milestones: "Codex answered its 10,000th question" +- Industry commentary: "Why AI + gaming communities = future" + +--- + +## Messaging Framework + +### Core Messages (Use Consistently) + +**Message 1: The Hook** +> "Most Minecraft servers have Discord. We have an AI." + +**When to use:** Introduction, advertising, external communication + +--- + +**Message 2: The Promise** +> "24/7 instant help. Never wait for staff. Gets smarter every day." + +**When to use:** Subscriber recruitment, tier comparisons + +--- + +**Message 3: The Proof** +> "Codex answers 80% of subscriber questions in under 60 seconds. Staff focus on building community, not answering the same questions." + +**When to use:** Credibility, data-driven marketing, staff recruitment + +--- + +**Message 4: The Tech** +> "Self-hosted on our servers. Trained on 1,000+ Firefrost docs. Zero cloud APIs = complete privacy. Powered by Llama 3.3 70B and Qwen 2.5 Coder." + +**When to use:** Technical audiences, privacy-conscious users, differentiation + +--- + +**Message 5: The Legacy** +> "Codex is knowledge that never dies. Every lesson learned, every problem solved, preserved for everyone who comes after." + +**When to use:** Emotional appeal, community building, "for children not yet born" vision + +--- + +## Sales Enablement + +### Tier Comparison Updates + +**Add to all tier marketing:** + +| Tier | Codex Access | +|------|--------------| +| Wanderer (Free) | ❌ No access | +| Awakened ($1) | ✅ **24/7 Codex access** | +| Elemental ($5+) | ✅ **24/7 Codex access** | + +**Emphasize:** Codex access starts at $1/one-time. Instant ROI. + +--- + +### FAQ Updates + +**Q: Is Codex replacing staff?** +A: No! Codex handles repetitive questions so staff can focus on building community, creating content, and solving complex problems. Staff + Codex = best experience. + +**Q: How accurate is Codex?** +A: Codex answers 80% of questions correctly on first try. For complex issues, it guides you to staff or relevant documentation. It also says "I don't know" rather than making things up. + +**Q: What if Codex gives wrong info?** +A: You can report incorrect answers, and we update the knowledge base. Codex learns from corrections. Staff monitor for accuracy. + +**Q: Can Codex help with crashes?** +A: Yes! Paste your mclo.gs link and Codex analyzes it, identifies the problem, and suggests solutions. It's one of the most popular features. + +**Q: Does Codex work in-game?** +A: Not yet. Currently Discord + website. In-game integration is on the roadmap. + +**Q: Is my data private?** +A: Yes. Codex runs on our servers. Zero cloud APIs. Your questions and logs stay with Firefrost Gaming, never sent to external AI providers. + +**Q: Can I talk to a human instead?** +A: Always! Staff are still available. Use Codex for quick answers, staff for complex issues or personal touch. + +--- + +## Partnership Opportunities + +### Content Creator Partnerships + +**Offer to Minecraft YouTubers/Streamers:** +- Free server access (Legend tier) +- Exclusive Codex demo opportunity +- "How I use Codex to improve my content" +- Revenue share on referrals + +**Pitch:** +> "Want to show your audience the future of Minecraft servers? We'll give you Legend tier access to demo Codex - the first AI assistant for modded Minecraft players. Great content opportunity + your audience gets exclusive discount code." + +--- + +### Technical Blog Partnerships + +**Pitch to:** +- r/selfhosted community +- AI/ML blogs +- DevOps/infrastructure sites +- Open source communities + +**Offer:** +> "Case study: How we built a 24/7 AI assistant for 100+ gamers on a single dedicated server for $0/month. Tech stack, lessons learned, complete transparency. Would you be interested in featuring this?" + +--- + +### Modpack Developer Partnerships + +**Pitch to modpack creators:** +> "We're training Codex on [Your Modpack]. If you have documentation or FAQs, we'll add them to Codex's knowledge base and give you credit. Players get better support, you get visibility." + +**Benefits:** +- Better player experience +- Credit in Codex responses +- Cross-promotion opportunity +- Partnership announcement + +--- + +## Competitive Positioning + +### Vs Traditional Discord Support + +| Feature | Traditional Discord | Firefrost (With Codex) | +|---------|---------------------|------------------------| +| **Availability** | Staff hours only | 24/7/365 | +| **Response Time** | Minutes to hours | Instant (<60 seconds) | +| **Consistency** | Varies by staff member | Always accurate (or says "I don't know") | +| **Scalability** | Hire more staff = more cost | Infinite users, $0 additional cost | +| **Log Analysis** | Manual, time-consuming | Automated via mclo.gs | +| **Learning** | Staff burnout on repetitive Qs | AI never tires, always patient | + +--- + +### Vs Other Minecraft Servers + +**What competitors have:** +- Discord server ✅ +- Staff support ✅ +- Documentation (maybe) ⚠️ + +**What Firefrost has:** +- Discord server ✅ +- Staff support ✅ +- Documentation ✅ +- **24/7 AI assistant** ✅ (UNIQUE) +- **Automated log analysis** ✅ (UNIQUE) +- **Self-hosted (privacy)** ✅ (UNIQUE) + +**Our moat:** No other Minecraft server network offers this. We're first-mover. + +--- + +## Metrics & KPIs + +### Track These Metrics + +**Usage Metrics:** +- Total questions asked +- Questions per subscriber (engagement) +- Most common questions (optimize knowledge base) +- Workspace distribution (Public vs Subscriber vs Staff) +- Peak usage times (capacity planning) + +**Quality Metrics:** +- First-response accuracy rate +- Thumbs up/down ratings +- Follow-up question rate (did first answer solve it?) +- Staff intervention rate (when does human take over?) +- mclo.gs analysis success rate + +**Business Metrics:** +- Conversion rate (Wanderer → Awakened) - did Codex help? +- Retention rate (Codex users vs non-users) +- Staff time saved (quantify hours) +- Support ticket reduction (%) +- Subscriber satisfaction scores + +**Technical Metrics:** +- Response latency (time to answer) +- Model accuracy over time (improving?) +- Uptime (99.9%+ target) +- Concurrent users (load testing) + +--- + +## Launch Checklist + +### Pre-Launch +- [ ] Codex deployed and tested +- [ ] All 5 workspaces populated with content +- [ ] Discord bot operational +- [ ] Embedded widgets live +- [ ] Michael + Meg accounts created +- [ ] Demo videos recorded +- [ ] Marketing copy written +- [ ] Social media posts scheduled +- [ ] Press release drafted (optional) +- [ ] FAQ page updated +- [ ] Staff trained on Codex +- [ ] Beta testers gathered feedback + +### Launch Day +- [ ] Announce in Discord (@everyone ping) +- [ ] Post to Reddit (r/feedthebeast, r/admincraft) +- [ ] Tweet launch announcement +- [ ] Instagram/TikTok post +- [ ] YouTube video goes live +- [ ] Website banner updated +- [ ] Email existing subscribers +- [ ] Monitor for issues +- [ ] Celebrate! 🎉 + +### Post-Launch +- [ ] Daily: Share Codex highlights +- [ ] Weekly: Metrics review +- [ ] Weekly: Content calendar execution +- [ ] Monthly: Major update announcement +- [ ] Ongoing: Knowledge base expansion +- [ ] Ongoing: Community feedback integration + +--- + +## Risk Mitigation + +### Risk 1: Codex Gives Bad Advice + +**Mitigation:** +- Staff monitor Codex responses +- Easy reporting: "This answer is wrong" +- Codex says "I'm not sure, let me get staff" for uncertain answers +- Knowledge base reviewed regularly +- Community helps identify errors + +--- + +### Risk 2: Users Abuse Codex (Spam, Trolling) + +**Mitigation:** +- Rate limiting (X questions per hour) +- Discord roles required for access +- Ban abusive users +- Log all interactions (accountability) + +--- + +### Risk 3: Technical Issues (Downtime, Slow Responses) + +**Mitigation:** +- Monitoring via Uptime Kuma +- DERP protocol for AI failures +- Fallback: "Codex is currently down, staff available" +- Resource monitoring (RAM, CPU, disk) +- Regular backups + +--- + +### Risk 4: Privacy Concerns + +**Mitigation:** +- Transparent data handling policy +- Self-hosted = no cloud providers +- Chat logs stored securely +- Users can request deletion +- No selling/sharing data ever + +--- + +### Risk 5: Unrealistic Expectations + +**Mitigation:** +- Clear communication: "Codex is a tool, not magic" +- Set accuracy expectations (80% first-try) +- "Codex + Staff = best experience" messaging +- Show limitations openly +- Celebrate when it works, acknowledge when it doesn't + +--- + +## Long-Term Vision + +### 6 Months Post-Launch +- 1,000+ subscribers using Codex daily +- 10,000+ questions answered +- 90%+ first-try accuracy +- Staff workload reduced 70% +- Featured in Minecraft community podcasts +- Case study: "How Firefrost scaled support without hiring" + +### 12 Months Post-Launch +- Codex speaks multiple languages +- Voice chat support in Discord +- In-game integration (chat commands) +- Mod developers partnering with us +- "Best AI-assisted Minecraft server" reputation +- Other servers copying our approach (we stay ahead) + +### 24 Months Post-Launch +- Codex Pro tier (advanced features for power users) +- API access for developers +- White-label Codex for other server networks (new revenue stream?) +- Industry leader in AI + gaming communities +- Conference talks: "How we did it" + +--- + +## Competitor Analysis + +### Who Might Copy This? + +**Large networks (Hypixel, CubeCraft):** +- Have resources to build similar +- Slower to move (bureaucracy) +- **Our advantage:** First-mover, community-focused, already established + +**Small/medium servers:** +- Want to copy, lack technical ability +- May use cloud solutions (ChatGPT API = expensive) +- **Our advantage:** Self-hosted = sustainable, privacy-focused + +**New startups:** +- May launch as "AI-first Minecraft network" +- **Our advantage:** Established community, not just tech + +**Our strategy:** Stay ahead via continuous improvement, community integration, and authenticity. Tech can be copied; community cannot. + +--- + +## The Emissary's Role (Meg) + +**Meg is the voice of Codex to the community.** + +**Her responsibilities:** +- Announce Codex features and updates +- Share success stories +- Gather community feedback +- Identify knowledge base gaps +- Create non-technical content +- Humanize the technology +- Moderate Codex interactions +- Celebrate milestones + +**Her superpower:** Making tech feel human, scary feel safe, complex feel simple. + +--- + +## The Wizard's Role (Michael) + +**Michael is the builder and maintainer of Codex.** + +**His responsibilities:** +- Technical implementation +- Knowledge base curation +- Model selection and tuning +- Performance optimization +- Infrastructure monitoring +- Security and privacy +- Staff training on technical aspects +- Blog posts for tech audiences + +**His superpower:** Building things that last, caring deeply about details, "for children not yet born." + +--- + +## Success Definition + +**Codex is successful when:** + +1. **Subscribers say:** "I got help at 3 AM, Codex saved me" +2. **Staff say:** "I finally have time to build cool stuff" +3. **Michael & Meg say:** "We're proud of what we built" +4. **Community says:** "Firefrost is different, they care" +5. **Industry says:** "Firefrost pioneered AI + Minecraft community" + +**Metrics support story, story drives metrics.** + +--- + +**Fire + Frost + Foundation + Codex = Where Love Builds Legacy** 💙🔥❄️ + +--- + +**Document Version:** 1.0 +**Last Updated:** February 20, 2026 +**Owner:** Meg "The Emissary" (Marketing) + Michael "The Wizard" (Technical) +**Status:** Ready for Execution