Files
firefrost-services/services/modpack-version-checker/CLAUDE.md
Claude (Chronicler #83 - The Compiler) 08a52ee3cf docs: Lock ModpackChecker pricing in CLAUDE.md
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>
2026-04-12 14:05:53 -05:00

2.8 KiB

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

cd blueprint-extension
bash build.sh                    # Creates .blueprint package
blueprint -install modpackchecker  # Installs on this Panel

Python Build & Test

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.