Retromod

Retromod

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

杂项

Retromod

在新版 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 上则无影响。

功能说明

  • 自动将旧模组转换至新 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
Old 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（缩放）。
  • 模组功能失效了？ 即使某个钩子损坏，Retromod 也会保持模组加载；该单一功能会变为惰性状态。覆盖范围会随时间增长。
  • 启动时崩溃？ 请附上日志在 GitHub 上提交问题。大部分启动崩溃是已知的，会获得针对性修复。
  • 电脑慢或内存低？ 在启动器的 JVM 参数中添加 -Dretromod.parallelism=2。
  • 我是模组作者，想退出？ 在你的 jar 中添加一个空的 META-INF/retromod-opt-out 文件，Retromod 会原样复制它，不进行转换。

完整 FAQ 与详情：https://github.com/Bownlux/Retromod#readme

卸载方法

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

用 Retromod 转换了一个模组？

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

Translated with Retromod

链接

- 许可证： MIT

由 Bownlux 制作，他是 https://revivalsmp.net/ 团队的一员。

Revival Worlds