MineIA is an open source, offline-first Minecraft launcher built with AI assistance. It focuses on local profiles, low resource usage, simple mod and shader imports, and transparent runtime files.
- Offline Minecraft profiles with local usernames.
- Deterministic offline UUID generation.
- Local version cache using Mojang version metadata.
- Verified downloads with SHA-1 and file size checks.
- Java detection through
MINEIA_JAVA_HOME,JAVA_HOMEorPATH. - Detached Minecraft process on Windows.
- Low-consumption launch defaults for RAM, FPS, render distance and JVM options.
- Per-profile folders for mods, shaders, resource packs, logs and crash reports.
- Import support for
.jarmods,.zipshaders and.mrpackmodpacks. - Local file hashing with SHA-256 and BLAKE3.
- Tauri desktop app with SolidJS and Tailwind CSS.
Add screenshots in docs/screenshots/ before publishing the repository.
Recommended images:
- main launcher screen
- version selector
- mods and shaders screen
- local profile folder example
apps/mineia-launcher/ Desktop app, Tauri backend and SolidJS UI
crates/mineia-auth/ Offline username validation and UUID generation
crates/mineia-core/ Local paths, SQLite profiles and hashing
crates/mineia-runtime/ Java detection, downloads and Minecraft launch
crates/mineia-modpacks/ Mod, shader and modpack import logic
docs/ Project documentation
scripts/ Developer commands
tools/ Internal maintenance tools
- Windows 10 or newer
- Rust stable
- Node.js 20 or newer
- npm
- Java 17 or newer for modern Minecraft versions
npm.cmd install --prefix apps/mineia-launcherPowerShell can block npm.ps1 on some systems. Use npm.cmd for consistent Windows behavior.
npm.cmd run dev --prefix apps/mineia-launchernpm.cmd run tauri --prefix apps/mineia-launcher -- buildArtifacts are generated under:
target/release/
target/release/bundle/
For public releases, attach generated files from target/release/bundle/ to the GitHub Release page.
Current Windows installer:
Recommended release names:
MineIA_1.0.0_x64-setup.exeMineIA_1.0.0_x64_en-US.msi
MineIA should use semantic versioning:
v1.0.0: first stable releasev1.1.0: new features without breaking existing behaviorv1.1.1: bug fixes onlyv2.0.0: breaking changes or large architecture changes
Update versions in:
Cargo.tomlapps/mineia-launcher/package.jsonapps/mineia-launcher/src-tauri/tauri.conf.json
cargo fmt --all
cargo check
cargo clippy --workspace --all-targets -- -D warnings
cargo test
npm.cmd run build --prefix apps/mineia-launcher
powershell -ExecutionPolicy Bypass -File scripts/check.ps1
powershell -ExecutionPolicy Bypass -File scripts/build-release.ps1
node tools/clean.mjsMore details are in docs/TOOLS.md.
MineIA does not include Microsoft login, telemetry, a backend service or remote account storage. It is offline-first by design.
Security notes:
- Do not commit local databases, logs, profiles or downloaded game files.
- Keep
.envfiles private. - Validate archive paths before extracting modpacks.
- Verify Mojang downloads before reuse.
- Treat imported
.jarmods as third-party executable code.
See SECURITY.md.
- Fork the repository on GitHub.
- Clone your fork:
git clone https://github.com/your-user/mineia.git
cd mineia- Create a branch:
git checkout -b feature/short-description- Make focused changes.
- Run checks:
powershell -ExecutionPolicy Bypass -File scripts/check.ps1- Commit and push:
git add .
git commit -m "Improve launcher UI"
git push origin feature/short-description- Open a Pull Request.
Pull Requests should include a summary, screenshots for UI changes and the checks that were run.
See CONTRIBUTING.md.
MineIA is released under the MIT License. See LICENSE.
MineIA is an open source launcher built with AI-assisted development and maintained by its contributors.