{"id":16876220,"url":"https://github.com/coolcat467/fix-lwjgl","last_synced_at":"2025-04-11T11:32:32.964Z","repository":{"id":103142728,"uuid":"483827717","full_name":"CoolCat467/fix-lwjgl","owner":"CoolCat467","description":"Fix which LWJGL (Light Weight Java Game Library) version is used in Minecraft for ARM devices","archived":false,"fork":false,"pushed_at":"2025-04-08T05:55:22.000Z","size":1723,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T06:30:37.905Z","etag":null,"topics":["coolcat467","linux","lwjgl","lwjgl2","lwjgl3","minecraft","minecraft-raspberry-pi","python-script","python3","raspberry-pi","raspberry-pi-4","wrapper-script"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CoolCat467.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-20T22:07:31.000Z","updated_at":"2025-04-08T05:55:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"b05af981-0180-48a1-819c-d89bc5a49e98","html_url":"https://github.com/CoolCat467/fix-lwjgl","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2Ffix-lwjgl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2Ffix-lwjgl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2Ffix-lwjgl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2Ffix-lwjgl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CoolCat467","download_url":"https://codeload.github.com/CoolCat467/fix-lwjgl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248384104,"owners_count":21094674,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coolcat467","linux","lwjgl","lwjgl2","lwjgl3","minecraft","minecraft-raspberry-pi","python-script","python3","raspberry-pi","raspberry-pi-4","wrapper-script"],"created_at":"2024-10-13T15:38:41.050Z","updated_at":"2025-04-11T11:32:32.943Z","avatar_url":"https://github.com/CoolCat467.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fix-lwjgl\nFix which LWJGL (Light Weight Java Game Library) version is used in Minecraft for ARM devices\n\n\u003c!-- BADGIE TIME --\u003e\n\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/CoolCat467/fix-lwjgl/main.svg)](https://results.pre-commit.ci/latest/github/CoolCat467/fix-lwjgl/main)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n[![code style: black](https://img.shields.io/badge/code_style-black-000000.svg)](https://github.com/psf/black)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\n\u003c!-- END BADGIE TIME --\u003e\n\n## Description\nThis script is a wrapper for launching Minecraft on devices that aren't properly\nsupported by Mojang, such as computers with ARM processors like the Raspberry Pi 3 and 4,\nas well as Apple's new M series chips.\nOn these devices, the wrong version of LWJGL is downloaded, preventing minecraft\nfrom launching properly. This program takes the arguments that would have been\nused to run Minecraft and rewrites a few details about LWJGL, pointing minecraft\nto use a user-specified folder as the LWJGL library path for the\nshared object files and in the case of LWJGL 3, changing the\njava class path information to use the correct files for your machine.\n\nBasically, it means minecraft works now!\n\n## Testing\nThis program has been tested successfully with [ATLauncher](https://github.com/ATLauncher/ATLauncher)\non a Raspberry Pi 4 running 64 bit Raspberry Pi OS bullseye. It should work\nfor 32 bit Raspberry Pi OS bullseye, but I have not tested that yet.\n\n## Success testimonials\nThe following ARM64 platforms have run Minecraft successfully with this script:\n- M3 Mac with macOS - [Eagle3820](https://github.com/Eagle3820)\n- [Orange Pi 5](http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/details/Orange-Pi-5.html) with Ubuntu - [Lolmc0587](https://github.com/Lolmc0587)\n- M2 Max Mac with [Asahi Fedora Remix](https://asahilinux.org/fedora/) - [agouin](https://github.com/agouin)\n\n\nThis script might also work other platforms with arm processors, but may require minor changes.\n\nIf possible, if this script works on anything not listed as tested, please\ntell me using [the discussions page](https://github.com/CoolCat467/fix-lwjgl/discussions/1)!\n\n## Installation\nEnsure Python 3 is installed on your computer, and use pip to\ninstall this project with the command listed below:\n\n```\npip install git+https://github.com/CoolCat467/fix-lwjgl.git\n```\n\n#### Installation on MacOS\nIf you are using MacOS, you will probably have to install [homebrew](https://brew.sh/) to install [pipx](https://pipx.pypa.io/latest/installation/)\n(use the links given, not copying their install instructions here because they will get out of date).\n\nAfter pipx is installed, you can use the following command to install:\n\n```\npipx install git+https://github.com/CoolCat467/fix-lwjgl.git\n```\n\n## About Installation\nOn default, all LWJGL files are expected to be in\n`$HOME/.local/share/fix_lwjgl/lwjgl_{lwjgl_version}{system_arch}`, so\nif the script was run on Raspberry Pi OS 32 bit, it would be `lwjgl_3arm32`. If this\nfolder does not exist or files are missing (only checks in LWJGL 3 mode), the folder\nis created and all required files are downloaded from https://build.lwjgl.org/\n(browse at https://www.lwjgl.org/browse) (see also `can_download` in configuration)\n\nIf this script needs the LWJGL 2 folder, it will download the folders in this repository.\nIf this script needs any LWJGL 3 modules, it will download them from LWJGL's build repository\navailable to browse at https://www.lwjgl.org/browse\n\n## Configuration\nAll configuration files should be located in `~/.config/fix_lwjgl/fix_lwjgl_config.ini`. The current options\nas of writing include:\n- `lwjgl_base_path` - Controls where the lwjgl folders are expected to live at (defaults to `$HOME/.local/share/fix_lwjgl`)\n- `can_download` - If the wrapper is allowed to download files from the internet (defaults to True)\n- `download_timeout` - Timeout in seconds for downloading files from the internet (defaults to 15 seconds)\n\n## Usage\nGo to your Minecraft launcher, and somewhere in settings is likely the ability to\nset a \"wrapper command\". Set it to `fix_lwjgl_wrapper` after you install the script\nand everything *should* be good.\n\nOn Raspberry Pi OS bullseye and some other platforms, it might be useful to have this\n\"pre-launch\" command if you are experiencing crashes:\n\n```bash\nexport MESA_GL_VERSION_OVERRIDE=4.2COMPAT\n```\n\nThis tells mesa gl to pretend it's OpenGL 4.2, which stops Minecraft from trying to do\nsome things that might cause crashes.\n\nYou might also want to try changing it from `4.2COMPAT` to `4.3` or `4.5`, this is known to fix the\n[\"Could not initialize class com.mojang.blaze3d.systems.RenderSystem\" issue](https://github.com/CoolCat467/fix-lwjgl/issues/30)\n\n## Problems\nIf you encounter any issues regarding this program, please check and see if anyone else is\nhaving the same issue before making a new issue.\nWhen posting your issue, be sure to include any relevant logs and what operating system\nyou're using and what architecture your computer's processor uses.\n\nAdditionally, re-running Minecraft with the additional arguments\n```\n-Dorg.lwjgl.util.DebugLoader=true -Dorg.lwjgl.util.Debug=true\n```\nmight help diagnose your issue. Just be sure to remove them after everything is\nfixed, because OpenGL errors cause crashes in debug mode instead of just being silently\nignored.\n\n\n### Links\n* Source Code - https://github.com/CoolCat467/fix-lwjgl.git\n* Issues      - https://github.com/CoolCat467/fix-lwjgl/issues\n\n### License\n-------\nCode and documentation are available according to the MIT License (see [LICENSE](https://github.com/CoolCat467/fix-lwjgl/blob/HEAD/LICENSE)).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoolcat467%2Ffix-lwjgl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoolcat467%2Ffix-lwjgl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoolcat467%2Ffix-lwjgl/lists"}