Retromod

Retromod

Retromod 是一个 Minecraft 模组，允许你在新版本上运行旧版模组。

管理

Retromod预览查看大图

Retromod

wakatime

由 Bownlux 制作，是 RevivalSMP.net 团队的一员。

自动在新版 Minecraft 上运行旧版模组。 将 Retromod 放入 mods/ 文件夹，把你的旧模组放进 retromod-input/，然后启动游戏。它会在运行时重写旧模组的字节码，使其能在当前 Minecraft 版本上加载。

  • 加载器： Fabric、NeoForge、Forge
  • 可转换的模组来源： Minecraft 1.12.2 及以上版本
  • 运行环境： Minecraft 1.20 至 26.2
  • 当前稳定版： 1.1.0（支持最新的 26.x 系列，包括 MC 26.2）
  • Fabric 上表现最佳（测试最多）；NeoForge 紧随其后；Forge 相对最不成熟
  • 兼容性数据库 和 问题反馈

在 MC 26.2 上，请使用 OpenGL 渲染器。 26.2 版本将 Vulkan 设为默认渲染器，这会破坏旧版模组的渲染功能。Retromod 会自动为你切换至 OpenGL（或者你也可以在视频设置→图形 API→OpenGL 中手动设置）。在 macOS 上几乎没有区别（因为它使用 Metal）。

功能说明

  • 自动将旧版模组转换至新版 Minecraft（MC 1.12.2 至 26.2）
  • 处理方法重命名、类移动、已移除的 API、损坏的 Mixin 以及版本范围拒绝问题
  • 备份原始文件；转换后的副本放置在 mods/ 文件夹中
  • 游戏内菜单（标题画面的齿轮图标）会显示对每个模组做了什么处理
  • 内置对 34+ 个流行模组和 API 的处理支持（JEI、REI、Cloth Config、Curios、GeckoLib、Architectury、Jade、Mod Menu 等）
  • 部分旧模组会被桥接到其现代等价版本：
旧模组 对应模组
Baubles Curios
NEI JEI
Thermal Expansion / RF Forge Energy
旧版 WAILA Jade

不适用于 深度集成的模组（如 Create、OptiFine、Tinkers、Applied Energistics 等）。这些模组替换了 Minecraft 的渲染机制或带有原生代码，任何自动化字节码工具都无法桥接。Retromod 适用于内容型、生活品质优化、配方查看器以及大多数"常规"模组。

支持的版本

你需要 MC 1.20 或更新版本 来运行 Retromod。它会将旧版模组从早期版本转换过来：

你的 Minecraft 版本 可转换的模组来源版本
Fabric 1.20 至 26.2 1.14+
NeoForge 1.20.1 至 26.2 1.20.1+
Forge 1.20 至 26.2 1.12.2+

主要重点是 MC 26.1+（首个非混淆 Minecraft）；旧版本仍然可以工作并获得所有核心修复。

使用方法

Fabric：

  1. 将与你的 MC 版本对应的 Retromod jar 文件放入 mods/ 文件夹。
  2. 启动游戏，然后关闭（这将创建 retromod-input/ 文件夹）。
  3. 将你的旧模组放入 retromod-input/ 文件夹。
  4. 再次启动游戏以进行转换，然后需要重启一次才能加载成功。

（两次启动是 Fabric 的一个特性：它会在任何模组（包括 Retromod）运行之前就检查模组版本。）

Forge / NeoForge：

  1. 将 Retromod 放入 mods/ 文件夹。
  2. 将你的旧模组放入 mods/ 文件夹（或 retromod-input/ 文件夹）。
  3. 启动游戏；如果有提示则重启。

可在服务器上使用，连接至装有 Retromod 的服务器的客户端本身不需要安装 Retromod。Quilt： 使用 Fabric 版本（Quilt 原生支持运行 Fabric 模组）。

常见问题

  • 它稳定/安全吗？ 是的。1.1.0 版本稳定，并且仅操作 Retromod 自身的文件夹。不过，像任何会修改文件的工具一样，建议保留备份。
  • OptiFine 呢？ 不太可靠。建议使用 Sodium（性能）、Iris（光影）、Continuity（连接纹理）、Zoomify（变焦）作为替代。
  • 某个模组功能失效了？ 即使某个 Hook 损坏，Retromod 也会让模组保持加载状态；只是那个单一功能会失效。支持范围会随着时间的推移而扩大。
  • 启动时崩溃？ 在 GitHub 上提交问题，并附上你的日志。大多数启动崩溃问题都是已知的，会得到针对性修复。
  • 低配电脑或内存不足？ 在你的启动器 JVM 参数中添加 -Dretromod.parallelism=2。
  • 模组作者希望排除在转换之外？ 在你的 jar 文件中添加一个空的 META-INF/retromod-opt-out 文件；Retromod 会原样复制它，不做任何修改。

完整的常见问题和详细信息：README。

卸载

  • Fabric： 从 mods/ 文件夹中移除 retromod-*.jar，然后删除 config/fabric_loader_dependencies.json。
  • Forge / NeoForge： 从 mods/ 文件夹中移除 retromod-*.jar。你的原始文件在 mods/retromod-backups/ 文件夹中。

用 Retromod 转换了一个模组？

在你的模组页面添加一个徽章（复制粘贴片段在 README 中）：

Translated with Retromod

相关链接

  • 源代码和问题反馈： github.com/Bownlux/Retromod
  • 许可证： MIT
  • 高级用户： 独立的命令行工具可以在游戏外转换模组。

由 Bownlux 制作，是 RevivalSMP.net 团队的一员。

Revival Worlds