https://github.com/echoellet/kraft-launcher
An unofficial, open-source launcher for Minecraft Java that provides profile isolation, seamless profile sharing with other players, and installing mods with ease.
https://github.com/echoellet/kraft-launcher
kraftlauncher minecraft minecraft-launcher minecraft-mods modpacks
Last synced: about 1 year ago
JSON representation
An unofficial, open-source launcher for Minecraft Java that provides profile isolation, seamless profile sharing with other players, and installing mods with ease.
- Host: GitHub
- URL: https://github.com/echoellet/kraft-launcher
- Owner: EchoEllet
- License: mit
- Created: 2025-05-01T09:03:34.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-07T13:48:00.000Z (about 1 year ago)
- Last Synced: 2025-05-07T13:56:52.028Z (about 1 year ago)
- Topics: kraftlauncher, minecraft, minecraft-launcher, minecraft-mods, modpacks
- Language: Dart
- Homepage:
- Size: 3.02 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Kraft Launcher
An unofficial, open-source launcher for [Minecraft Java](https://www.minecraft.net/en-us/store/minecraft-java-bedrock-edition-pc) that provides profile isolation, seamless profile sharing with other players, and installing mods with ease.
> [!NOTE]
> This project is in its early stages and not yet ready for general use. For updates and progress, see [#1](https://github.com/EchoEllet/kraft-launcher/issues/1).
**Kraft Launcher is not affiliated
with [Mojang](https://mojang.com/), [Microsoft](https://www.microsoft.com/), or any of their
subsidiaries.**
## 📖 About
**Kraft Launcher** addresses the same issue as [Kraft Sync](https://github.com/FreshKernel/kraft-sync) for sharing and syncing profiles (AKA instances). Due to limitations of the previous approach, a custom Minecraft launcher was developed to automate steps for a more user-friendly experience.
Our goal is to support standard features across most launchers while enabling players to share profiles with others. This includes mods, resource packs, data packs, shaders, configs, key binds, and more, all kept in sync with automatic updates.
## ✨ Features
* 🔄 **Account Switching**: Seamlessly switch between multiple Microsoft accounts.
* 📁 **Profile Isolation**: Each profile has its own data — separate mods, worlds, configs, and more.
* 🔗 **Profile Sharing & Syncing**: Effortlessly share complete profiles with others, including mods, resource packs, configs, key binds, Java version, Minecraft version, mod loader versions, and more.
* 🔧 **Customizable Syncing**: Choose which mods, resource packs, and configurations to sync, or exclude specific ones for a more personalized experience.
* 🗂️ **Profile Groups**: Organize your profiles using custom categories or labels.
* ☕ **Built-in Java Installer**: Automatically installs the right Java version per profile, cross-platform.
* 📦 **Modrinth + CurseForge Integration**: Install, update, and manage mods from both platforms.
* 🛠️ **Crash-Resistant**: View, copy, and share logs easily. Optionally upload to [mclo.gs](https://mclo.gs/) or similar services.
* 📥 **Import from Other Launchers**: Bring your instances and files from MultiMC or other launchers.
* 📰 **News Feed**: Get the latest Minecraft news right in the launcher.
* 🎨 **Modern UI**: Clean interface built with [Material Design 3](https://m3.material.io/), supporting dark/light themes, dynamic colors, and custom accents.
* ⚡ **Quick Play**: Automatically join a Minecraft server, world, or realm on launch.
> [!IMPORTANT]
> Currently, the project doesn't implement most of these features yet, they were added early in `README` as they are planned in [#1](https://github.com/EchoEllet/kraft-launcher/issues/1), once they are available, this note will be removed.
## 🛠️ Build from Source
Tap to show/hide build instructions
Ensure [Flutter](https://docs.flutter.dev/get-started/install) is installed, and then run:
```bash
git clone --depth 1 https://github.com/EchoEllet/kraft-launcher
cd kraft-launcher
flutter pub get
flutter build
```
Replace `` with `linux`, `macos` or `windows`.
## 🔄 Forks & Redistribution
If you plan to fork or redistribute this project, please follow these guidelines:
* Do not crack, pirate, or distribute builds that bypass Minecraft: Java Edition ownership checks. This is illegal and not supported. Offline mode is available, but users must own the game on at least one Microsoft account.
* Update all branding, including the launcher name, app IDs and assets:
* All static fields in [`ProjectInfoConstants`](./lib/common/constants/project_info_constants.dart) should be updated, including the app name.
* Update all files inside [assets/branding](./assets/branding). Also run `dart run flutter_launcher_icons:generate` to replace them in platform runners.
* The package name in `pubspec.yaml` and also the app id in the platform runners `linux`, `macos` and `windows`. Also refer to [Platform Runner Modifications](./docs/PLATFORM_RUNNER_MODIFICATIONS.md).
* Clearly state that your fork is not affiliated with or endorsed by **Kraft Launcher**.
* Replace all API keys with your own or use empty strings (`''`). This includes the [Microsoft Login Client ID](./lib/common/constants/microsoft_constants.dart) and the CurseForge API key.
This launcher depends on APIs and services that requires to accept the following terms and conditions:
- [Microsoft Identity Platform Terms of Use](https://docs.microsoft.com/en-us/legal/microsoft-identity-platform/terms-of-use)
- [Minecraft EULA and Usage Guidelines](https://www.minecraft.net/en-us/usage-guidelines)
- [CurseForge 3rd Party API Terms and Conditions](https://support.curseforge.com/en/support/solutions/articles/9000207405-curse-forge-3rd-party-api-terms-and-conditions)
## 🌱 Contributing
For contribution guidelines, please refer to the [Contributing Guide](./CONTRIBUTING.md).
## ⚠️ Disclaimer
> [!WARNING]
> **Kraft Launcher is NOT AN OFFICIAL MINECRAFT PRODUCT.
It is NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.**
## 📜 Acknowledgments
- The app icon was created with the assistance of a generative design tool.
- The following open-source launchers were referenced for implementing certain features:
- [PrismLauncher](https://github.com/PrismLauncher/PrismLauncher)
- [ATLauncher](https://github.com/ATLauncher/ATLauncher/)
- [Pencil](https://github.com/Dreta/Pencil)