Overview
Main Site GitHub ↗

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.

Windows (.exe) macOS build guide Linux build guide

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.

KeyClient: Explore the official in-game companion, compatibility, and setup guide at client.keyverse.ahti.lol.

Quickstart #

Keyverse Open Source Edition is built using Electron, React, TypeScript, and Vite. Prerequisites: Node.js 18+ and npm installed on your machine.

bash — terminal
git clone https://github.com/ahtilol/keyverse.git
cd keyverse
npm install
npm run dev
Tip: Running 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:

bash — build command
# 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:

directory tree
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.

KeyClient on Forge: The port is still in progress and is deliberately locked in Keyverse 1.4.15. Forge profiles and ordinary Forge mods continue to work; only the bundled KeyClient Forge installation is unavailable.

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.

Thanks for your feedback!