https://github.com/cacahuetesanssel/mclaunch
A Minecraft launcher that puts your Minecraft in a box ๐ฆ
https://github.com/cacahuetesanssel/mclaunch
avalonia fabric fabricmc forge launcher minecraft minecraft-launcher neoforge quiltmc wip
Last synced: 5 months ago
JSON representation
A Minecraft launcher that puts your Minecraft in a box ๐ฆ
- Host: GitHub
- URL: https://github.com/cacahuetesanssel/mclaunch
- Owner: CacahueteSansSel
- License: gpl-3.0
- Created: 2023-03-25T18:30:05.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-05-26T20:31:47.000Z (5 months ago)
- Last Synced: 2025-05-26T20:41:33.837Z (5 months ago)
- Topics: avalonia, fabric, fabricmc, forge, launcher, minecraft, minecraft-launcher, neoforge, quiltmc, wip
- Language: C#
- Homepage: https://mclaunch.cacahuete.dev/
- Size: 17.8 MB
- Stars: 9
- Watchers: 1
- Forks: 2
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/CacahueteSansSel/mcLaunch/actions/workflows/dotnet.yml)
> This project is in beta, some things just don't work or aren't implemented yet !
mcLaunch
The Minecraft launcher that puts your Minecraft in a box ๐ฆ
**mcLaunch** (pronounced **m-c-launch**, **[ษm si lษntส]**) is a new and modern Minecraft launcher focused on design, compatibility, and ease of use.
# Features
+ Launches every Minecraft version ๐
+ Supports Fabric, Forge, NeoForge and Quilt ๐
+ Installs mods, and import modpacks from both CurseForge and Modrinth ๐งฉ
+ Exports modpacks to a custom really small file format ๐ซ
# Install
## Windows x64
Download the installer [here](https://github.com/CacahueteSansSel/mcLaunch/releases/download/v0.1.1/mcLaunch.Installer.win64.exe) and follow the instructions. If you have any warning about "Windows protected your PC", ignore it. If you don't want to use the installer, download `mcLaunch-windows.zip` from [the latest release](https://github.com/CacahueteSansSel/mcLaunch/releases/latest), extract it in a folder, and run mcLaunch.exe from there.
## Linux x64
Download `mcLaunch-linux.zip` from [the latest release](https://github.com/CacahueteSansSel/mcLaunch/releases/latest) and extract it in a folder. You may need to mark the `mcLaunch` and the `mcLaunch.MinecraftGuard` files as executable before running mcLaunch.
# Build
Make sure to have the [**.NET 8.0 SDK**](https://dotnet.microsoft.com/en-us/download) installed, then clone the project.
Then, you can build and run the project :
```shell
$ cd mcLaunch
$ dotnet build
$ dotnet run
```
# About forking mcLaunch
If you fork mcLaunch and plan to create a derivative work out of it, you will need to do some changes :
+ You will need to remove every logos of mcLaunch and mentions of the mcLaunch name to replace with your own
+ You will need to replace the CurseForge API key and the Microsoft Azure App ID with your own created specifically for your derivative work
+ This derivative work will need to be open-source too, and with the same license, [according to it](LICENSE).
# Credits
Libraries used by the project :
+ [Avalonia](https://github.com/AvaloniaUI/Avalonia) (UI Library)
+ [ReactiveUI](https://github.com/reactiveui/ReactiveUI) (UI Library)
+ [Modrinth.Net](https://github.com/Zechiax/Modrinth.Net) (for Modrinth support in the launcher)
+ [CurseForge.NET](https://github.com/Raxdiam/CurseForge.NET) (for CurseForge support in the launcher)
+ [K4os.Compression.LZ4](https://github.com/MiloszKrajewski/K4os.Compression.LZ4) (compression, used by the Box Binary format)
+ [ReverseMarkdown](https://github.com/mysticmind/reversemarkdown-net) (to render mod pages)
+ [Markdown.Avalonia](https://github.com/whistyun/Markdown.Avalonia) (to render mod pages)
+ [SharpNBT](https://github.com/ForeverZer0/SharpNBT) (for reading world's level.dat files)
+ [Markdig](https://github.com/xoofx/markdig) (to render mod pages)
+ [Jdenticon-net](https://github.com/dmester/jdenticon-net) (for generating anonymized box icons)
+ [DiscordRichPresence](https://github.com/Lachee/discord-rpc-csharp) (for Discord Rich Presence)
+ [LibGit2Sharp](https://github.com/libgit2/libgit2sharp) (for Git integration in the build system)
+ [AsyncImageLoader.Avalonia](https://github.com/libgit2/libgit2sharp) (for loading and displaying remote images)
+ [Avalonia.AvaloniaEdit](https://github.com/AvaloniaUI/AvaloniaEdit/?tab=readme-ov-file)
This project takes huge inspiration of :
+ [portablemc](https://github.com/mindstorm38/portablemc) (general Minecraft launcher stuff + basis of the new Forge installer code)