Skip to content

Install ​

Where to download ​

Everything lives on the official site:

text
https://tml.tywmc.cn/#download

The page detects your platform; you can also switch platform, architecture and channel manually. Every file lists its SHA-256 so you can verify it.

Official builds vs self-compiled builds

Official builds carry the server address (notices, updates, beta). Packages you compile yourself ship without any server address and work offline only.

Windows ​

  1. Download TYW Launcher.exe (stable, snapshot and beta are separate files).
  2. Put it in a directory you can write to — not C:\Program Files.
  3. Run it. The first launch asks for a data directory.

.NET Framework 4.8 ships with Windows 10 1809 and later; nothing to install. Windows 7 is not supported.

Uninstalling: delete the exe and the PCL directory. The only leftover is HKCU\Software\PCLDebug (notice fingerprints).

Linux ​

Check your architecture first:

bash
uname -m
# x86_64        → grab the linux-x64 package
# aarch64/arm64 → grab the linux-arm64 package

The package is self-contained — no .NET runtime required — but it links against the usual desktop libraries (X11, fontconfig, OpenGL). What you install depends on the distribution.

Generic steps (any distribution) ​

bash
mkdir -p ~/apps/tyw
tar -xzf TYWLauncher-linux-x64.tar.gz -C ~/apps/tyw   # use TYWLauncher-linux-arm64.tar.gz on arm64
chmod +x ~/apps/tyw/TYWLauncher
~/apps/tyw/TYWLauncher

After extracting you should see TYWLauncher, Assets/ and a pile of .dll files. The first run asks for a data directory (defaults to ~/PCL).

Uninstalling: delete ~/apps/tyw and the data directory.

Debian / Ubuntu / Linux Mint / Deepin ​

bash
sudo apt update
sudo apt install -y libx11-6 libice6 libsm6 libfontconfig1 libgl1 libxi6 libxrandr2

Ubuntu 20.04+ and Debian 11+ are fine. Anything older ships a glibc that is too old to start.

Fedora / RHEL / CentOS Stream / Rocky / AlmaLinux ​

bash
sudo dnf install -y libX11 libICE libSM fontconfig mesa-libGL libXi libXrandr

CentOS 7 and older are not supported (glibc too old).

Arch / Manjaro / EndeavourOS / CachyOS ​

bash
sudo pacman -S --needed libx11 libice libsm fontconfig mesa libxi libxrandr

openSUSE Tumbleweed / Leap ​

bash
sudo zypper install -y libX11-6 libICE6 libSM6 fontconfig Mesa-libGL1 libXi6 libXrandr2

Alpine and other musl distributions ​

There is no official musl build. Either try a glibc compatibility layer (gcompat) or build from source.

Wayland sessions ​

XWayland is used automatically and usually needs no setup. If your install is minimal and lacks it:

bash
# Debian / Ubuntu
sudo apt install -y xwayland
# Fedora
sudo dnf install -y xorg-x11-server-Xwayland
# Arch
sudo pacman -S xorg-xwayland

Headless servers (plain SSH) ​

The launcher is a GUI application and needs an X display; over a bare SSH session it will fail with "cannot open display". Use X11 forwarding (ssh -X) or VNC / remote desktop. It does not run headless.

Add a desktop entry (optional) ​

bash
mkdir -p ~/.local/share/applications
cat > ~/.local/share/applications/tyw-launcher.desktop <<'EOF'
[Desktop Entry]
Type=Application
Name=TYW Launcher
Exec=/home/YOUR_NAME/apps/tyw/TYWLauncher
Terminal=false
Categories=Game;
EOF

Replace Exec with your real path.

macOS ​

Download .dmg or .zip and move TYW Launcher.app to Applications.

bash
# if the zip build refuses to open
xattr -cr "/Applications/TYW Launcher.app"
  • Apple Silicon: arm64 package (ad-hoc signed).
  • Intel: x64 package.
  • "Unverified developer" → right click → Open, or allow it in System Settings → Privacy & Security.

Android ​

Install the .apk (Android 8.0+). Grant storage access on first run; Android 11+ asks for MANAGE_EXTERNAL_STORAGE.

You do not need to install Java. The launcher downloads the matching Android JRE (8 / 17 / 21 / 25) for your architecture, with direct links and mirror fallback.

Beta channel ​

  1. Open the stable build → Settings → Other → Launcher → enable beta.
  2. Enter the beta key issued by the administrator (bound to your device code).
  3. Restart; the channel switches to beta.

Beta has no auto-update: each launch pulls the latest package from the server. No server, no start. Untick the box to return to stable (or snapshot).

Verify a download ​

Windows:

powershell
Get-FileHash .\TYW Launcher.exe -Algorithm SHA256

Linux / macOS:

bash
sha256sum TYWLauncher-linux-x64.tar.gz