08a52ee3cf
Standard $14.99 / Professional $24.99 — two-tier model. This pricing is FINAL per original marketing strategy. Claude (Chronicler #83 - The Compiler) <claude@firefrostgaming.com>
81 lines
2.8 KiB
Markdown
81 lines
2.8 KiB
Markdown
# ModpackChecker — Development Guide
|
|
|
|
## What This Is
|
|
A commercial product for the Minecraft server hosting community. Two components:
|
|
|
|
### 1. Python CLI Tool (`src/modpack_checker/`)
|
|
- pip-installable utility that monitors CurseForge modpack versions
|
|
- Discord webhook notifications when updates drop
|
|
- SQLite database for version history and scheduling
|
|
- Target marketplace: BuiltByBit (paid product)
|
|
|
|
### 2. Pterodactyl Blueprint Extension (`blueprint-extension/`)
|
|
- PHP/Laravel backend + React/TSX frontend
|
|
- Adds update badges to Pterodactyl Panel dashboard
|
|
- Orange dot = update available, Green dot = up to date
|
|
- Console widget for manual version checks
|
|
- Target marketplace: BuiltByBit (paid product)
|
|
|
|
## Dev Panel Environment
|
|
- Python 3.12, PHP 8.3, Node.js 24
|
|
- Blueprint beta-2026-01 installed
|
|
- Pterodactyl Panel running at this server
|
|
- Phase 5 backup at `/root/modpackchecker_backup/`
|
|
|
|
## Key Files
|
|
- `src/modpack_checker/cli.py` — CLI entry point
|
|
- `src/modpack_checker/curseforge.py` — CurseForge API client
|
|
- `src/modpack_checker/notifier.py` — Discord webhook sender
|
|
- `src/modpack_checker/database.py` — SQLite persistence
|
|
- `blueprint-extension/conf.yml` — Blueprint manifest
|
|
- `blueprint-extension/build.sh` — Build script for .blueprint package
|
|
- `blueprint-extension/views/dashboard/UpdateBadge.tsx` — Dashboard badge component
|
|
- `blueprint-extension/views/server/wrapper.tsx` — Server console widget
|
|
- `blueprint-extension/app/Services/ModpackApiService.php` — Backend API service
|
|
- `blueprint-extension/app/Console/Commands/CheckModpackUpdates.php` — Artisan command
|
|
|
|
## Blueprint Build & Install
|
|
```bash
|
|
cd blueprint-extension
|
|
bash build.sh # Creates .blueprint package
|
|
blueprint -install modpackchecker # Installs on this Panel
|
|
```
|
|
|
|
## Python Build & Test
|
|
```bash
|
|
pip install -e . # Install in dev mode
|
|
modpack-checker --help # Verify CLI works
|
|
pytest tests/ # Run test suite
|
|
```
|
|
|
|
## Git
|
|
- Repo: firefrost-services (main branch)
|
|
- Path: services/modpack-version-checker/
|
|
- Push requires Gitea token: already in repo clone URL
|
|
|
|
## Commercial License
|
|
This is a PAID product. Do not include any open-source license headers.
|
|
All code is: "Commercial License - Unauthorized redistribution prohibited."
|
|
|
|
## Accessibility
|
|
Michael has hand surgery limitations. Small code blocks (8-10 lines).
|
|
One question at a time. Complete files over patches.
|
|
|
|
## PRICING — LOCKED (DO NOT CHANGE)
|
|
|
|
### Standard Tier: $14.99
|
|
- CurseForge & Modrinth support
|
|
- Smart auto-detection
|
|
- Dashboard status badges
|
|
- Manual UI re-scan button
|
|
- Standard support (48h SLA)
|
|
|
|
### Professional Tier: $24.99
|
|
- Everything in Standard PLUS:
|
|
- FTB support
|
|
- Background auto-cron checks (every 6 hours)
|
|
- Discord webhook alerts
|
|
- Priority support (24h SLA)
|
|
|
|
Launch at FULL PRICE. No discounts. No price drift.
|