Emerald is a cross-platform Minecraft launcher built with Uno Platform and C#.
 |
 |
 |
 |
Legend: ✅ fully supported, 🟡 partially supported, ❌ not yet supported
| Capability | Status | Notes |
|---|---|---|
| Multi-instance Minecraft profiles | ✅ | Multiple game profiles are persisted and managed. |
| Custom profile folder names | ✅ | You can add more than one game into the same folder. |
| Version selection | ✅ | Supports all versions provided by Mojang |
| Global Minecraft settings | ✅ | File-backed global settings with autosave behavior. |
| Per-game settings overrides | ✅ | Profile-level override model is implemented. |
| Capability | Status | Notes |
|---|---|---|
| Vanilla | ✅ | Supported in launcher flow. |
| Fabric | ✅ | Routed via installer pipeline. |
| Forge | ✅ | Routed via installer pipeline. |
| Quilt | ✅ | Routed via installer pipeline. |
| OptiFine | 🟡 | Routed via installer pipeline. WIP |
| LiteLoader | ✅ | Routed via installer pipeline. |
| Capability | Status | Notes |
|---|---|---|
| Download Minecraft | ✅ | Downloads through offical Mojang servers, hash check available. |
| Launch Minecraft | ✅ | --- |
| Stop / force stop running game | ✅ | --- |
| Runtime session tracking | ✅ | Tracks state, PID, timestamps, and run status. |
| Live game logs | ✅ | Captures runtime output with a rich UI |
| Capability | Status | Notes |
|---|---|---|
| Microsoft account sign-in | ✅ | --- |
| Offline account support | ✅ | * |
We do not support piracy. You can't use Offline Accounts without logging in with at least one Microsoft Account.
If you wish to bypass it, it's your responsibility, and a toggle which you can change is hardcoded the project. But we will not ship any releases with it.
| Capability | Status | Notes |
|---|---|---|
| Mods | ✅ | --- |
| Shaders | ✅ | --- |
| Data Packs | ✅ | --- |
| Resource Packs | ✅ | --- |
| Plugins | ✅ | --- |
| Mods | 🟡 | WIP |
| Modrinth content browsing/details | 🟡 | Present, Does not exactly match/auto download versions |
| Modrinth install/remove tracking | 🟡 | Install/remove tracking exists; UX/workflow still evolving. |
Emerald is currently in its cross-platform Uno transition phase.
Nightly preview builds are distributed through GitHub Actions CI artifacts.
- Open CI Build & Artifacts.
- Select a recent successful run on
main. - Download the artifact for your platform:
Emerald-Windows-Signed-x64-arm64Emerald-macOS-arm64-appEmerald-linux-x64
Stable releases for the new cross-platform version will be available soon.
In the meantime, you can use nightly CI artifacts for the latest changes, or older tagged releases from GitHub Releases.
- Git
- .NET 10 SDK (preview channel supported)
Optional for local Windows packaging workflows:
- Visual Studio 2022 / Build Tools with Windows SDK components
git clone https://github.com/RiversideValley/Emerald
cd Emeralddotnet restore Emerald.slnx
dotnet build Emerald.slnxdotnet test Emerald.CoreX.Tests/Emerald.CoreX.Tests.csprojWindows packaged builds now use signed MSIX output.
- Setup and local publish instructions: docs/windows-signing.md
Maintained solution (Emerald.slnx):
Emerald/- Uno app shell, UI, pages, controls, and composition rootEmerald.CoreX/- launcher domain/runtime/services (accounts, installers, logging, settings)Emerald.CoreX.Tests/- active CoreX regression tests
Legacy projects (Emerald.App/, Emerald.Core/) are retained for history and are not the primary active architecture.
Copyright (c) 2022-2026 Riverside Valley Corporation
Licensed under the Nightshade Vexillum license as stated in LICENSE.md.
