Skip to content

About

Open-source Minecraft Java Edition launcher built with Rust, Tauri v2, and Vue 3. Features 1-click P2P co-op (no VPN/port forwarding), bytecode malware scanning (Cauldron Shield), Mod Doctor diagnostics, Git-like world snapshots, and built-in Modrinth/CurseForge browsing.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Cauldron Launcher

Cauldron Launcher (v1.0.0004) is an open-source, modular Minecraft Java Edition launcher and instance management suite built with Tauri v2, Rust, and Vue 3 + TypeScript.

Designed by Kettle Ignition Power Studio (K. I. P. Studio), it combines a clean desktop interface with native Rust tooling for version management, dependency auditing, bytecode security scanning, P2P co-op multiplayer, world snapshots, and crash diagnostics.


Key Features

Play

  • Unified Launchpad: Switch seamlessly between curated presets (Vanilla, Fabric, NeoForge, Forge, Quilt) or configure custom game and loader builds.
  • Mojang Version Manifest: Browse official releases, snapshots, and historical builds with instant asset, log4j config & SHA-1 client.jar verification.
  • Autonomous OpenJDK Provisioner: Strict major-version matching (Java 8, 17, 21, 25) with automatic Eclipse Adoptium runtime installation and JVM flag compatibility filtering.
  • Preflight Guard: Checks mod and JVM compatibility prior to launch with 1-click auto-repair or optional force launch.
  • Live Telemetry Strip: Tracks active instance playtime, mod count, saved worlds, host RAM/CPU metrics, and running process status.

Library

  • Content Manager: Enable, disable, delete, batch-manage, and inspect Mods, Modpacks (.mrpack / .zip), Resourcepacks, and Shaders.
  • Modrinth Hash Updates: Checks installed JAR SHA-1 hashes against Modrinth and streams verified upgrades.
  • Dependency Graph: Interactive vis-network topology map visualizing mod dependencies, core APIs, optimizations, missing libraries, and conflicts.
  • Drag & Drop Import: Drop .jar, .mrpack, or .zip packages directly into the window to route them into the active instance.

Discover

  • Modrinth & CurseForge Browser: Search mods, modpacks, resourcepacks, and shaders with version, loader, category, and sorting filters.
  • Recursive Dependency Installer: Automatically resolves and installs required companion libraries with streaming download progress.

Worlds

  • NBT Inspector & Rescue: View seeds, game modes, hardcore status, day counts, and spawn coordinates; recover players stuck in the void or negative effects (Heal).
  • World Operations: Inline gamemode switcher, safe world cloning, and 1-click full backup of all saves.
  • Cartographer Map: Renders top-down region maps directly from .mca chunk files with zoom, pan, and PNG export.
  • World Snapshots (VCS): Content-addressed SHA-256 snapshots for rolling back worlds to any previous state.

Media

  • Screenshot Gallery: Paginated browser for instance screenshots with format filtering (PNG / JPG).
  • 4K Lightbox & Compression: Fullscreen viewer with keyboard navigation, clipboard copy, and streaming PNG-to-JPEG compression to reclaim disk space.

Servers & Cauldron Co-op

  • 1-Button P2P Co-op (iroh QUIC): Share an open LAN world or local port with friends without VPNs or port forwarding via CAULDRON1:... invite codes, and join with Paste & Join / Connect & Play straight into the friend's world (--quickPlayMultiplayer / --server).
  • Friends & Saved Servers: SQLite-backed quick-join bookmarks storing server addresses with target Minecraft version and loader.
  • Server Status Lookup: Real-time Minecraft Server List Ping (SLP) with DNS SRV resolution, MOTD preview, latency, and player count.
  • Local LAN Radar: Listens for Minecraft LAN multicast announcements (224.0.2.60:4445) on the local network with 1-click Join or Share P2P.

Tools

  • Mod Doctor: Static JAR manifest and class bytecode analyzer (Java 8 / 17 / 21 / 25, loader collisions, SemVer dependency checks) with automated remediation.
  • Cauldron Shield: Static heuristic scanner for malicious bytecode patterns (webhooks, droppers, obfuscated endpoints, high-risk API clusters) with an isolated XOR-encrypted Quarantine Vault and secure file shredding.
  • Maintenance: Safe Mode toggle, options.txt Keybind Conflict Resolver, RAM-aware FPS optimizer, JVM flag generator, DNS flush, stuck JVM terminator, and log/map-cache/config cleaners.

Console

  • Live Log Viewer: Streams latest.log in real time with severity filtering (ERROR, WARN, INFO), search, pause/resume, .log export, and scrubbed mclo.gs upload.
  • Crash & AI Oracle: Automatically extracts the latest crash report, strips personal paths/IPs/tokens, runs offline heuristic checks, and optionally queries Google Gemini, OpenAI, Anthropic, or a local Ollama instance.

