简易整合包更新检查器

简易整合包更新检查器

一个适用于整合包的简单模组,它会自动检查整合包是否为最新版本,若否,则显示一条通知。使用modrinth id作为参考。

杂项

icon.png

简单整合包更新检查器(Simple Modpack Update Checker) 是一个轻量级模组,用于检查你的整合包是否为最新版本。此模组会将整合包的版本与远程源进行比对,并在有可用更新时通知你。

支持的版本

smuc 1.0.0 smuc 2.0.0
mc 1.21 ✅ ✅
mc 1.21.1 ✅ ✅
mc 1.21.2 ✅ ✅
mc 1.21.3 ✅ ✅
mc 1.21.4 ✅ ✅
mc 1.21.5 ✅ ✅
mc 1.21.6 ✅ ✅
mc 1.21.7 ✅ ✅
mc 1.21.8 ✅ ✅
mc 1.21.9 ✅ ✅
mc 1.21.10 ✅ ✅

配置

配置文件位于 config/simple-modpack-update-checker.json。对于大多数用户,只需三个字段:

{
  "configVersion": 2,
  "localVersion": "3.3.3",
  "identifier": "KmiWHzQ4"
}
  1. configVersion:配置文件版本(自动设置)
  2. localVersion:当前已安装整合包的版本。可以是任意字符串。
  3. identifier:一个指向包含最新版本文本文件的 URL(格式为 version = "String",例如 你的 packwiz 生成的 pack.toml),或者是 Modrinth 项目 ID(CurseForge 功能将后续实现)。

配置选项

字段 必填 描述 默认值 示例
configVersion ✅ 配置文件版本 2 2
localVersion ✅ 当前整合包版本 - "3.3.3"
identifier ✅ Modrinth 项目 ID 或 URL - "KmiWHzQ4"
minecraftVersions ❌ 要跟踪的特定 Minecraft 版本 (仅限 Modrinth) 所有版本 ["1.21.4", "1.21.5"]
releaseChannel ❌ 要跟随的发布频道 (仅限 Modrinth) "release" "beta", "alpha"

注意: minecraftVersions 和 releaseChannel 仅在使用 Modrinth 项目 ID 时生效。使用 URL 时,这些选项会被忽略,模组将直接检查 URL 中的版本字符串。

发布频道

注意: 发布频道仅在使用 Modrinth 项目 ID 时生效。基于 URL 的配置将忽略此设置。

该模组支持不同的发布频道,它们以 层级 方式工作。较不稳定的频道包含所有更稳定的版本:

频道类型

  • "release"(默认):仅限稳定版
  • "beta":测试版和稳定版
  • "alpha":Alpha 版、测试版和稳定版(所有版本)

示例场景

如果一个项目有以下版本(新的在前):

  1. 2.1.0-alpha(昨天)
  2. 2.0.5(稳定版,3 天前)
  3. 2.0.4-beta(1 周前)

各频道的结果:

  • "alpha" → 显示 2.1.0-alpha(任何类型的最新版本)
  • "beta" → 显示 2.0.5(最新的测试版/稳定版,跳过 alpha)
  • "release" → 显示 2.0.5(仅限最新稳定版)

示例

使用 URL(仅基础版本检查):

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

使用 Modrinth 项目 ID(基础):

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

带 Minecraft 版本过滤(仅限 Modrinth):

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

带 Beta 发布频道(仅限 Modrinth):

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

带多个 Minecraft 版本和发布频道(仅限 Modrinth):

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

用法

当你安装了此模组启动 Minecraft 时,它会根据你的配置文件自动检查更新,并在有可用更新时通知你。

对于 Modrinth 项目

  • 模组从 Modrinth API 获取版本信息
  • 支持按 Minecraft 版本和发布频道进行过滤
  • 根据你配置的过滤器显示新版本的更新通知

对于基于 URL 的检查

  • 模组从你指定的 URL 获取内容
  • 查找格式为 version = "String" 的版本信息
  • 与 packwiz 的 pack.toml 文件兼容
  • 注意: URL 不支持 Minecraft 版本过滤和发布频道

img.png