Kaede

A Tauri-based Minecraft launcher written in TypeScript with a permission-based plugin system

English | Русский | Other languages?..

Introduction

I always loved the idea of applications (Tachiyomi) and games (Mindustry) having addons. The addition of features at runtime with one's own code, the modification of the UI to one's own liking, and the ability to use community-made plugins are so cool...

However, the existing Minecraft launchers lack a user plugin system. While it is questionable whether extensible launchers for Minecraft are even needed, I still decided to make this project, primarily for myself.

Demonstration

Screenshots of the launcher with or without user plugins.

---

Home page and a launched Minecraft instance with the HorizonUI mod by nokarin-dev

---

Home page with an expanded version dropdown

---

Kaede launched in Windows 7

---

More screenshots >>>

Details

---

Default state of the launcher with no plugins or themes

---

LiteLoader (by Mumfrey) 1.10.2 launched through Kaede

---

Instance creation page

---

Settings page (extensions tab)

---

The log viewer

---

Filters & Searching

---

Microsoft Sign-in in Windows 7

---

A custom plugin for the Multi-Window experience (each window adds 30 MB of RAM usage)

---

Note

Assets from Blue Archive are not included in the launcher and are used here to merely demonstrate customizability of Kaede.

This application is not affiliated with Yostar & NEXON Games.

All information and assets used are the property and copyright of the respective authors.

Installation

Support

System	Arch	Support
Windows 8.1+	x86_64	Full
macOS	arm64, x86_64	Full
Linux	x86_64	Full
Windows 7	x86_64	Partial

Stable Releases

Download Kaede from the GitHub Releases page. For Windows 7, see this file first.

Development builds

Please understand that these builds are not intended for most users. There may be bugs and other instabilities.

The development builds are available through:

• GitHub Actions (includes builds from pull requests opened by contributors).
• nightly.link (this link will always point only to the latest version of the nightly branch).

Prebuilt Development builds are provided for Linux, Windows, and macOS.

Community & Support

If you want to report a bug or suggest a feature, please open an issue in GitHub Issues.

Discord

Plans

Kaede is in early stages of development. Look at the plan to see more about this launcher >.<

Contributing

No prior Rust knowledge is needed to contribute to this project. Most of the code was written in TypeScript using the Tauri API. These files will help in contributing:

• README for TypeScript-related code (the most important one)
• README for Rust-related code
• Contributing Guidelines
• MultiMC Patch System
• Building from Source

In case you want to run this launcher with Wails or other backends, or if you want to contribute to the Browser/Wails versions, see the following files.

• README for Browser environment
• README for Wails mocks in TypeScript
• README for Wails backend

I also leave comments in the code.

For launcher plugins, themes, or translations:

• Making a Plugin
• Type Declarations for Plugins
• Making a Theme
• Translating the Launcher

Pull requests are welcome. AI code that impacts regular Tauri builds is not welcome; see AGENTS.md for more. For major changes, please open an issue first to discuss what you would like to change.

Building from Source

Details

Preparations

See Tauri v2 Prerequisites.

I also recommend installing bun.

Once you are ready, clone this repository:

git clone https://github.com/kaede-basement/kaede

Navigate to the cloned directory and install project dependencies:

bun install

Development

Run:

bun dev

Release

Run:

bun run build

License

Credits and AI Usage

Please refer to this file.