FAQ
Java not found
Check Settings → Launch → Java first. If nothing is listed, point it to javaw.exe / java manually, or use "Download automatically".
The game closes right after launch
Open the log page and read the last 50 lines. Usually one of:
- Java version mismatch (1.17 needs 16, 1.20.5+ needs 21)
- Mod / loader mismatch
- Memory too low or absurdly high (2048–8192 MB is sane)
- Outdated GPU driver
Blank window or stuck loading
Delete the cache folder in the data directory and reopen. If it persists, check the newest file in logs/.
Downloads stuck at 0%
Switch the download source and make sure the system proxy is not blocking. Corporate or campus networks often need one.
Microsoft login says IP anomaly
The launcher already retried over a direct connection. Persistent failures are usually network-related.
Linux: missing .so files
Install libx11-6 libice6 libsm6 libfontconfig1 libgl1. Wayland goes through XWayland automatically.
macOS: unverified developer
Right click → Open, or allow it in System Settings → Privacy & Security:
xattr -cr "/Applications/TYW Launcher.app"Apple Silicon crashes
Make sure you downloaded the arm64 package, not x64.
Android cannot read the game folder
Grant "All files access" to the launcher in system settings.
Bedrock does nothing
Check the Store build is installed and a Microsoft account is signed in. GDK packages are download-only.
How do I get a beta key
The administrator issues one per device code. Find your device code in Settings → Other → Launcher → Copy identifier.
I am banned
The dialog shows your device code and the reason (or "no reason provided"). Contact the administrator with that code.
Where are the logs
logs/ inside the data directory, named by date. Attach the newest one when reporting an issue.
Full uninstall
Delete the binary and the data directory. On Windows also remove HKCU\Software\PCLDebug.
