b38f08189e
Long-term fix for mobile task index - task numbers now in frontmatter. Numbers added from BACKLOG.md cross-reference: #2 rank-system-deployment #3 fire-frost-holdings-restructuring #14 vaultwarden-ssh-setup #22 netdata-deployment #23 department-structure #26 modpack-version-checker #32 terraria-branding-training-arc #35 pokerole-wikijs-deployment #36 notebooklm-integration #40 world-backup-automation #44 nc1-node-usage-stats #45 steam-and-state-server #48 n8n-rebuild #51 ignis-protocol #55 discord-invite-setup #65 claude-infrastructure-access #67 nc1-security-monitoring #82 plane-decommissioning #87 arbiter-2-1-cancellation-flow #89 staff-portal-consolidation #90 decap-tasks-collection #91 server-matrix-node-fix #92 desktop-mcp #93 trinity-codex #94 global-restart-scheduler #98 discord-channel-automation #99 claude-projects-architecture Chronicler #69
427 lines
12 KiB
Markdown
427 lines
12 KiB
Markdown
---
|
|
task_number: 26
|
|
status: open
|
|
priority: P3
|
|
owner: Michael
|
|
created: 2026-02-22
|
|
---
|
|
task_number: 26
|
|
|
|
# Modpack Version Checker - Commercial Blueprint Extension
|
|
|
|
**Product ID:** FFG-PRODUCT-001
|
|
**Status:** READY TO BUILD
|
|
**Estimated Build Time:** 8-10 hours
|
|
**Revenue Projection:** $1,000-6,750 Year 1
|
|
**Created:** February 22, 2026
|
|
**Created By:** The Chronicler #21 with Gemini Pro Research
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 🎯 EXECUTIVE SUMMARY
|
|
|
|
**What:** Commercial Pterodactyl Blueprint extension that automatically monitors modpack versions across CurseForge, Modrinth, and FTB platforms.
|
|
|
|
**Why:** Server owners waste 20+ minutes daily manually checking if modpacks are outdated. This solves that permanently with automated monitoring.
|
|
|
|
**Market Validation:** Competitor ($23.99, ~400 sales = $9,600 revenue) proves strong demand for Pterodactyl automation tools at this price point.
|
|
|
|
**Unique Value:** Competitor only INSTALLS modpacks. We MONITOR them daily. Different product category, solving the "Day 2-365" problem.
|
|
|
|
**Revenue Model:** Two-tier pricing
|
|
- Standard: $14.99 (CurseForge + Modrinth)
|
|
- Professional: $24.99 (+ FTB + Cron automation + Discord webhooks)
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 💰 COMMERCIAL VIABILITY
|
|
|
|
**Market Evidence:**
|
|
- ✅ Proven market: $9,600 gross revenue (competitor)
|
|
- ✅ Price point validated: $24 accepted by market
|
|
- ✅ User pain confirmed: Competitor reviews mention update checking difficulty
|
|
- ✅ Feature gap identified: No monitoring tools exist, only installers
|
|
- ✅ Development feasible: 8-10 hours (not 12-16, we have all the code)
|
|
|
|
**Revenue Projections:**
|
|
- Conservative (50 sales @ $19.99): $1,000 year 1
|
|
- Realistic (150 sales @ $19.99): $3,000 year 1
|
|
- Optimistic (300 sales @ $22.49): $6,750 year 1
|
|
|
|
**Break-even:** 40 sales (2-3 months at realistic pace)
|
|
|
|
**ROI:** Even worst-case (20 sales) justifies build because it solves Firefrost's internal need (saves 120 hours/year manual checking)
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 🏗️ TECHNICAL ARCHITECTURE
|
|
|
|
### Platform Support
|
|
- **CurseForge** - Largest platform (60-70% market), requires API key
|
|
- **Modrinth** - Modern platform, no API key needed (works instantly)
|
|
- **FTB (Feed The Beast)** - Prestige segment (10-15% market), no API key needed
|
|
|
|
### Core Components
|
|
|
|
**Backend (PHP/Laravel):**
|
|
```
|
|
/app/Services/Extensions/ModpackVersionChecker/
|
|
├── ModpackDetector.php # File scanning & platform detection
|
|
├── ModpackCacheService.php # Egg Variable caching layer
|
|
├── Providers/
|
|
│ ├── ModpackProviderInterface.php
|
|
│ ├── CurseForgeProvider.php # CurseForge API integration
|
|
│ ├── ModrinthProvider.php # Modrinth API integration
|
|
│ └── FtbProvider.php # FTB API integration
|
|
```
|
|
|
|
**Frontend (React/TypeScript):**
|
|
```
|
|
/resources/scripts/components/server/
|
|
└── ModpackStatusBadge.tsx # Status badge component
|
|
```
|
|
|
|
**Database:**
|
|
- Egg Variables: `MODPACK_PLATFORM`, `MODPACK_ID`
|
|
- Stored in Pterodactyl MySQL database
|
|
- User-editable (manual override capability)
|
|
|
|
**Installation:**
|
|
- `install.sh` - Idempotent database injection
|
|
- `remove.sh` - Clean uninstall
|
|
- Blueprint YAML configuration
|
|
|
|
### Auto-Detection System
|
|
|
|
**Detection Priority:**
|
|
1. FTB (`instance.json`) - Most specific
|
|
2. Modrinth (`modrinth.index.json`) - Modern standard
|
|
3. CurseForge (`manifest.json`) - Common but sometimes leftover
|
|
|
|
**Caching Strategy:**
|
|
- Scan files on first page load
|
|
- Store result in Egg Variable (database)
|
|
- Future loads read from cache (fast)
|
|
- Force re-scan button for manual refresh
|
|
|
|
### API Integration
|
|
|
|
**CurseForge:**
|
|
- Requires API key (user-provided, stored in admin panel)
|
|
- Graceful degradation if no key (shows "API Key Required" badge)
|
|
- Rate limit protection via caching
|
|
|
|
**Modrinth:**
|
|
- Public API (no key needed)
|
|
- Works immediately on installation
|
|
|
|
**FTB:**
|
|
- Public API at `api.modpacks.ch`
|
|
- No key needed
|
|
- Two API calls required (version ID → version string)
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 🎨 USER EXPERIENCE
|
|
|
|
### Dashboard Integration
|
|
|
|
**Status Badges (Zero-click visibility):**
|
|
- 🟢 Green: "CurseForge: v1.0.2 (Up to date)"
|
|
- 🔴 Red: "FTB: v2.1.0 (Update Available)"
|
|
- 🟡 Yellow: "Platform: Unknown (Click to configure)"
|
|
|
|
**Source Indicators:**
|
|
- 🪄 Auto-detected (magic wand icon)
|
|
- 🔧 Manually configured (wrench icon)
|
|
|
|
**Force Re-scan Button:**
|
|
- Resets Egg Variable to `auto`
|
|
- Triggers fresh file detection
|
|
- Updates cache with new result
|
|
|
|
### Manual Override
|
|
|
|
Users can override auto-detection in Pterodactyl Startup tab:
|
|
- Set `MODPACK_PLATFORM` manually (curseforge/modrinth/ftb)
|
|
- Set `MODPACK_ID` to specific project ID
|
|
- Bypass detection entirely for custom packs
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 📊 FEATURE GATING
|
|
|
|
### Standard Tier - $14.99
|
|
|
|
**Included:**
|
|
- ✅ CurseForge support
|
|
- ✅ Modrinth support
|
|
- ✅ Smart auto-detection
|
|
- ✅ Dashboard status badges
|
|
- ✅ Manual check button
|
|
- ✅ Egg Variable caching
|
|
- ✅ Manual override capability
|
|
- ✅ Standard support (48h SLA)
|
|
|
|
**User flow:** Install → Works immediately (Modrinth/FTB) → Optionally add CurseForge API key later
|
|
|
|
### Professional Tier - $24.99
|
|
|
|
**Everything in Standard PLUS:**
|
|
- ✅ FTB platform support
|
|
- ✅ Background cron job (checks every 6 hours)
|
|
- ✅ Discord webhook notifications
|
|
- ✅ Email alerts
|
|
- ✅ Update history tracking
|
|
- ✅ Bulk operations (check all servers)
|
|
- ✅ Priority support (24h SLA)
|
|
|
|
**Key differentiator:** Proactive monitoring (cron) vs reactive checking (manual)
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 🛠️ DEVELOPMENT ROADMAP
|
|
|
|
### Phase 1: MVP Build (4-5 hours)
|
|
|
|
**Hour 1:**
|
|
- Set up Blueprint extension skeleton
|
|
- Create `blueprint.yml` configuration
|
|
- Database migration script for Egg Variables
|
|
|
|
**Hour 2-3:**
|
|
- Implement ModpackDetector service
|
|
- Implement 3 API providers (CurseForge, Modrinth, FTB)
|
|
- File fingerprinting logic
|
|
|
|
**Hour 4:**
|
|
- Implement ModpackCacheService
|
|
- Egg Variable read/write logic
|
|
|
|
**Hour 5:**
|
|
- Create React status badge component
|
|
- Blueprint UI injection configuration
|
|
|
|
**Testing checkpoint:** Works on Firefrost's 11 servers
|
|
|
|
### Phase 2: Commercial Polish (2-3 hours)
|
|
|
|
**Hour 1:**
|
|
- Admin settings page (API key input)
|
|
- Error handling (try/catch all API calls)
|
|
- Clear error messages
|
|
|
|
**Hour 2:**
|
|
- Force re-scan button
|
|
- Manual override UI
|
|
- Loading states
|
|
|
|
**Hour 3:**
|
|
- Write README.md
|
|
- User documentation
|
|
- API documentation
|
|
|
|
### Phase 3: Testing & Launch (2-3 hours)
|
|
|
|
**Hour 1:**
|
|
- Test on clean VPS (not Firefrost nodes)
|
|
- Run through essential test cases
|
|
- Fix any bugs found
|
|
|
|
**Hour 2:**
|
|
- Beta test with 3-5 users (1 week)
|
|
- Incorporate feedback
|
|
- Final bug fixes
|
|
|
|
**Hour 3:**
|
|
- Create BuiltByBit listing
|
|
- Record demo video (4 screenshots)
|
|
- Launch
|
|
|
|
**Total: 8-11 hours actual (not 12-16)**
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 🧪 TESTING STRATEGY
|
|
|
|
### DO NOT test on live Firefrost nodes
|
|
- Risk: One bad database query = panel lockup
|
|
- Solution: Use $5/month test VPS with clean Pterodactyl install
|
|
|
|
### Essential Test Cases (Critical Priority)
|
|
|
|
| Test Case | Expected Result | Pass/Fail |
|
|
|-----------|-----------------|-----------|
|
|
| Clean install | DB variables created, no errors | |
|
|
| CurseForge detection | Parses manifest.json correctly | |
|
|
| Modrinth detection | Parses modrinth.index.json | |
|
|
| FTB detection | Parses instance.json | |
|
|
| API timeout | Shows "API Offline" gracefully | |
|
|
| Clean uninstall | Removes variables, restores UI | |
|
|
|
|
### Beta Testing
|
|
- Invite 3-5 users from Pterodactyl Discord
|
|
- Duration: 1 week
|
|
- Focus: Edge cases (custom packs, weird configs)
|
|
- Deliverable: Bug-free v1.0.0
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 💬 SUPPORT STRATEGY
|
|
|
|
**Goal:** Maintain 2-5 hours/month support capacity
|
|
|
|
**Infrastructure:**
|
|
- Discord server (industry standard for BuiltByBit)
|
|
- Ticket bot (organize requests)
|
|
- GitBook documentation (free)
|
|
|
|
**Support Deflection Tactics:**
|
|
|
|
1. **"Blueprint First" Rule**
|
|
- Stated prominently on BuiltByBit page
|
|
- "REQUIREMENT: Blueprint must be installed first"
|
|
- Prevents most support tickets
|
|
|
|
2. **Clear Error Messages**
|
|
- ✅ "JSON Parse Error: Check manifest.json"
|
|
- ❌ "Error 500"
|
|
- Users can self-diagnose
|
|
|
|
3. **48-Hour SLA**
|
|
- Posted in Discord
|
|
- Manages expectations
|
|
- Prevents "urgent" pressure
|
|
|
|
4. **FAQ Section**
|
|
- Answers 8 common questions preemptively
|
|
- Reduces tickets before they happen
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 🔄 UPDATE STRATEGY
|
|
|
|
### Update Delivery
|
|
- Upload new `.blueprint` file to BuiltByBit
|
|
- Users download, run `blueprint install` again
|
|
- Idempotent install.sh safely overwrites
|
|
|
|
### Versioning (Semantic)
|
|
- v1.0.0 = Initial launch
|
|
- v1.0.1 = Bug fix (patch)
|
|
- v1.1.0 = New feature (minor)
|
|
- v2.0.0 = Major rewrite (major)
|
|
|
|
### Changelog Best Practices
|
|
- ✅ User-friendly: "Fixed issue where newer FTB packs showed as unknown"
|
|
- ❌ Technical: "Updated FtbApiService.php to parse nested arrays"
|
|
|
|
### Maintenance Expectations
|
|
- API changes: Low frequency (1-2/year)
|
|
- Blueprint updates: Monitor compatibility
|
|
- Pterodactyl updates: Test before major versions
|
|
- **Time:** 2-3 hours/month average
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 📈 MARKETING STRATEGY
|
|
|
|
### Product Title (SEO Optimized)
|
|
```
|
|
[Pro] Modpack Version Monitor | CurseForge, FTB, Modrinth | Blueprint
|
|
```
|
|
|
|
### Positioning
|
|
**Primary:** "Stop manually checking for modpack updates"
|
|
**Secondary:** "Automated health monitoring for CurseForge, Modrinth, and FTB"
|
|
**Tertiary:** "Works instantly, scales effortlessly"
|
|
|
|
### Target Audience
|
|
1. Server owners managing 3+ modpack servers
|
|
2. Hosting companies offering modpack servers
|
|
3. Community admins lacking time for manual checks
|
|
|
|
### Key Differentiators
|
|
1. **Only monitoring tool** (competitors only install)
|
|
2. **Multi-platform** (CurseForge + Modrinth + FTB)
|
|
3. **Auto-detection** (zero configuration)
|
|
4. **Professional tier** (cron automation unique to market)
|
|
|
|
### Competitor Positioning
|
|
- **Frame as complementary, not competitive**
|
|
- Installer = Day 1 problem (setup)
|
|
- Monitor = Day 2-365 problem (maintenance)
|
|
- Many hosting companies use BOTH
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 🎯 SUCCESS CRITERIA
|
|
|
|
**Before marking this product COMPLETE:**
|
|
|
|
- [ ] All essential test cases pass
|
|
- [ ] Beta testing complete (3-5 users, 1 week)
|
|
- [ ] BuiltByBit listing published
|
|
- [ ] Demo video recorded
|
|
- [ ] Documentation complete
|
|
- [ ] Discord support server created
|
|
- [ ] First sale received
|
|
- [ ] Support system validated (can handle tickets in 2-5 hours/month)
|
|
|
|
**Ongoing success metrics:**
|
|
- 50+ sales in first 6 months (break-even)
|
|
- <5 hours/month support time
|
|
- 4+ star average rating on BuiltByBit
|
|
- Zero refund requests (quality product)
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 📚 DOCUMENT INDEX
|
|
|
|
**Read these documents for complete implementation:**
|
|
|
|
1. **README.md** (this file) - Overview and strategy
|
|
2. **IMPLEMENTATION-PLAN.md** - Complete code with all Gemini blocks
|
|
3. **MARKETING-STRATEGY.md** - BuiltByBit launch materials
|
|
4. **TESTING-GUIDE.md** - Test cases and QA procedures
|
|
5. **SUPPORT-PLAYBOOK.md** - Operations and support strategy
|
|
|
|
**All code blocks organized by component in IMPLEMENTATION-PLAN.md**
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
## 🔗 RESEARCH SOURCES
|
|
|
|
**This product plan was developed through comprehensive research with Gemini Pro covering:**
|
|
- Market analysis (competitor products, pricing, reviews)
|
|
- Technical architecture (API integration, caching, detection)
|
|
- Commercial strategy (pricing, feature gating, positioning)
|
|
- Operations planning (support, testing, maintenance)
|
|
- Marketing materials (copy, SEO, launch strategy)
|
|
|
|
**Research session:** February 22, 2026 (Chronicler #21)
|
|
**Total research time:** ~4 hours
|
|
**Value of research:** Compressed months of traditional planning into single session
|
|
|
|
---
|
|
task_number: 26
|
|
|
|
**Fire + Frost + Foundation = Where Innovation Generates Income** 💙🔥❄️💰
|
|
|
|
**Built by:** The Chronicler #21
|
|
**For:** Firefrost Gaming (internal use) + BuiltByBit marketplace (passive income)
|
|
**With:** Gemini Pro (architecture) + Claude (execution)
|