Download and Install

You can directly download from this site to get the latest SJMCL release. This page will prioritize files suitable for your current device. You can also visit GitHub Releases to view all historical versions (including Nightly builds).

Supported Platforms

Platform	System Requirement	Supported Architectures	Available Package / Distribution Formats
Windows	Windows 7 or later	aarch64, i686, x86_64	Installer .exe, Portable .exe
macOS	macOS 10.15 or later	aarch64, x86_64	.app, .dmg
Linux	webkit2gtk 4.1 (for example, Ubuntu 22.04)	aarch64, x86_64	.deb, .rpm, Portable binary

TIP

Some features may be limited by platform or package type.

On Windows, the Portable version is recommended. On macOS, the DMG version is recommended. This gives you full functionality and a workflow closer to typical Minecraft launcher usage.

Special Note (Windows 7)

If you need to run SJMCL on Windows 7, please download Microsoft Edge WebView2 Runtime and install it first. The "Evergreen Bootstrapper" is recommended.

Install from Command Line

winget install SJMC.SJMCL

Winget

SJMCL provides a Windows Package Manager package with the package ID SJMC.SJMCL.

This method is suitable for Windows 10/11:

winget install SJMC.SJMCL

WARNING

The Winget index is publicly maintained. Before installing, consider running winget show SJMC.SJMCL to inspect the installer URL, and make sure the download source is from github.com/UNIkeEN/SJMCL or sjmcl.club.

If you need to run SJMCL on Windows 7, still refer to the WebView2 special note above.

Homebrew (macOS)

SJMCL provides a macOS Homebrew Cask named sjmcl.

brew install --cask SJMC-Dev/SJMCL/sjmcl

Install Script (Linux)

The install script currently supports Linux only. It detects x86_64 and aarch64 automatically and installs the latest stable release by default.

The command shown above uses the SJMC source by default, which is recommended for users in mainland China:

curl -LsSf https://mc.sjtu.cn/sjmcl/releases/install.sh | sh -s -- --source sjmc

If --source is not specified, the script will automatically select an installation source.

If you do not want to install through the system package manager, you can install the user-level portable version:

curl -LsSf https://mc.sjtu.cn/sjmcl/releases/install.sh | sh -s -- --portable

The portable version is installed to ~/.sjmcl/SJMCL, and the script creates ~/.local/bin/sjmcl as the command entry. This mode does not require root privileges.

Arch User Repository (AUR)

SJMCL is available on Arch User Repository (AUR), package name: sjmcl-bin.

This method is suitable for Arch Linux and Arch-based distributions.

Install with a common AUR helper (such as yay):

yay -S sjmcl-bin

Manual installation without an AUR helper:

git clone https://aur.archlinux.org/sjmcl-bin.git
cd sjmcl-bin
makepkg -si

Snap

SJMCL is available on Snap Store, package name: sjmcl.

This method is suitable for Linux distributions with Snap Store enabled:

sudo snap install sjmcl

NOTE

Due to Snap sandboxing, some SJMCL features may not work as expected. If you run into issues, please report them in GitHub Issues and include logs, screenshots, and reproduction steps when possible.

WARNING

When installed via Snap, game data may be stored inside the sandbox directory by default. Before uninstalling the launcher, back up important saves, resource packs, mods, and other data.

FAQ

TBD

Troubleshooting

Linux: Gdk-Message: Error 71 (Protocol error) dispatching to Wayland display.

This is an upstream issue, which usually occurs when using Wayland with an NVIDIA discrete GPU.

Please add the environment variable __NV_DISABLE_EXPLICIT_SYNC=1 or WEBKIT_DISABLE_DMABUF_RENDERER=1.