Files
firefrost-services/services/modpack-version-checker/docs
Claude (Chronicler #83 - The Compiler) 3457b87aef fix(modpack-checker): Code review fixes — license, safety, and polish
Fixes 10 issues from full code review:
- License corrected from MIT to Commercial
- Deprecated datetime.utcnow() replaced with timezone-aware alternative
- PHP array bounds checks added for all platform API responses
- Modrinth file detection now derives project slug instead of using MC version
- validate_api_key() no longer swallows network errors
- HTTP timeouts added to all external API calls in PHP
- Empty API key rejection added to CLI
- Corrupted config now warns on stderr instead of failing silently
- Error response format made consistent across controller
- Docs updated with correct repo URL and clearer CurseForge ID instructions

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 13:37:26 -05:00
..

Modpack Version Checker

Monitor CurseForge modpack versions and get instantly notified when updates are released.

Stop manually checking CurseForge every day. Modpack Version Checker tracks your modpacks and fires a Discord alert the moment a new version drops — saving you 20+ minutes of daily maintenance.


Features

  • Multi-modpack tracking — watch as many packs as you need in a single database
  • Discord notifications — rich embeds with old/new version info sent automatically
  • Version history — full log of every check and what version was found
  • Per-modpack notification control — silence specific packs without removing them
  • Built-in scheduler — runs in the background and checks on a configurable interval
  • Manual override — force a check any time with modpack-checker check
  • Graceful error handling — API downtime shows clear messages, never crashes

Quick Start

# 1. Install
pip install modpack-version-checker

# 2. Set your CurseForge API key (free at console.curseforge.com)
modpack-checker config set-key YOUR_API_KEY

# 3. Add a modpack (use its CurseForge project ID)
modpack-checker add 238222      # All The Mods 9

# 4. Check for updates
modpack-checker check

Installation

See INSTALLATION.md for full setup instructions including optional Discord notifications and background scheduling.


Commands

Command Description
modpack-checker add <id> Add a modpack to the watch list
modpack-checker remove <id> Remove a modpack from the watch list
modpack-checker list Show all watched modpacks and versions
modpack-checker check Check all modpacks for updates now
modpack-checker check --id <id> Check a single modpack
modpack-checker status <id> Show detailed info + check history
modpack-checker notifications <id> --enable/--disable Toggle alerts per modpack
modpack-checker schedule Start background scheduler
modpack-checker config set-key <key> Save CurseForge API key
modpack-checker config set-webhook <url> Save Discord webhook URL
modpack-checker config set-interval <hours> Set check interval
modpack-checker config show Display current configuration

See API.md for full command reference with all flags.


Pricing

Tier Price Features
Standard $9.99 All features listed above

One-time purchase. No subscriptions. Available on BuiltByBit.


Requirements

  • Python 3.9 or newer
  • A free CurseForge API key (get one here)
  • Linux, macOS, or Windows

Support

  • Discord: [Firefrost Gaming Support Server]
  • Response time: within 48 hours

Built by Firefrost Gaming