anvil

Build a native Minecraft launcher by writing only HTML.
The Rust backend handles everything else.

---

anvil is a framework that generates a native Minecraft launcher (Windows · macOS · Linux) from a config.json file and an HTML page. The built-in Rust backend handles Java, Minecraft downloads (vanilla, Fabric, Forge…), mods, launching, sessions, auto-updates and app icons. You only touch the frontend.

Quick start

npx @thomasfarineau/anvil create my-launcher
cd my-launcher
npm install
npm run dev

create is interactive: pick TypeScript or JavaScript, then Vanilla, React, Vue or Solid. Skip the prompts with --template <id> — see examples/ for a ready-made project of each template.

Anvil Server

server/ is an optional self-hosted companion: it hosts your instances (mods, config files) and player accounts, so launchers can fetch them remotely instead of bundling everything at build time. Deploy it with docker compose up -d — see the Anvil Server docs for details.

📖 Documentation

Full docs, guides and API reference: thomasfarineau.github.io/anvil (français)

• Getting started
• CLI commands
• Project structure
• config.json reference
• Mods per instance
• Session (offline / custom auth)
• Anvil Server
• JavaScript API
• App icon generation
• Build & distribution

License

MIT © Thomas Farineau