MacOS LWJGL Fix
by foxirl
MacOS LWJGL Fix is a Fabric client-side utility that addresses a crash seen on macOS with newer LWJGL builds.
What it does
Players running the game on macOS can hit a crash when the LWJGL 3.3.0 library, or a later release, is in use. This mod targets that crash on the client, so only the player's installation needs it and servers run without it. Its single released file, 1.0.0, is built for 1.17.1, and the code is open source under the MIT License.
Key features
Crash prevention on macOS
Stops a crash that appears on macOS when the game runs LWJGL 3.3.0 or a later release.
Targets the LWJGL library
Works around the library's behavior on Apple systems rather than changing gameplay.
Single-purpose fix
Limits its scope to the one crash, so it adds no new blocks, items or commands.
Compatibility
Latest build for each game version and loader.
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
Shift-Scroll Fix for macOS is also a Fabric client-side mod released under the MIT License, covering 1.14 – 26.2. macOS Chat Fixes is a Fabric client-side mod under the GNU Lesser General Public License v3.0 only, published for 26.1 – 26.3, so it targets a different version range.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| MacOS LWJGL Fix | Fabric | 1.14 – 1.17.1 | Client-side only | 2025-08-14 |
| Shift-Scroll Fix for macOS | Fabric | 1.14 – 26.2 | Client-side only | 2024-06-19 |
| macOS Chat Fixes | Fabric | 26.1 – 26.3 | Client-side only | 2026-09-24 |
Questions
Does MacOS LWJGL Fix need to be on the server?
Which loader does MacOS LWJGL Fix use?
In the catalog
MacOS LWJGL Fix is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 4,181 mods support Minecraft 1.17.1.
More from foxirl
Similar mods
What the author says
Fixes a crash when using LWJGL 3.3.0+ on older versions on MacOS. The crash happens because Minecraft tries to set an app icon for Minecraft, which is unsupported on MacOS. Previously, this did nothing, but in LWJGL 3.3.0+, it causes a crash.
Official listing
- Modrinth page
- modrinth.com/mod/macos-lwjgl-fix
- Owner
- foxirl
- Published
- 2025-08-14
- Updated on Modrinth
- 2025-08-14
- Facts verified
- 2026-10-15
