QUICK START
From download to first world.
Keyverse starts with the essentials first, then brings in the heavier catalog and news content after the launcher is ready. That keeps the first screen responsive without hiding what the launcher is doing.
- 01Install
Run Keyverse Setup, choose where it lives, and finish the guided setup.
- 02Sign in
Open Accounts, copy the device code, and complete Microsoft sign-in in your browser.
- 03Create a profile
Choose a Minecraft version, loader, name, and game folder for your setup.
- 04Play
Keyverse checks files, prepares Java when needed, and launches Minecraft with live progress.
The launcher keeps its loading screen visible long enough to explain what is happening, while a recovery timer prevents a slow external request from trapping you on that screen.
DOWNLOADS & SETUP
A setup flow that feels like Keyverse.
The Windows installer uses Keyverse branding, a folder picker, installation progress, and a completion screen. Choose the application location, follow the setup steps, and launch Keyverse when installation finishes.
Where should I install Keyverse?
Use the suggested per-user location unless you have a reason to keep applications elsewhere. Keep your profile folders on a drive with enough space for Minecraft assets, worlds, screenshots, and mods.
Can I close setup while it is installing?
Let the setup progress finish first. Once it completes, open Keyverse from the shortcut or your applications list.
MICROSOFT SIGN-IN
Sign in without giving Keyverse your password.
Keyverse uses the Microsoft device-code flow. The launcher gives you a short code with a copy button, and your browser handles the account sign-in and approval.
Select Copy code in the launcher. A confirmation appears when it is on your clipboard.
Use the Microsoft page opened by Keyverse and sign in to the account that owns Minecraft.
Keep Keyverse open until the account card appears. You can then select it for launch.
Keyverse never asks for, receives, or stores your Microsoft password. It stores the authorization information locally so your selected account can launch Minecraft.
PROFILES & GAME FILES
Keep worlds, loaders, and experiments separate.
A profile records its Minecraft version, loader, Java and memory choices, game directory, installed mods, and recent play history. Keep a clean vanilla profile beside Fabric, Quilt, Forge, or NeoForge profiles instead of mixing everything together.
Universal game, server, and KeyClient preferences
In Settings → Game & Java, universal preferences share supported audio, video, chat, and control options before launch and save changes after exit. Key bindings use separate legacy and modern compatibility groups. KeyClient's module choices, active theme, HUD positions, crosshair editor state, and other client preferences follow the same launch-and-exit cycle across supported instances. Worlds, mods, pack selection, and version metadata remain local.
Saved servers are prepared for every launch and captured when the game exits, while the shared resource pack library imports installed packs and makes them available at the next launch of each instance. Conflicting filenames keep both versions. Enable a compatible pack inside Minecraft. Removing an instance copy does not delete the shared original.
Your original options file is preserved in the instance’s .keyverse-backups/options-before-universal.txt. Turning universal settings off keeps each instance's existing local files.
Deleting a profile removes its managed Keyverse game folder. If a profile points to a custom folder outside Keyverse-managed locations, Keyverse removes only the profile record and deliberately keeps that folder so a shared Minecraft installation is never wiped by accident.
Why can't I delete a profile while Minecraft is running?
Keyverse blocks the deletion so it cannot remove files the game is still using. Stop Minecraft from Home, wait for the status to return to idle, then delete the profile.
LAUNCH & PERFORMANCE
See the work, then get into the game.
Launch progress follows the real sequence: profile checks, version metadata, missing files, assets, Java, loader preparation, native extraction, then Minecraft itself. The launcher batches game log updates so an active console does not make the rest of the interface feel heavy.
Keyverse does not wait for optional news and mod discovery before showing the usable launcher. It also has a startup failsafe, so a delayed nonessential request cannot lock the app on the opening screen.
MODS & CURSEFORGE
Build a compatible profile, not a messy folder.
Select a profile first. Keyverse can then match Modrinth content against its Minecraft version and loader. The Mods area also includes curated performance and QoL choices, installed-file controls, resource packs, shaders, modpacks, and a CurseForge route.
Search Modrinth inside Keyverse, or open the official CurseForge catalog from its own tab.
Check Minecraft version, loader, and dependencies before adding a file.
Use Import downloaded .jar after a CurseForge download to copy only that selected file into the active profile.
- Performance choices include well-known projects such as Sodium, Lithium, and FerriteCore where compatible.
- Keyverse keeps each profile's mods in its own game directory.
- Server rules always come first, including for client-side visual or convenience mods.
The mod install dialog looks misplaced or moves while scrolling
Update to the newest launcher build. The installation dialog is mounted above the scrolling Mods page, which keeps it centered and prevents the page behind it from jumping.
APPEARANCE
Make the launcher feel like yours.
Click the Keyverse mark in the sidebar to open the icon palette. Pick the original mark or switch between Creeper green, Redstone red, Diamond blue, Gold yellow, white, and pink variants. Optional PNG variants can also be added before packaging.
SETTINGS & PERFORMANCE
Fine-tune memory, Java, and visuals.
Control memory allocation, custom JVM arguments, theme preferences, and dashboard widget layouts.
Presets from 2 GB to 12 GB with automatic heap recommendations for your system.
Choose your accent color, launcher logo variant, and dark/light mode preference.
Reorder and toggle launcher home screen widgets to suit your playstyle.
LAUNCHER TOOLS
Follow the process. Find the files.
Open an instance to manage its settings, content, worlds, and logs. Play resolves that instance's version, loader, game directory, memory, and Java configuration before starting the real Minecraft process.
Live console controls
The console uses a compact card layout for process ID, memory, launch time, and exit status beside the live stdout and stderr stream. Use search and level filters to narrow output, pause automatic scrolling to inspect a problem, or copy/save logs for support. Clear status colors and subtle motion make state changes visible without distracting from the log. Clearing the displayed console does not restart Minecraft.
Separate window and saved console themes
The console opens automatically when launching and remains open after Minecraft exits. Hiding the launcher does not hide the console. Use Theme in the console toolbar, or General & Theme in launcher settings, to select Midnight, Forest, Nebula, Paper, the launcher theme, or a custom background/text/accent palette. Text size, timestamps, and line wrapping are saved across launches.
Instance folders and settings
Files opens the selected instance directory. Mods, Config, Resourcepacks, Screenshots, and Worlds point to their actual subfolders. Change memory, Java, JVM arguments, and game options in instance settings; check the console if a runtime or argument is rejected.
Review exported logs before posting them publicly. They can contain local paths, player names, and server addresses.
SKIN STUDIO
From pixels to your profile.
Import a PNG or start editing the current skin. Paint in the 2D UV editor or on the 3D model, choose Steve or Alex geometry, isolate body parts, and work with inner or outer layers. Brush, eraser, color, brightness, opacity, and undo/redo controls share the same skin canvas.
Cape import, normalization, and preview
Import a supported cape PNG, toggle its visibility, and preview its placement on the model. Apply to Profile converts the preview to the 64×32 cape layout used by the game before uploading it, so the saved result matches what Skin Studio shows. A Keyverse cape is a client-rendered profile asset and does not grant an official Mojang cape entitlement.
Save, link, and render in game
Apply to Profile uploads the current skin and cape to Keyverse Cloud, saves the Steve or Alex model choice, and links the appearance to the active Minecraft username and UUID. The bundled KeyClient checks the username first, falls back to UUID for compatibility, validates the PNG assets, and renders the saved skin and cape in supported Fabric games. Cloud persistence requires Keyverse Cloud sign-in and the Use saved Keyverse skin and cape in supported games option.
TROUBLESHOOTING
Common questions answered.
Minecraft will not start
Read the stage and game console on Home. Verify the profile's Java runtime and memory, then try a clean vanilla profile to separate a launcher issue from a loader or mod conflict.
A downloaded mod does not work
Confirm its Minecraft version, loader, and dependencies. A Forge mod will not load on Fabric, and a mod for another Minecraft version can fail before the game reaches the title screen.
Keyverse seems to close while I play
Check the Keep launcher open while playing setting. When it is disabled, Keyverse hides itself after launch; Minecraft continues running and Keyverse can be reopened normally.
RELEASE NOTES
What changed in Keyverse.
Release notes stay practical: new behavior, meaningful fixes, and direct launcher updates.
29 SEP 2026
Automatic installation, complete content version selection, reliable Fabric KeyClient setup, and a clearer launcher experience.
NEW
- Automatic Updates: Platform-aware feeds download and install new launcher releases without sending players through a manual installer flow.
- Content Version Browser: Mods, resource packs, and shaders expose every available release in a searchable selection dialog.
- Legacy Import: First launch and Settings offer an optional assistant for compatible preferences, servers, packs, and KeyClient settings.
- Accurate Playtime: Instance cards track completed game sessions and present the result in a compact readable format.
- Forge Port Status: The unfinished KeyClient Forge port remains in source but is locked in production and clearly marked Still in progress.
IMPROVED
- Download Experience: Update status, percentage, speed, transferred size, and the progress rail now live in one calmer themed card.
- Fabric KeyClient: The launcher installs the matching KeyClient bundle and Fabric API together for supported Fabric profiles.
- Theme Artwork: Launcher icon choices and version-category artwork use the selected Minecraft-inspired assets and names.
FIXED
- KeyClient Preference: Manually disabling KeyClient stays respected instead of being silently reversed.
- Module Search: Search-result cards toggle the selected module directly; the dedicated sliders icon opens its settings.
- Content Bridge: The preload API now exposes version discovery safely instead of crashing the renderer.
- macOS Launching: Java uses the compatible fork launch mechanism to avoid
posix_spawnfailures.
Seamless GitHub releases integration, live percentage downloads, topbar notification pills, and memory scaling.
NEW
- Integrated Auto-Updater: Native auto-updater with live download percentage progress, changelog inspection, and one-click restart installation.
- Topbar Update Pill: Pulsing notification badge in the top navigation bar whenever a new version is published.
- Direct GitHub Releases Fallback: Dual-channel update checks ensuring updates work even in portable/unpacked environments.
IMPROVED
- JVM Heap Memory Manager: Smart heap scaling with 2 GB initial heap limit preventing Windows memory allocation errors.
- Minecraft 26.2 Support: Complete compatibility with the latest Java Edition release snapshots and Fabric/NeoForge loaders.
FIXED
- Fixed NSIS installer warnings in builder execution.
- Optimized update hash checks and blockmap downloads.
Lunar-style in-game client HUD, 100,000+ live Modrinth search, official mod logos, and plugin marketplace.
NEW
- KeyClient In-Game UI & HUD: Lunar-style client menu with draggable HUD, Keystrokes, CPS, FPS counter, and coordinates (Press Right-Shift in-game).
- 100,000+ Modrinth Live Search: Search and install live Modrinth mods, shaders, and resource packs directly with official high-res mod logos.
- In-Client Bundle: Pre-configured performance and utility mods (Sodium, Lithium, FerriteCore, MemoryLeakFix, Krypton, ImmediatelyFast, ModernFix, EntityCulling, Iris Shaders, ModMenu, BetterF3, Cloth Config, Architectury, LightOverlay, Coordinates Display, Chat Animation, KeyClient) with official Modrinth logos.
- KeyClient: The official configurable in-game HUD is available at client.keyverse.ahti.lol.
IMPROVED
- Instant PNG Rendering Engine: 95% asset payload compression (from 8.6 MB down to 448 KB) and global memory caching (
canvasCache) for zero-delay instant icon rendering. - Custom Animated Dropdowns: Animated React
Selectcomponent with spring pop-ins, green checkmarks (✓), and click-outside listeners. - Launcher Animations: Modal spring pop-ins (
@keyframes kv-modal-pop), clean card hover transitions, and keyboard-friendly focus states.
FIXED
- Fixed infinite recursive loop in
ConfigUIImpl.postReload()causing in-game Client Options screen freezes. - Fixed missing
Updatableinterface implementation inGenericWidgetpreventing option button clicks. - Fixed missing mod card title property names and implemented
ModCardIconfallback handling. - Added local disk caching for Mojang version manifests (
versionJsonPath) for 100% offline launching.
Google & Discord sign-in, 25MB media support, high-res avatar rendering, and auto-updater feed.
NEW
- Official Google & Discord OAuth 2.0 authentication across web and launcher.
- Pre-configured Owner & Developer identities for ahti (
930813224088141855) and kiki (1212171442691776584). - Support Desk media attachment pipeline supporting up to 25 MB per ticket message (images, crash logs, .mp4, .webm).
- Automated auto-updater feed integration serving
latest.yml& delta blockmaps at/releases.
IMPROVED
- High-resolution Discord CDN avatar rendering (256px) with smooth circular clipping.
- Updated Content-Security-Policy to allow HTTPS external images and connections seamlessly inside Electron.
- Dedicated Release Notes tab and page on Support Desk Releases.
FIXED
- Fixed broken image icon fallback in launcher account bar using UI-Avatars auto-generation.
- Fixed HTML page container nesting on status desk route handlers.
Offline account management, custom skin upload, and unified creator support.
NEW
- Offline account mode — play without Microsoft authentication when needed.
- Skin uploader — load custom local skin PNGs or sync directly to Mojang servers.
- Support Creator portal integration across launcher topbar, support view, and all website headers.
IMPROVED
- Top-right header action bar layout alignment across all web pages.
- Status & Support Desk links added to website footers.
- Customizable splash screen styles (Dots / Minimal / Skip) in Settings.
FIXED
- Compact coffee mug icon rendering with zero hover size or speed jumps.
- Cleaned ecosystem links on launcher home screen.
Make loader choice clearer, startup safer, and account management lighter.
NEW
- Modpacks now preserve their declared Fabric, Forge, NeoForge, or Quilt loader instead of assuming Fabric.
- A dedicated What's New panel appears below the game console and above video updates in the launcher.
IMPROVED
- macOS Java discovery checks Apple's Java registry and clears runtime quarantine when it is safe to do so.
- Fabric and Quilt installation now completes before the launcher reports success, avoiding startup races.
FIXED
- Removed the launcher's skin, cape, and avatar cosmetic tools for a simpler account flow.
- Hardened modpack override extraction so a pack cannot write outside its game directory.
Full skin rendering, official cape library, and NeoForge installer.
NEW
- Official Minecraft cape library — 12 capes (Mojang, Mojang Classic, Minecon 2011–2016, Founders, 15th Anniversary, Purple Heart, TikTok, Cherry Blossom) bundled directly as verified assets from
textures.minecraft.net. - NeoForge installer support — select NeoForge as a loader on any compatible version (1.20.2+). Version JSON is fetched directly from the NeoForged Maven repository with no installer JAR required.
- Premium skin viewer card with gradient background, scanline overlay, animated username badge with live-status dot, and drag-to-rotate hint.
- Cape picker redesigned: hover lift, checkmark on selected cape, subtle pixel-grid preview background, and theme-aware colors throughout.
IMPROVED
- Skin texture loading now correctly converts Mojang's
http://texture URLs tohttps://before fetching, fixing broken online skin display. - Custom uploaded skins (file paths) are now read locally via the Node.js main process and passed as
data:URLs to the 3D viewer — bypassing the browser'sfile://security restriction. - Cape 3D viewer now uses the same local-vs-external detection as the skin loader, ensuring local bundled capes render instantly without IPC proxy overhead.
- Steve and Alex model toggle now correctly swaps the base skin when no custom skin is uploaded, matching the selected model's default appearance.
FIXED
- Fixed cape thumbnails in the picker showing broken images — all capes are now bundled and load offline.
- Fixed custom skin upload failing silently when the file path contained backslashes on Windows.
- Fixed OptiFine and rare capes (Vanilla, Pan Cape) crashing the picker — they now display a placeholder tile correctly.
- Removed stray
wcharacter from the top ofdocs.html.
A custom Keyverse experience, from setup to launch.
NEW
- Custom dark green Windows setup flow with Keyverse artwork, buttons, progress rail, and animation.
- Theme controls for accent, background, text, loading screen, launcher icon variants, and optional custom PNG icon slots.
- Curated Mods area, Modrinth discovery, CurseForge catalog handoff, and selected local
.jarimport. - Stop-playing action and configurable launcher behavior while Minecraft runs.
IMPROVED
- Startup loads essentials first, defers optional content, batches live logs, and includes a boot recovery failsafe.
- macOS Java runtime path handling supports bundled Mojang layouts for Intel and Apple silicon environments.
- Loading screen remains long enough to communicate staged progress instead of flashing away.
- Website now includes platform links, legal pages, expanded documentation, and this release history.
FIXED
- Fixed the sign-in copy action and made its feedback clearer.
- Fixed scroll-related mod install dialog positioning.
- Fixed profile cleanup so managed game files are removed safely, while external custom folders are protected.
- Replaced random floating dots with a more structured, lightweight launcher backdrop.
PRIVACY & FAIR PLAY
A launcher should respect the game and the player.
Before Java starts, Keyverse inspects enabled mod archives for unsafe paths, archive bombs, malformed JARs, duplicate mod IDs, embedded executables, known cheat-client identities, and clusters of fair-play-sensitive capabilities. It also saves SHA-256 fingerprints in a local integrity report and repairs altered managed KeyClient bundles from the packaged source.
Fair Play Guard is a transparent client-side launch safeguard. It can prevent unsafe or clearly cheat-focused clients from starting through Keyverse, but it does not inspect another player's computer and is not a replacement for a server operator's own anti-cheat.
Keyverse stores profiles, preferences, and authorization data locally on the device so it can remember the selected setup. Read the complete Privacy Policy and Terms of Use for project details.
DEVELOPMENT
Build Keyverse locally.
Keyverse uses Electron, React, TypeScript, Zustand, and electron-builder. Use the scripts below from the project root.
npm install
npm run dev
# Validate before packaging
npm run typecheck
npm run build
# Create native platform packages
npm run package:win
npm run package:mac
npm run package:linuxThe custom installer assets live in build/installer-sidebar.bmp and build/installer-header.bmp. Build platform-specific release files on their matching operating systems.
KEYVERSE SOCIAL
Your identity. Your community.
Sign into Keyverse Cloud from Accounts. This session is separate from the Microsoft account used to launch Minecraft. Cloud profiles, friendships, communities, channels, roles, and messages are persisted in Supabase rather than only in the current window.
Profiles, friends, and messages
Set a display name, avatar, bio, presence, and custom status. Search by gamer tag to send a friend request, accept or decline requests, and open a direct conversation. The current source includes message editing/deletion, replies, reactions, and image/file attachments. Private attachment access is checked against the conversation.
Communities and permissions
Create a community, choose its icon, create text or announcement channels, and invite members using the generated invite. Owners manage server settings, roles, and membership. Server-side rules enforce access; hiding a button is not the permission boundary.
Cloud setup and authentication errors
For a self-hosted project, run the complete
supabase/RUN_THIS_FIRST.sqlin a new Supabase SQL Editor query, then runsupabase/verify.sql. The complete bundle includes the username-linked appearance RPC used by KeyClient. Do not run isolated policy fragments. Configure the project's public URL and anon key, never a service-role key. If your session expires, open Accounts and sign in again.Cloud actions require connectivity and valid project configuration. GIF search and custom server emoji catalogs are not advertised as available without a configured, implemented provider and storage workflow.