Simple Modpack Update Checker

A lightweight and straightforward mod for checking whether your modpack is up-to-date. It automatically compares the current version of your installed modpack with information from remote sources and notifies you when updates are available.

Supported Minecraft Versions

The mod is fully compatible with the following Minecraft versions:

• Minecraft 1.21
• Minecraft 1.21.1
• Minecraft 1.21.2
• Minecraft 1.21.3
• Minecraft 1.21.4
• Minecraft 1.21.5
• Minecraft 1.21.6
• Minecraft 1.21.7
• Minecraft 1.21.8

Configuration and Setup

All settings are managed through the configuration file config/simple-modpack-update-checker.json. Most users only need to fill out three basic fields:

{
  "configVersion": 2,
  "localVersion": "3.3.3",
  "identifier": "KmiWHzQ4"
}

Essential Parameters:

• configVersion — Configuration file version (set automatically)
• localVersion — Current version of your modpack (can be any string value)
• identifier — Modrinth project ID or URL to a version information file

Additional Settings

Important: The minecraftVersions and releaseChannel settings only work when using a Modrinth project ID.

Update Channels

When using a Modrinth project ID, you can select your preferred update channel. Channels operate on a hierarchical principle where more unstable channels include stable versions:

Available Channels:

• "release" (default) — Only stable releases
• "beta" — Beta versions and stable releases
• "alpha" — Alpha versions, beta versions, and stable releases (all levels)

Practical Example

Assume a project has the following versions (from newest to oldest):

1. 2.1.0-alpha (release from yesterday)
2. 2.0.5 (stable release, 3 days ago)
3. 2.0.4-beta (beta version, one week ago)

Results by channel:

• "alpha" → Shows 2.1.0-alpha (latest of any type)
• "beta" → Shows 2.0.5 (latest beta or release, skips alpha)
• "release" → Shows 2.0.5 (only stable releases)

Configuration Examples

Basic URL setup:

{
  "configVersion": 2,
  "localVersion": "3.3.3",
  "identifier": "https://raw.githubusercontent.com/SkyblockerMod/Skyblocker-modpack/main/packwiz/pack.toml"
}

Basic Modrinth ID:

{
  "configVersion": 2,
  "localVersion": "3.3.3",
  "identifier": "KmiWHzQ4"
}

Minecraft version filtering:

{
  "configVersion": 2,
  "localVersion": "3.3.3",
  "identifier": "KmiWHzQ4",
  "minecraftVersions": ["1.21.4"]
}

Beta update channel:

{
  "configVersion": 2,
  "localVersion": "3.3.3-beta.5",
  "identifier": "KmiWHzQ4",
  "releaseChannel": "beta"
}

Advanced configuration:

{
  "configVersion": 2,
  "localVersion": "3.3.3",
  "identifier": "KmiWHzQ4",
  "minecraftVersions": ["1.21.4", "1.21.5"],
  "releaseChannel": "alpha"
}

Operational Details

With Modrinth Projects

• Fetches version information through Modrinth API
• Supports Minecraft version filtering
• Supports multiple update channels
• Displays notifications for available updates based on settings

With URL-Based Checks

• Downloads data from specified URLs
• Analyzes version information in text files
• Compatible with packwiz pack.toml files
• Important: URL-based checks ignore Minecraft version and channel filtering

The mod automatically performs checks each time Minecraft starts and alerts you when updates are required.