UpperSupervisor/horizon-modpack-compatibility

项目用途

Hopper 是给 Horizon 玩家用的桌面工具。Horizon 是用 Rust 重写的 Minecraft: Java Edition 26.3，Java 模组 jar 不能在它上面运行，玩家很难判断哪些模组还能留下。Hopper 对每个模组给出四种结论之一：

• Built in：Horizon 已经自带该功能，映射表在 rules/builtin.toml，不需要再装 jar。
• Ported：Horizon 模组注册表中已有 Rust 移植版，索引是 horizon-rust/horizon-mods 生成的 index.json；索引本身不说明对应的 Java 模组，这层对应关系放在 rules/ports.toml。
• Works：Horizon 自带的 horizon-launcher mods check <slug> --json 检查通过，其方块、物品、配方和世界生成能迁移过去。
• Not yet：其余模组，可以在「最想要」榜上投票，票数按设计只是近似值。

它也能一次读取整个整合包——mods 文件夹、Prism 或 MultiMC 实例、.mrpack 或 CurseForge zip——把模组分成「可以带走」「不再需要」「尚未支持」三组，并支持一键把第一组装进 Horizon。单个模组可以加入关注，等 Horizon 版本出现时提示。主要用户是把现成整合包迁到 Horizon 的玩家；移植者也可以参考「最想要」榜决定下一步做什么。

快速使用

需要 Windows 10 或 11，并且同一台电脑上装有 Horizon 26.3，Hopper 会自行找到它。下载 Hopper-1.3.5-portable-x64.exe：单文件，无需安装程序，也不需要管理员权限。当前构建尚未代码签名，首次运行时 SmartScreen 可能拦截，选择 More info，再选 Run anyway。

1. 在装有 Horizon 的电脑上启动 Hopper。
2. 输入模组名，或把 jar、mods 文件夹、整合包拖到窗口上。支持的整合包输入包括 mods 文件夹、Prism 或 MultiMC 实例、.mrpack 和 CurseForge zip。
3. 读取结论——Built in、Ported、Works 或 Not yet——再点下方的按钮：Install、Add to Horizon、Want it too；自带功能则显示 How to turn it on。
4. 拖入整合包后，点一次「Add the 30 to Horizon」这样的按钮即可安装全部兼容模组，逐个模组的结果在 Show details 里。

无法识别的模组（通常是只在 CurseForge 上的）会显示 Not sure yet，在整合包统计中按尚未支持计算。无需账号，也不收费。

使用约束与数据处理

• 平台：打包发布版仅支持 Windows 10/11 x64。
• 依赖：安装模组要求同一台机器上有 Horizon 26.3；只检查 jar 可以不用它，但安装不行。
• 识别数据：模组哈希和名称会发给 Modrinth 的 POST /v2/version_files 用于识别；拖入的 jar 先读取 fabric.mod.json、META-INF/neoforge.mods.toml 或 META-INF/mods.toml。图标来自 Modrinth CDN 并缓存在本地。检查移植情况时会下载 Horizon 的模组注册表索引。投票会和首次启动生成的随机安装 ID 一起发到投票服务；没有遥测，整合包和关注列表都留在本机。
• CurseForge 匹配：CurseForge 的 API 需要密钥，所以仅存在于 CurseForge 的模组按名称匹配，可能给出不确定的结果。
• 安装校验：只安装 Horizon 注册表中列出的文件，并逐个校验 SHA-256；项目提供密钥时还会校验 minisign 签名。被撤销的文件不会安装，已有的副本会被禁用并说明原因。内容模组（.hmod）进入 horizon-mods/，原生模组（.hnmod）进入 horizon-native-mods/；原生模组不受沙箱限制，Horizon 首次使用时会要求确认信任。
• 投票：每个安装 ID 对每个模组只能投一次，同一地址的投票频率也有限制，票数只用于大致排序。
• 从源码构建：需要 Rust 1.85 及以上和对应系统的 Tauri 前置条件；jar 读取与结论判断在 crates/hopper-core，投票服务在 server/，桌面界面在 app/。许可证为 MIT。

HotRepo 点评

Hopper 出现在 HotRepo 2026-11-01 的 Rust 语言新项目记录中：从 2026-10-31 23:20 UTC 到 2026-11-01 10:45 UTC 约 11.5 小时的窗口内新增 107 Star、4 Fork。站内目前只有这一条快照和一次 Star 采样，只能说明早期有人关注，不足以判断趋势。技术上值得注意的是，Hopper 把兼容性判断交给 Horizon 自己的启动器检查，而不是另写一套，Java 到 Rust 的对应关系放在可审阅的 TOML 文件中，使结论可核查、也方便社区补充。