Legacy-lwjgl3

Main Features

This mod allows running older versions of Minecraft (pre-1.13) using the modern LWJGL 3 library instead of the outdated LWJGL 2. The mod solves compatibility issues and improves game performance on various systems.

Key Functions

• Replacement of LWJGL 2 with LWJGL 3 for older game versions
• Redirecting clipboard access through GLFW
• Automatic use of GLFW Wayland backend when possible
• Creation of .desktop file and icons in correct system folders
• Display of virtual cursor in game interfaces

Dependencies

The mod works optimally together with OSL but doesn't require it for basic functionality. OSL is only needed if resourcepack resource-overriding functionality is required.

Settings

For Wayland users, the virtual_mouse.export option is available. When set to true, the cursor is exported to the cursors folder in the instance directory. All cursor images, metadata, and a cursor.cursor file in cursor configuration format are created.

Compatibility

The mod is fully compatible with OptiFabric and shaders. Should work with most other mods for corresponding Minecraft versions. If incompatibility with any mod is detected, it's recommended to report it through the issue tracking system.

System Requirements

When running in a sandbox (for example, through Flatpak), it's necessary to allow Minecraft access to the following paths and programs:

Path Access (Wayland Only)

• $HOME/.local/share/applications/com.mojang.minecraft.desktop
• $HOME/.local/share/icons/hicolor/apps/{16x16, 32x32}/minecraft.png
• $HOME/.local/share/icons/<theme>/cursors/left_ptr
• $HOME/.icons/<theme>/cursors/left_ptr
• /usr/share/icons/<theme>/cursors/left_ptr

Program Access

• xdg-icon-resource (for updating the icon system)
• gsettings (for getting cursor theme and size information)

Developers

• gudenau (original Forge mod author)
• Zarzelcow (Legacyfabric port author)
• KDE visual design group (fallback cursor file from Breeze theme)