https://github.com/unikeen/sjmcl
🌟 A Minecraft launcher from @SJMC-Dev
https://github.com/unikeen/sjmcl
minecraft minecraft-launcher nextjs sjmc sjtu tauri tauri2
Last synced: about 1 month ago
JSON representation
🌟 A Minecraft launcher from @SJMC-Dev
- Host: GitHub
- URL: https://github.com/unikeen/sjmcl
- Owner: UNIkeEN
- License: gpl-3.0
- Created: 2024-11-22T08:33:00.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-19T04:35:07.000Z (about 2 months ago)
- Last Synced: 2026-04-19T05:26:46.940Z (about 2 months ago)
- Topics: minecraft, minecraft-launcher, nextjs, sjmc, sjtu, tauri, tauri2
- Language: TypeScript
- Homepage: https://mc.sjtu.cn/sjmcl
- Size: 54.4 MB
- Stars: 488
- Watchers: 2
- Forks: 66
- Open Issues: 112
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://github.com/UNIkeEN/SJMCL/blob/main/.github/workflows/test.yml)
[](https://deepwiki.com/UNIkeEN/SJMCL)
**English** · [简体中文](docs/README.zh-Hans.md) · [繁體中文](docs/README.zh-Hant.md)
## Features
* **Cross Platform**: Supports Windows 10/11, macOS and Linux.
* **Efficient Instance Management**: Supports multiple game directories and instances, allowing the management of all instance resources (such as saves, mods, resource packs, shaders, screenshots, etc.) and settings in one place.
* **Convenient Resource Download**: Supports downloading game clients, mod loaders, various game resources and modpacks from CurseForge and Modrinth.
* **Multi-Account System Support**: Built-in Microsoft login and third-party authentication server support, compatible with the OAuth login process proposed by the Yggdrasil Connect proposal.
* **External Service Collaboration**: Works with external webpages, applications, and Agent services through deeplinks and MCP services, delivering a range of convenient features and automation capabilities.
* **Open Extension System**: Supports extension development to extend the launcher with more interesting and practical features. [>> How to develop extensions](#developing-extensions)
> Note: some features may be limited by region, platform, or bundle type.
### Built with
[](https://tauri.app/)
[](https://nextjs.org/)
[](https://v2.chakra-ui.com/)
## Getting Started
Getting started with SJMCL is simple, just download the latest release from the [Official Website](https://mc.sjtu.cn/sjmcl/en/downloads).
You can also find all the releases, including the nightly versions, on [GitHub Releases](https://github.com/UNIkeEN/SJMCL/releases).
SJMCL currently supports the following platforms:
| Platform | Versions | Architectures | Provided Bundles |
|-----------|---------------------|----------------------------|-----------------------------------------|
| Windows | 7 and above | `aarch64`, `i686`, `x86_64`| installer `.exe`, portable `.exe` |
| macOS | 10.15 and above | `aarch64`, `x86_64` | `.app`, `.dmg` |
| Linux | webkit2gtk 4.1 (e.g., Ubuntu 22.04) | `aarch64`, `x86_64` | `.deb`, `.rpm`, portable binary |
To learn about how to use SJMCL’s features and browse frequently asked questions, please refer to the [User Documentation](https://mc.sjtu.cn/sjmcl/en/docs).
### Windows 7
If you need to run SJMCL on Windows 7, please first [download the Microsoft Edge WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download) and install it. We recommend choosing the 'Evergreen Bootstrapper'.
Install from Command Line
Arch Linux
SJMCL is available on the Arch User Repository (AUR). You can install it using a common [AUR helper](https://wiki.archlinux.org/title/AUR_helpers):
```bash
yay -S sjmcl-bin
```
Manual installation without an AUR helper:
```bash
git clone https://aur.archlinux.org/sjmcl-bin.git
cd sjmcl-bin
makepkg -si
```
## Development and Contributing
To get started, clone the repository and install the required dependencies:
```bash
git clone git@github.com:UNIkeEN/SJMCL.git
npm install
```
To run the project in development mode:
```bash
npm run tauri dev
```
We warmly invite contributions from everyone.
* Before you get started, please take a moment to review our [Contributing Guide](https://github.com/UNIkeEN/SJMCL/blob/main/CONTRIBUTING.md) (includes more details on the development workflow).
* API references and some developers’ insights can be found in the [Developer Documentation](https://mc.sjtu.cn/sjmcl/en/dev).
* Feel free to share your ideas through [Pull Requests](https://github.com/UNIkeEN/SJMCL/pulls) or [GitHub Issues](https://github.com/UNIkeEN/SJMCL/issues).
### Developing Extensions
If you want to develop extensions for SJMCL, check out the [Extension Documentation](https://mc.sjtu.cn/sjmcl/en/dev/extension/). It includes an introduction to the extension system and API references. We also provide a scaffold to help you quickly create a template project and get started.
### Repo Activity
## Copyright
Copyright © 2024-2026 SJMCL Team.
> NOT AN OFFICIAL MINECRAFT SERVICE. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
The software is distributed under [GNU General Public License v3.0](/LICENSE).
By GPLv3 License term 7, we require that when you distribute a modified version of the software, you must obey GPLv3 License as well as the following [additional terms](/LICENSE.EXTRA):
1. Use a different software name than SJMCL or SJMC Launcher;
2. Mark clearly in your repository README file, your distribution website or thread, Support documents, About Page in the software that your program is based on SJMCL and give out the url of the origin repository.
3. When your modifications to this software are limited solely to **adding** (without modifying or deleting) preset authentication servers (`src-tauri/src/account/helpers/authlib_injector/constants.rs`), the restrictions set forth in Clauses 1 above shall not apply. In this case, you may continue to compile and distribute the software under its original name.
Besides, per term of use of our website, when distributing a modified version of the software, please send version numbers with prefix (more than two letters, e.g. `XX-0.0.1`) to our statistics server (`src-tauri/src/utils/sys_info.rs`) unless your modifications meets Clauses 3 above.
## Contact Us
QQ Group for SJMCL Users: 860851380
You can also send email to [launcher@sjmc.club](mailto:launcher@sjmc.club) if you want to contact us.
## Community Partners
We sincerely thank the following organizations for their development and community support throughout the SJMCL project.
[
](https://mc.sjtu.cn/en/)
[
](https://www.suesmc.ltd/)
[
](https://www.mualliance.cn/en)
[
](https://space.bilibili.com/403097853)