Keyverse Open Source Documentation
Complete developer guide to cloning, building, customizing, and contributing to Keyverse Minecraft Launcher Community Edition.
Release Notes: 1.4.15 #
Version 1.4.15 adds automatic release installation, a calmer unified download-progress card, Fabric API provisioning alongside KeyClient, persistent per-profile KeyClient choices, content version selection, optional legacy-launcher imports, accurate playtime, and refreshed launcher artwork. The Forge KeyClient port remains in source but is locked in the launcher and labelled Still in progress.
Automatic Updater
Platform-aware feeds download, verify, install, and restart from inside the launcher, with release-page links for each build.
KeyClient In-Game UI
Keyverse's configurable in-game menu, draggable HUD, keystrokes, CPS, FPS counter, coordinates, direct search-result toggles, and No Sprint FOV (Right Shift in-game).
Complete Version Browser
Mods, shaders, and resource packs open a searchable version picker before installation.
Cloud Appearance
Supabase-backed skin and cape uploads linked to a Minecraft username and UUID, with public opt-in lookup for KeyClient.
Universal KeyClient Settings
Modules, themes, HUD positions, crosshair state, and client preferences move through the same launch-and-exit sync cycle as servers.
Forge Port Status
The Forge KeyClient work stays available to contributors, while release installation remains locked until the port is ready.
Quickstart #
Keyverse Open Source Edition is built using Electron, React, TypeScript, and Vite. Prerequisites: Node.js 18+ and npm installed on your machine.
git clone https://github.com/ahtilol/keyverse.git
cd keyverse
npm install
npm run dev
npm run dev starts the Vite dev server with hot module replacement (HMR) for instant UI updates.Building from Source #
To compile standalone production distribution binaries (.exe for Windows, .dmg for macOS, .AppImage for Linux), execute the build pipeline:
# Compiles TypeScript and packages Electron application binaries
npm ci
npm run typecheck
npm run build:desktop
npm run package:win
# On macOS: npm run package:mac
# On Linux: npm run package:linux
The desktop bundle is written to out/; installers are written to dist-electron/. Run each platform packaging command on the matching operating system. macOS and Linux source builds are not a claim of an available signed release.
Cloud setup: Run the complete supabase/RUN_THIS_FIRST.sql, then supabase/verify.sql in your Supabase project. Configure the public project URL and anon key in the launcher. Never put a service-role key in frontend settings.
Project Architecture #
The codebase is organized cleanly between Electron main process logic, preload IPC bridges, and the React UI frontend:
keyverse/
└── src/
├── main/ # Electron main process (IPC, launcher, paths)
├── preload/ # IPC bridge (window.keyverse)
├── renderer/ # React views (Home, Mods, Versions, Settings)
└── shared/ # Shared TypeScript interfaces & IPC constants
Main Process
Handles game process spawning, Java execution, version manifest resolution, and local profile management.
Renderer UI
React dashboard with live Modrinth search, theme controls, and lightweight splash themes.
Appearance Bridge
Skin Studio uploads to Supabase Storage, links the active Minecraft identity, and exposes an opt-in lookup consumed by the bundled KeyClient texture loader.
Shared Game State
The launcher prepares shared servers, options, resource packs, and KeyClient configuration before launch, then captures changes after the game exits.
Offline Accounts #
Offline accounts allow local play without signing into Microsoft services. Offline profiles generate deterministic UUIDs and keep only profile data in Keyverse storage.
Loader Support #
Keyverse supports Vanilla, Fabric, Quilt, Forge, and NeoForge profiles. New profiles resolve a recommended compatible loader build, while modpacks use the loader declared in their manifest.
CurseForge API Key #
To browse CurseForge's live mod database within the launcher, enter your CurseForge Developer API key in Settings or pass it into curseforge.ts.
PR Contribution Guidelines #
We welcome bug fixes and feature additions! Please ensure all code passes npm run build cleanly without TypeScript errors before submitting a pull request.
MIT License #
Keyverse Open Source Edition is open-source software licensed under the MIT License. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files, to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software.