lwjgl3ify

模组

· 作者 eigenraven

使用 LWJGL3 和现代 Java(17 及以上版本)运行 Minecraft 1.7.10

0 本站下载 0 关注 更新于 2 周前

需要前置:UniMixins

最新 3.1.0 · 1.7.10 · Forge

一键开服(送7天)

LWJGL3ify

将 LWJGL3 和现代 Java 版本引入 Minecraft 1.7.10。捆绑了 RetroFuturaBootstrap 作为灵活的早期加载插件系统。

使用方法:只需确保主 jar 文件位于 mods/ 目录中,并按常规配置使用 Java 8 启动即可。在启动时,应会出现一个窗口,提示你选择一个现代 Java 版本以重新启动,并配置该 Java 安装的 JVM 设置。如果未出现此类窗口,请从你偏好的供应商处下载并安装现代 Java 版本,目前推荐使用的版本为 Java 17 和 21。

兼容性

尽管该模组力求实现最大程度的兼容,但仍会有一些模组目前无法与 lwjgl3ify 配合使用。请检查我们的问题追踪器(issue tracker)是否已列出相关问题;若未列出,请提交一个新的 issue,附上崩溃报告(如有)、游戏日志以及关于具体无法正常运作部分的说明。

调整配置

如果你想调整窗口选项、原始鼠标输入、OpenGL 上下文属性或其他更高级的设置,请在首次启动后查看 config/lwjgl3ify.cfg 中的配置文件,或在游戏内访问 lwjgl3ify Mod Options。

服务器安装

首先,通过整合包 zip 文件或 Forge 安装程序安装一个正常工作的 Forge 服务器。然后,将模组 jar 文件(以及按需的 unimixins、hodgepodge 和 gtnhlib)放入 mods/ 目录,并下载 forgePatches jar 文件。将 forgePatches jar 文件放置在与你的 forge-universal 和 minecraft server jar 文件相同的文件夹中。不支持 Thermos/Crucible/Hybrid 服务器!Lwjgl3ify 还依赖于 Unimixins。将 forgePatches jar 重命名为 lwjgl3ify-forgePatches.jar。从此模组的源代码中获取 java9args.txt 文件。现在你可以使用如下命令启动服务器(假设 PATH 中的第一个 java 可执行文件是 java 17/21 或更高版本):

java -Xmx6G -Xms6G @java9args.txt -jar lwjgl3ify-forgePatches.jar nogui

它是如何工作的?(非常技术性的细节)

在旧版 Minecraft 版本上启用现代 Java 和 LWJGL 涉及几个组件,lwjgl3ify 专门实现了以下部分:

  • 一个游戏重新启动器,用于修改加载到 Java 类路径中的库列表——以安装 LWJGL3 以及我们包含 ASM 9 或新版 Apache Commons 等库的 forgePatches jar。
  • 一个自定义服务器启动器 jar,其中包含经过修改的 Class-Path META-INF 清单条目(已集成到我们提供的 forgePatches jar 中)。
  • 一个自由开源的 launchwrapper 替代品,具备 Java 9+ 兼容的类路径发现机制和更广泛的转换器能力,详见 。
  • 大量用于 JVM 的 add-opens 标志,以允许对 JVM 内部进行反射操作。遗憾的是,许多库和模组依赖于此才能正常运行,甚至包括像 Netty 这样奇怪的库(例如 java.text 或 nio 内部实现)。
  • 一个部分自动生成的兼容性垫片,将 lwjgl2 API 调用重定向至对应的 lwjgl3 调用(位于 src/main/java/org/lwjglx、src/generated/java/org/lwjglx),生成器代码在 src/util/java 中。
  • 虚拟的 org/lwjgl/* 类,用于匹配从 lwjgl3 中移除的类(例如 Display),以便那些依赖在类路径中该位置找到这些类的模组能够正常工作——例如用于 mixin 元数据。
  • 崩溃报告用 GL 厂商信息提供程序的替换方案,旧版本如果在没有有效 OpenGL 上下文的线程中使用会导致 JVM 崩溃。
  • ASM 转换器:
    • 在所有其他转换完成后,将任何对 org/lwjgl 的访问重命名为 org/lwjglx 的 ASM 转换器——位于 LwjglRedirectTransformer.java。
    • javax/xml/bind -> jakarta/xml/bind/ 的 ASM 转换器以及 jakarta.xml.bind 的阴影版本(shaded version),因为该 API 已从 JRE 11 中移除。
    • 可扩展枚举转换器(从 Minecraft 1.19.3 的 Forge 复制并采用 LGPL 许可证),用于替换大量的 EnumHelper 用法。
    • Object holders unfinalizer,用于移除在 Forge 中覆盖 static final 字段的需求。
    • FixConstantPoolInterfaceMethodRefHelper 是一个转换器,用于修复 javac 8/asm 5.0 reobfuscator 的一个 bug:当使用接口方法的 MethodHandle 时,它会在常量池中生成错误的条目。
  • Mixins:
    • Object holder 修改,使其不再写入 static final 字段。
    • JarDiscoverer 更改为忽略 module-info.class 和 META-INF/versions/* 类,因为它不具备 Java 9 感知能力。
    • PostMixinTransformInjector,用于将我们的 ASM 转换器移至 mixin 处理之后运行。
  • 来自 Modern Forge 的 UnsafeHacks 类,经过修改以适用于更多用例,用于在某些无法轻易移除 final 的情况下替换一些 static final 写入操作。
  • Forge 补丁,这些是 Forge 中被修改的类,由于它们加载过早而无法通过常规方式转换——因此我们在类路径中先于 Forge 加载一个 forgePatches jar 来替换它们:
    • EventSubscriptionTransformer:子类注解描述符的格式在 Java 17 中略有变化,此补丁使注解发现同时兼容新旧格式。
    • TerminalTransformer:修改以接受比 asm5 支持更新的 classfiles。
    • ClassPatchManager:将 Pack200 实现切换为 Apache Commons Compress,因为后者已从较新的 JDK 中移除。
    • TracingPrintStream:commons-compress 会关闭 System.out,此补丁阻止这种情况发生。
    • CoreModManager:解决系统类加载器不再是 URLClassLoader 的问题。
    • FMLSecurityManager:修复一些数组索引越界异常;它在 Java 17 中已被弃用,待新 API 可用后需要被替换。
    • EnumHelper:使用基于可扩展枚举转换器和 UnsafeHacks 的新变体替换所有 EnumHelper API。
  • 利用 LWJGL3 特性的额外性能增强 mixins:
    • 基于 STB_image 的图像加载器,比 Image4J 快得多。
    • 基于 STB_rectpack 的纹理拼接器,面对数万个纹理时几乎是瞬间完成,而原版代码拼接如此多的纹理到一张图集上则需要数秒时间。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源