unsup

unsup

一个可定制的简单模组整合包更新器,非常适合私人整合包

Una 的 Simple Updater

unsup 是一个用 Java 实现的通用工作目录同步器,实现方式较为简洁。它支持作为 Java agent 运行,从而搭载在另一个程序的启动过程中。

它特别适合在小范围内同步小型私有整合包或一次性整合包,在这些场景中,完整的公开发布(例如在 Modrinth 上!)显得过于繁琐或并不合适。 它能够从模组的原始来源下载模组,无论来源在哪里……只要它支持 HTTP(S)。

必须在工作目录中放置一个 unsup.ini,unsup 才知道该做什么;或者通过 -Dunsup.bootstrapUrl= JVM 参数指定在哪里找到这样的文件。

更新器会尽力确保工作目录永远不会处于不一致的状态。除非在应用更改的过程中突然断电(这个时间窗口极短),否则 unsup 更新不会导致工作目录不一致或损坏。

它会对所有下载内容以及覆盖前的文件进行基于哈希的一致性校验(哈希函数可自选,推荐 SHA-256),如果用户更改了已被更新的内容,会向用户发出警告。它还额外支持使用 OpenBSD Signify 对清单进行签名,以提供额外的安全性。

unsup 独特的简化设计意味着它兼容所有启动器,从原版启动器到 MultiMC。只需将 -javaagent:unsup.jar 添加到 JVM 参数中,并将 unsup.jar 和 unsup.ini 放入 .minecraft 目录即可。

在 Prism Launcher 中,你可以通过从 Forgejo 上最新发布版导入 com.unascribed.unsup.json,将 unsup 用作一个“组件”。(我无法将 JSON 文件上传到 Modrinth)。这将允许 Prism Launcher 下载并管理 unsup。(尽管有人提出过请求,MultiMC 不支持 Java agent 组件。)

它还内置了环境和风味的概念,使其不仅能管理客户端,还能用于管理服务器安装,并允许用户通过功能丰富的界面在多个互不兼容的模组集之间进行选择,这是其他任何更新工具都无法提供的。

unsup 还能够更新 MultiMC 的“组件”,包括将 unsup 自身作为组件添加时的自我更新。这意味着你可以更新模组加载器或 Minecraft 本身。

创建整合包

你可以让 unsup 指向一个 Packwiz 的 pack.toml(推荐),或者手动编写原生 unsup 清单。有关原生清单格式的信息,请参阅 wiki。由于 Packwiz 已成为 Minecraft 整合包的事实标准,Creator GUI 暂时搁置。

稳定性

unsup 已被用于从 b1.7.3 到 1.21.5 各版本的整合包,涵盖客户端和服务端,并且已知可与 Forge(包括旧版和现代版)、Fabric、Quilt 和 NeoForge 配合使用。它已成功支撑了许多整合包,从小型到大型。原生清单和 Packwiz 清单支持都相当稳定,并已被广泛使用。

签名支持仍处于实验阶段,尚未有人在大规模场景中部署使用。那个人可能就是你——如果它运行良好,请告诉我!

GUI

unsup 拥有一个简约而优雅的 GUI,可在任何平台上运行(是的,包括 macOS),并且其所有颜色都可以自定义,以契合你的品牌风格。它附带一个带有薄荷色点缀的深色主题。去看看画廊标签页吧!

许可证

unsup 以 LGPLv3 发布。