LWJGL3ify

The LWJGL3ify mod enables running Minecraft version 1.7.10 using the modern LWJGL3 library and current Java versions. The package includes the RetroFuturaBootstrap system, which provides flexible early-stage plugin loading.

Installation and Usage

To get started, simply place the main mod file in the mods/ folder and launch the game with Java 8 as usual. On first startup, a window will appear allowing you to select a modern Java version for relaunch and configure JVM settings. If the window doesn't appear, install a modern Java version (versions 17 and 21 are recommended) from your preferred provider.

Settings and Configuration

After the first launch, a configuration file will appear in the config/lwjgl3ify.cfg folder where you can adjust window parameters, mouse input mode, OpenGL context properties, and other advanced options. Mod settings are also available directly in-game through the mod menu.

Compatibility

Although the mod aims for maximum compatibility, some mods may not work correctly. If you encounter issues, check the list of known problems and if necessary create a report with crash information, game logs, and description of malfunctions.

Server Installation

First install a working Forge server version. Then place the mod files (including unimixins, hodgepodge and gtnhlib if needed) in the mods/ folder. Download the forgePatches.jar file and place it in the same folder as the forge-universal and minecraft server jars. Thermos/Crucible/Hybrid servers are not supported!

Rename forgePatches.jar to lwjgl3ify-forgePatches.jar. Take the java9args.txt file from the mod's source code. You can now launch the server using the command:

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

Technical Features

The mod implements several key components for working with modern Java versions and LWJGL:

• Game relaunch system for modifying library lists
• Custom server launcher with updated manifest
• Java 9+ compatibility through RetroFuturaBootstrap
• Automatically generated shims for redirecting LWJGL2 calls to LWJGL3
• Numerous ASM transformers and mixins for ensuring compatibility
• Forge patches that load before main classes
• Performance optimizations through LWJGL3 features

The mod includes improved image loaders based on STB_image and accelerated texture stitching via STB_rectpack, significantly enhancing performance when working with large numbers of textures.