天体非官方 2.0 修复

修复了Celestial 2.0的Forge版本崩溃问题

本模组修复了 NeoForge 1.21 上 Celestial 2.0 的严重崩溃问题,使 Forge/NeoForge 用户能够享受 Celestial 完整的天空自定义功能。

本修复解决的问题

由于 mixin refmap 映射不兼容,NeoForge 上的 Celestial 2.0 会在启动时崩溃。原模组的 refmap 使用 Fabric/Yarn 中间映射(field_20898、field_21327、field_21328 等),但 NeoForge 需要 Mojang 映射(poseStack、pose、normal 等)。

如果没有本修复,你会遇到:

  • 在 NeoForge 上启动 Celestial 2.0 时立即崩溃
  • 引用了缺失字段映射的 Mixin 应用失败
  • 无法在基于 Forge 的整合包中使用 Celestial 的天空自定义功能
  • 使用本修复后,Celestial 2.0 可在 NeoForge 1.21 上无缝运行,从而支持:
  • 天空中自定义的行星和星星
  • 天空与雾的颜色自定义
  • 自定义天空盒和动态天空
  • 基于资源包的配置(无需配置文件)
  • 与原版及模组维度完全兼容

技术细节

本修复通过添加包含正确 Mojang 映射名称的 searge 段来修补 Celestial-common-refmap.json,确保 mixin 转换能正确应用到 NeoForge 的混淆类上。未修改任何游戏玩法代码——仅修改了 NeoForge 兼容性所需的映射引用。

兼容性

  • Minecraft 版本:1.21
  • 模组加载器:NeoForge
  • 修复版本:Celestial 2.0

安装

只需将此模组添加到你的 mods 文件夹中。如果存在原始的损坏文件 celestial_1.21_neoforge-2.0.jar,请将其移除。

关于本分支

这是 fishcute 所制作 Celestial 的兼容性补丁。原作者允许重新上传和修复。本项目存在的唯一目的是在官方更新发布之前,为 NeoForge 用户提供一个可用的版本。