Install HeroOS #
Open HeroOS from the platform it targets — it is not a Minecraft mod, so the generic install guide below doesn't apply (see its product page for what it runs on).
- HeroOS is in development — there is no public build to install yet, and nothing runs on real hardware today.
- Understand where it is: Phase 1 is complete — kernel core (paging, heap, GDT/TSS, IDT, PIC/PIT) with 10 self-tests passing, booting to a framebuffer boot banner in an emulator.
- Follow the roadmap to track Phase 2 progress: keyboard, mouse, RTC and user mode — the next milestone.
- Plan around the later phases: driver framework (loadable kernel modules), then the v1.0 desktop (GUI, shell, filesystem, real-hardware boot).
- Join the community to get early milestones as they open up — Discord and the support portal are the channels.
- If you want to run a from-scratch OS today, experiment with hobby OS emulators — HeroOS will publish emulator images when milestones allow.
Folder locations by platform #
| Platform | mods / resourcepacks folder | config folder |
|---|---|---|
| Windows | %appdata%\.minecraft\mods · \resourcepacks | %appdata%\.minecraft\config |
| macOS | ~/Library/Application Support/minecraft/mods | ~/Library/Application Support/minecraft/config |
| Linux | ~/.minecraft/mods · ~/.minecraft/resourcepacks | ~/.minecraft/config |
MultiMC / Prism users: these folders live inside Instances/<instance>/.minecraft/.
Configure #
Settings live in the config folder (JSON5 files you can edit by hand) and, where available, in the in-game settings screen the mod adds. The exact keys and keybinds are listed in the documentation and the FAQ below.
Tips for HeroOS #
- Keep HeroOS on the version range shown on its product page.
- If it doesn't load, confirm the JAR is in the right mods folder for the launcher and version you chose.
- Bedrock Edition, mobile, and console can't run Java Edition mods or packs — for a port or custom variant, request a commission.
HeroOS FAQ #
Is HeroOS a Minecraft mod?
No — it is a standalone operating system written in Rust, separate from the Minecraft software line.
Can I run it on my PC?
Not yet. It runs in an emulator today — Phase 1 boots to a framebuffer boot banner and kernel logs — and real-hardware support is a v1.0 goal.
Will it really replace Windows?
That is the long-term vision, reached milestone by milestone — an honest path, not a promise. Phase 1 is done; Phase 2 (input, timers, user mode) is next.
Can I download a build?
Not yet. There are no public builds until later milestones are reached; Phase 1 is a kernel milestone, not a downloadable OS.
What is actually working today?
Phase 1 complete: paging, heap, GDT/TSS, IDT and PIC/PIT in a memory-safe Rust no_std kernel with minimal x86-64 assembly — 10 self-tests passing, booting to a framebuffer boot banner and kernel logs in an emulator.
What comes after Phase 1?
Phase 2 — keyboard, mouse, RTC and user mode — then a driver framework with loadable kernel modules, and finally the v1.0 desktop (GUI, shell, filesystem, real-hardware boot).
How is it built?
A memory-safe Rust no_std kernel with minimal x86-64 assembly, booted via UEFI. Everything — kernel, drivers, GUI, shell, filesystem, package manager — is owned end to end.
How can I follow or contribute?
Follow the roadmap on this site, and join the Discord for early milestones. Privacy by design: no ads, no forced updates, no telemetry.
Still stuck? Open a guided request — every message is tagged and
answered from support@herostudios.dev. Always include your Minecraft version and product version.