MONORYX is a desktop launcher for Minecraft: Java Edition. It runs as a native Rust binary using egui and eframe. The executable is 20 MB and idles at roughly 30 MB of memory.
- Separate instance folders: Each profile keeps its own mods, saves, configs, and screenshots in an isolated directory. It leaves your
.minecraftfolder untouched. - Modrinth and CurseForge support: Search projects, resolve required dependencies, and install
.mrpackmodpacks or individual mods from the UI. - Offline and Microsoft accounts: Authenticate through Microsoft OAuth device code flow (
microsoft.com/link) for Mojang servers, or pick an offline profile for singleplayer and LAN play. - Java management: Detects installed JREs on your system and downloads Adoptium Temurin runtimes when an instance needs a specific Java version.
- Launch tuning: Includes AppCDS class caching, Aikar GC flags, memory controls, and discrete GPU selection on Windows.
- Search Modrinth and CurseForge with version and loader filters.
- Install mods, resource packs, and shaders into your selected instance.
- Dependency resolution detects required libraries and warns on conflicting versions.
- The update scanner reads local jar hashes and Murmur2 fingerprints to check for new releases across both platforms.
- Supports Vanilla, Fabric, Quilt, NeoForge, and Forge.
- Set per-instance memory bounds, JVM flags, and Java paths.
- Export instances to portable
.ziparchives or import existing archives. - Assign custom icons and toggle Minecraft snapshots.
- Crash analyzer parses JVM logs and highlights failing mod IDs.
- Upload logs to mclo.gs with a single click.
- Create compressed backups of local worlds with a restore-as-copy option.
- View world metadata, seeds, and screenshots from the launcher.
- Discord Rich Presence shows your instance, playtime, and world or server name with per-item privacy toggles.
- Nexeu game panel integration connects to remote server consoles, monitors CPU and memory load, and triggers power actions.
- Companion updater (
monoryx-updater.exe) handles in-place updates.
- Download
MONORYX-Setup-1.4.0.exeor the portable zip from Releases. - Run the installer or extract the zip archive.
- Open MONORYX, set your username or log in with Microsoft, and select your memory limit.
- Click Create Instance, choose your Minecraft version and loader, then click Play.
For detailed setup steps and screenshots, read INSTALLATION.md.
- Rust 1.85 or newer
- Windows, Linux, or macOS
- C compiler toolchain (MSVC on Windows, GCC/Clang on Linux/macOS)
- Linux dependencies:
libssl-dev,pkg-config,libasound2-dev,libfontconfig1-dev
git clone https://github.com/DemonZ-Development/Monoryx.git
cd Monoryx
cargo check --all-targets
cargo test
cargo build --release --bin monoryxThe output binary is placed in:
- Windows:
target/release/monoryx.exe - Linux/macOS:
target/release/monoryx
To build the companion updater:
cargo build --release --bin monoryx-updaterMONORYX stores all files in an isolated data directory:
%APPDATA%/DemonZDevelopment/MONORYX/
├── config.toml # Launcher settings and account tokens
├── cache/ # Cached manifests, images, and API responses
├── minecraft/ # Assets, libraries, and client jars
├── java/ # Downloaded Temurin runtimes
├── instances/ # Game profiles
│ └── <instance-id>/
│ ├── instance.toml # Instance settings
│ ├── content.json # Installed mod index
│ └── game/ # mods, configs, saves, screenshots
└── logs/ # Launcher log files
src/
├── main.rs # Launcher entry point and UI loop
├── updater_main.rs # Standalone updater binary
├── account/ # Offline and Microsoft OAuth authentication
├── app/ # Application state, background tasks, AppCDS
├── config/ # Settings persistence
├── content/ # Installed mod tracking
├── curseforge.rs # CurseForge API and Murmur2 hashing
├── downloads/ # Chunked downloader with SHA verification
├── instance/ # Instance configuration, export, world backups
├── java/ # Java detection and Temurin downloads
├── loaders/ # Fabric, Quilt, NeoForge, Forge installers
├── minecraft/ # Manifest parser, launch arguments, crash analyzer
├── modrinth/ # Modrinth API, search, dependency resolution
├── nexeu.rs # Nexeu game server panel client
├── storage/ # Cache management and atomic file writes
├── ui/ # egui interface components, themes, pages
└── utils/ # System metrics, file utilities, validation
Do I need to own Minecraft to use MONORYX?
No. MONORYX supports offline profiles for singleplayer and LAN servers. If you own Minecraft Java Edition, you can sign in with your Microsoft account to join online Mojang servers.
Can I move worlds and mods from another launcher?
Yes. Copy your mods/, saves/, and config files into the instances/<instance-id>/game/ directory. MONORYX detects them on startup.
How does memory allocation work?
Automatic memory detects your installed RAM and sets a safe cap. You can turn on Eco Mode to reduce allocation or enter custom values in settings.
MONORYX is released under the Apache License 2.0.
Minecraft is a registered trademark of Mojang Synergies AB. MONORYX is an independent project by DemonZ Development and is not affiliated with Mojang Studios or Microsoft.