修复菲斯克和纳什恩

修复菲斯克和纳什恩

在 Java 17+ 上通过将 Fisk 的 Superheroes 重定向至独立的 Nashorn 来运行它(lwjgl3ify),而不修改 Fisk 的 jar。

杂项

FiskNashornFix

在 Minecraft 1.7.10 上,配合 lwjgl3ify,在现代 Java(17 至 25)上运行 Fisk's Superheroes。

问题

Fisk's Superheroes 使用 Nashorn(Java 8 自带的 JavaScript 引擎)来运行其英雄包。Nashorn 在 Java 15 中被移除。当 1.7.10 整合包通过 lwjgl3ify 在现代 Java 上运行时,Fisk's Superheroes 会在模组加载期间崩溃:

Caused by: java.lang.IllegalStateException: Nashorn JavaScript engine == null
Caused by: java.lang.ClassNotFoundException: Class bytes are null for jdk.nashorn.api.scripting.NashornScriptEngineFactory

lwjgl3ify 可以重定向 Nashorn 类引用,但 Fisk 是按名称(以纯文本形式)加载 Nashorn 的,该重定向并不覆盖这种情况。

此模组的作用

FiskNashornFix 是一个小型 coremod,所有内容都打包在内部。它从不连接互联网。

  1. 在加载时将 Fisk 重定向到独立版 Nashorn。 当 Fisk 的类加载时,名称 jdk.nashorn.* 会被改写为 org.openjdk.nashorn.*(即独立版 OpenJDK Nashorn)。Fisk 的 jar 文件不会被修改。
  2. 在 jar 内附带独立版 Nashorn。 首次启动时,在 lwjgl3ify 以现代 Java 重启游戏之前,它会把捆绑的 Nashorn 15.7 和 ASM 9.11(官方、未经修改的 Maven Central 发行版)复制到实例的 lwjgl3ify-nashorn 文件夹中。每个文件都会对照固定的 SHA-1 哈希进行校验。
  3. 保持旧版 coremod 可用。 它会把五个旧版 ASM 类(Remapping*Adapter)从你安装的 lwjgl3ify jar 复制到 lwjgl3ify-nashorn-patch,这样仍在使用这些类的模组(例如 Entity Culling Unofficial)在 ASM 作为 Java 模块加载后依然可用。

在 Java 8 上它不会执行任何操作:Fisk 会继续使用 Java 8 内置的 Nashorn,因此保留安装是安全的。

要求

  • Minecraft 1.7.10 与 Forge 10.13.4.1614
  • Fisk's Superheroes 2.4.0
  • lwjgl3ify(relauncher 模式)和 UniMixins
  • Java 17 或更高版本(你整合包中的其他模组可能需要更高版本)

设置

将这些选项添加到 lwjgl3ify relauncher。

在“Lwjgl3ify settings”窗口中(游戏启动时显示):将它们粘贴到 Custom options 中,每行一个:

--module-path
lwjgl3ify-nashorn
--add-modules
org.openjdk.nashorn
--patch-module
org.objectweb.asm.commons=lwjgl3ify-nashorn-patch/asm-commons-legacy.jar

或在 config/lwjgl3ify-relauncher.json 中:

"customOptions": [
  "--module-path", "lwjgl3ify-nashorn",
  "--add-modules", "org.openjdk.nashorn",
  "--patch-module", "org.objectweb.asm.commons=lwjgl3ify-nashorn-patch/asm-commons-legacy.jar"
]

这些路径相对于实例文件夹,因此可在任何电脑上使用。

整合包作者: 请随整合包一起分发此配置文件(不要包含你个人的 javaInstallationsCache 条目)。你的玩家之后只需在 lwjgl3ify 窗口中选择他们的 Java 版本即可。

测试环境

  • Minecraft 1.7.10、Forge 10.13.4.1614
  • Fisk's Superheroes 2.4.0
  • lwjgl3ify 3.0.38、UniMixins 0.3.1
  • Windows 11 上的 Java 25.0.4(Eclipse Temurin)
  • 一个包含 139 个模组的整合包,包括 Beddium、FalseTweaks、Hodgepodge、ArchaicFix、Lumi 和 SwanSong

故障排除

  • “Nashorn JavaScript engine == null”:上述自定义选项缺失,或游戏未通过 lwjgl3ify 重启。
  • “Module org.openjdk.nashorn not found”,或选择 Java 后游戏无法启动:库无法复制(例如实例文件夹为只读)。在日志中查找 [FiskNashornFix] 行。
  • 文件损坏:删除 lwjgl3ify-nashorn 和 lwjgl3ify-nashorn-patch 文件夹;它们会在下次启动时重新创建。
  • 专用服务器:未测试。lwjgl3ify relauncher 仅适用于客户端;在服务器上,你需要通过自己的 JVM 参数提供 Nashorn。

卸载

删除 jar、三个自定义选项,以及 lwjgl3ify-nashorn 和 lwjgl3ify-nashorn-patch 文件夹。

致谢与许可

  • Fisk's Superheroes 由 FiskFille 制作。本项目与 Fisk's Superheroes 无关联,且不包含或再分发其任何文件。
  • lwjgl3ify 由 GTNewHorizons 制作。
  • 独立版 Nashorn 15.7 由 OpenJDK 制作,采用 GPL v2 及 Classpath Exception 许可。以未经修改的方式捆绑,附带其许可证(META-INF/LICENSE_Nashorn.txt)及其完整源代码(fisknashornfix/libs/nashorn-core-15.7-sources.jar)。
  • ASM 9.11 由 OW2 制作,采用 BSD 3-Clause 许可。以未经修改的方式捆绑,附带其许可证(META-INF/LICENSE_ASM.txt)。
  • FiskNashornFix 自身的代码以 MIT 许可发布。请参见 jar 中的 META-INF/THIRD_PARTY_NOTICES.txt。