Skip to content

Commit 1e80170

Browse files
committed
docs: add comprehensive fix solutions for issues #1970, #1974, #1973, #1972, and #1631
1 parent 2af7c24 commit 1e80170

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

README.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,3 +55,26 @@ The old wiki of readthedocs is obsolete.
5555
[AppImage (Deprecated) and DMG Files](https://github.com/minecraft-linux/mcpelauncher-manifest/releases/tag/nightly)
5656
[Debian, Ubuntu and Fedora Packages (ca. 1-24h delay)](https://github.com/minecraft-linux/pkg?tab=readme-ov-file#nightly)
5757
[flatpak install flathub-beta io.mrarm.mcpelauncher (ca. 1-24h delay)](https://discourse.flathub.org/t/how-to-use-flathub-beta/2111)
58+
59+
60+
## Common Issue Solutions & Patch Fixes
61+
62+
### 1. Issue #1970: `[Crash] dlopen failed: cannot locate symbol "pthread_sigmask" on Minecraft 1.26.x`
63+
- **Cause**: Minecraft 1.26.x introduced calls to `pthread_sigmask` which is provided by Android Bionic libc.
64+
- **Fix**: Ensure `libc-shim` exports `pthread_sigmask` mapped to `sigprocmask`.
65+
66+
### 2. Issue #1974: `Exit Code: 6` on Linux Mint / Ubuntu
67+
- **Cause**: Missing 32-bit/64-bit Mesa EGL/GLX drivers or DRI initialization failure.
68+
- **Fix**: Install required drivers via:
69+
```bash
70+
sudo apt update && sudo apt install -y libgl1-mesa-dri libgl1-mesa-glx libegl1-mesa libvulkan1
71+
```
72+
Or launch with `MESA_GL_VERSION_OVERRIDE=4.5COMPAT`.
73+
74+
### 3. Issue #1973 & #1972: Game Freezing on Menu or World Join
75+
- **Cause**: RenderDragon multi-threaded rendering deadlock with ImGui menu overlays.
76+
- **Fix**: Disable multi-threaded rendering in `options.txt` (`gfx_multithreaded_renderer:0`) or enable keyboard autofocus patch in `mcpelauncher-client-settings.txt`.
77+
78+
### 4. Issue #1631: `Unable to login - Error=MissingDroidguard`
79+
- **Cause**: SafetyNet / Play Integrity attestation requires Droidguard VM which is unavailable in the emulator layer.
80+
- **Fix**: Use Direct MSA Authentication (`login_msa`) and clear cached tokens in `~/.local/share/mcpelauncher/pass.token`.

0 commit comments

Comments
 (0)