Settings

  • Account & 3D Skin Viewer: Microsoft Xbox Live OAuth (device code flow), offline handle configuration, and interactive WebGL 3D skin preview (skinview3d).
  • Java & JVM Tuning: Heap sizing, garbage collector selection (G1GC, ZGC, Shenandoah, Parallel), optimization presets (Balanced, Aikar, Low-Latency ZGC), and system JDK auto-detection.
  • Appearance & Localization: 9 UI languages (en, ru, es, de, zh, fr, pt, ja, ko), 6 theme accents, Mica blur toggle, low-graphics mode, and game window geometry.
  • Storage & Maintenance: Multi-instance switching, Shield import auto-scanning, SQLite WAL VACUUM, and built-in app updater.

Tech Stack

  • Desktop Shell & Backend: Rust, Tauri v2, Tokio, iroh (P2P QUIC), Reqwest, SQLite (rusqlite WAL), fastnbt, zip, image, sysinfo, discord-rich-presence
  • Frontend: Vue 3 (<script setup>), TypeScript, Tailwind CSS v4, Lucide Icons, vis-network, skinview3d, marked
  • CI/CD & Updates: GitHub Actions (tauri-apps/tauri-action) + Cloudflare Worker update proxy

Project Structure

Cauldron-Launcher/
+-- frontend/
¦   +-- src/
¦   ¦   +-- api/            # Typed Tauri IPC & Channel wrappers
¦   ¦   +-- components/     # UI primitives, layout, modals, Co-op & server cards, graph view, lightbox, 3D skin card
¦   ¦   +-- composables/    # Feature-scoped Vue composables
¦   ¦   +-- stores/         # Global application state & visual theme sync
¦   ¦   +-- types/          # TypeScript DTO definitions
¦   ¦   +-- utils/          # Formatting & sanitization helpers
¦   ¦   L-- views/          # 9 core screens (Play, Library, Discover, Worlds, Media, Servers, Tools, Console, Settings)
¦   L-- package.json
+-- src-tauri/
¦   +-- src/
¦   ¦   +-- app/            # Config, encrypted secrets, SQLite WAL, errors, locales, AppState
¦   ¦   +-- auth/           # Microsoft Xbox Live / Minecraft OAuth
¦   ¦   +-- commands/       # Modular Tauri IPC command handlers
¦   ¦   +-- content/        # Local JAR parser & Modrinth/CurseForge client
¦   ¦   +-- doctor/         # Mod Doctor analyzer, rules & remediation
¦   ¦   +-- launch/         # Java resolution, libraries, loaders, manifest merger & process runner
¦   ¦   +-- media/          # Screenshot indexing & PNG->JPG compressor
¦   ¦   +-- servers/        # P2P Co-op QUIC tunnel, SLP server ping & LAN multicast listener
¦   ¦   +-- shield/         # Heuristic bytecode scanner & quarantine vault
¦   ¦   +-- system/         # AI client, crash watcher, process monitor, Discord RPC, maintenance tools
¦   ¦   L-- worlds/         # NBT reader/healer, VCS snapshots & Cartographer map renderer
¦   +-- Cargo.toml
¦   L-- tauri.conf.json
+-- scripts/                # PowerShell build, icon & release helpers
+-- worker.js               # Cloudflare Worker update endpoint
+-- wrangler.toml           # Cloudflare Worker configuration
L-- package.json

Development Setup

Prerequisites

  • Node.js 20+ and npm
  • Rust stable toolchain (rustup)
  • Tauri CLI (cargo install tauri-cli --locked or @tauri-apps/cli)
  • Platform prerequisites for Tauri v2 (WebView2 + MSVC Build Tools on Windows; libwebkit2gtk-4.1-dev, libappindicator3-dev, librsvg2-dev, libdbus-1-dev, libssl-dev, pkg-config, patchelf on Ubuntu/Debian; Xcode Command Line Tools on macOS)

Run in Development Mode

npm run install:all
npm run tauri dev

Build Release Bundle

npm run install:all
npm run build
npm run tauri build

Disclaimer

NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.

Cauldron Launcher downloads official Minecraft client binaries and assets directly from Mojang servers. A valid Minecraft: Java Edition license is required to authenticate with Microsoft and play online.


License

This project is licensed under the GNU General Public License v3.0 only (GPL-3.0-only).

About

Open-source Minecraft Java Edition launcher built with Rust, Tauri v2, and Vue 3. Features 1-click P2P co-op (no VPN/port forwarding), bytecode malware scanning (Cauldron Shield), Mod Doctor diagnostics, Git-like world snapshots, and built-in Modrinth/CurseForge browsing.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages