RetroConvert

模组

· 作者 Slainlight

将 Babric 模组转换为 Ornithe 模组(在 Ornithe 环境中或以 Java Agent 形式)

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.4+mcb1.7.3 · Ornithe

一键开服(送7天)

RetroConvert

将你的 Babric 模组放入 Ornithe 实例中,RetroConvert 会在启动时自动转换它们。

Babric 和 Ornithe 都基于 Minecraft Beta 1.7.3 运行 Fabric Loader,但它们使用不同的中间映射表(intermediary mappings),因此两者的模组并不兼容。RetroConvert 解决了这个问题:在启动时,它会就地重写 Babric 模组的字节码,以词元对词元的方式转换为 Ornithe 的 Calamus gen2 映射表,无需重新编译、无需源码,也不需要联网。

功能

  • 完全自动 只需将 Babric .jar 文件放入 mods 文件夹,与 RetroConvert 放在一起并启动即可。转换后的模组显示为 <name>-ornithe.jar;原始文件安全地归档在 config/retroconvert/originals/ 中。
  • 深度转换 重写类字节码、mixin 注解(包括无 refmap 的字符串目标)、refmap JSON、访问宽化器(access wideners)、fabric.mod.json、用于反射的字符串常量,以及嵌套 jar-in-jar 模组,递归处理。
  • 无可见重启 转换完成后,Fabric Loader 会在同一个 JVM 内针对转换后的模组文件夹重新启动。游戏直接启动,无明显中断。
  • 智能检测 已经移植到 Ornithe 的模组会被保留原样不动,带有嵌套 jar 的大型模组(如 StationAPI)会按每个 jar 单独处理。
  • 官方构建替换 少数模组(StationAPI、GlassConfigAPI)改动过大,无法通过字节码重写完成适配;对于这些模组,会下载其官方 Ornithe 版本,而字节码转换仅作为离线回退方案。
  • 缓存机制 jar 文件以 SHA-256 哈希值作为键,因此在后续启动时只会扫描新文件。

使用方法

  1. 将 RetroConvert 安装到 Ornithe b1.7.3 实例的 mods 文件夹中。
  2. 将你的 Babric 模组添加到同一文件夹。
  3. 启动游戏。就这样。

可选:Java Agent 模式(零重启,即使是首次启动)

将此添加到你的 JVM 参数中(Prism Launcher:实例 → 设置 → Java → JVM 参数):

-javaagent:mods/retroconvert-1.0.1+mcb1.7.3.jar

这会在 Fabric Loader 扫描文件夹之前转换模组,完全不需要重启逻辑。同样的命令行适用于 Prism、MultiMC 和原版启动器上的所有实例。

无头模式(Headless usage)

在不启动游戏的情况下转换任意模组文件夹:

./gradlew runConverter --args="/path/to/.minecraft/mods"

限制

  • 仅支持 b1.7.3,这是由设计决定的,因为 Babric 仅针对 b1.7.3。
  • 如果某个 Babric 模组在依赖解析阶段失败,会在 RetroConvert 运行前崩溃;请手动移除该 jar 文件。
  • 不要将已归档的原始文件与其转换输出放在同一目录下,否则加载器会检测到两个具有相同 ID 的模组。

许可证与源代码

源代码、问题追踪器以及完整的技术细节可在 GitHub 上获取。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源