Skip to content

Commit

Permalink
Add info about success on MacOS
Browse files Browse the repository at this point in the history
@Eagle3820 had success with this script on MacOS!
See #1 (comment)
  • Loading branch information
CoolCat467 authored May 3, 2024
1 parent 05faf79 commit 82c02e2
Showing 1 changed file with 26 additions and 7 deletions.
33 changes: 26 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ Fix LWJGL (Light Weight Java Game Library) version used in Minecraft for ARM dev

## Description
This script is a wrapper for launching Minecraft on devices that aren't properly
supported by Mojang, such as computers with ARM processors like the Raspberry Pi 3 and 4.
supported by Mojang, such as computers with ARM processors like the Raspberry Pi 3 and 4,
as well as Apple's new M series chips.
On these devices, the wrong version of LWJGL is downloaded, preventing minecraft
from launching properly. This program takes the arguments that would have been
used to run Minecraft and rewrites a few details about LWJGL, pointing minecraft
Expand All @@ -27,11 +28,12 @@ This program has been tested successfully with [ATLauncher](https://github.com/A
on a Raspberry Pi 4 running 64 bit Raspberry Pi OS bullseye. It should work
for 32 bit Raspberry Pi OS bullseye, but I have not tested that yet.

This *might* work on the new Apple M1 chips, as they are arm64 processors,
but this is unlikely without changes. I have not tested this either.
Eagle3820 has successfully gotten this script working on an M3 Mac!

This script might also work other platforms with arm processors, but may require minor changes.

If possible, if this script works on anything not listed as tested, please
tell me using [discussions](https://github.com/CoolCat467/fix-lwjgl/discussions).
tell me using [the discussions page](https://github.com/CoolCat467/fix-lwjgl/discussions/1)!

## Installation
Ensure Python 3 is installed on your computer, and use pip to
Expand All @@ -41,6 +43,18 @@ install this project with the command listed below:
pip install git+https://github.com/CoolCat467/fix-lwjgl.git
```

#### Installation on MacOS
If you are using MacOS will probably have to install [homebrew](https://brew.sh/) and
use homebrew to install [pipx](https://pipx.pypa.io/latest/installation/)
(use the links given, not copying their install instructions here because they will get out of date).

After pipx is installed, you can use the following command to install:

```bash
pipx install git+https://github.com/CoolCat467/fix-lwjgl.git
```

## About Installation
On default, all LWJGL files are expected to be in
`$HOME/.local/share/fix_lwjgl/lwjgl_{lwjgl_version}{system_arch}`, so
if the script was run on Raspberry Pi OS 32 bit, it would be `lwjgl_3arm32`. If this
Expand All @@ -54,7 +68,7 @@ available to browse at https://www.lwjgl.org/browse

## Configuration
All configuration files should be located in `~/.config/fix_lwjgl/`. The current options
include:
as of writing include:
- `lwjgl_base_path` - Changing where the lwjgl folders are expected to live at (defaults to `$HOME/.local/share/fix_lwjgl`)
- `can_download` - If the wrapper is allowed to download files from the internet (defaults to True)
- `download_timeout` - Timeout in seconds for downloading files from the internet
Expand All @@ -64,14 +78,19 @@ Go to your Minecraft launcher, and somewhere in settings is likely the ability t
set a "wrapper command". Set it to `fix_lwjgl_wrapper` after you install the script
and everything *should* be good.

On Raspberry Pi OS bullseye in particular, it might be useful to have this "pre-launch"
command if you are experiencing crashes:
On Raspberry Pi OS bullseye and some other platforms, it might be useful to have this
"pre-launch" command if you are experiencing crashes:

```bash
export MESA_GL_VERSION_OVERRIDE=4.2COMPAT
```

This tells mesa gl to pretend it's OpenGL 4.2, which stops Minecraft from trying to do
some things that might cause crashes.

You might also want to try using `4.3` or `4.5`, this is known to fix the
[`Could not initialize class com.mojang.blaze3d.systems.RenderSystem` issue](https://github.com/CoolCat467/fix-lwjgl/issues/30)

## Problems
If you encounter any issues regarding this program, please check and see if anyone else is
having the same issue before making a new issue.
Expand Down

0 comments on commit 82c02e2

Please sign in to comment.