# 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

```bash
# 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](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](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](https://builtbybit.com).

---

## Requirements

- Python 3.9 or newer
- A free CurseForge API key ([get one here](https://console.curseforge.com))
- Linux, macOS, or Windows

---

## Support

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

---

*Built by Firefrost Gaming*