KeyVerse LogoKEYVERSE
Support Creator

KEYVERSE KNOWLEDGE BASE

Everything about your launcher, in one clear place.

Use the guides below to install Keyverse, sign in, shape profiles, manage game files, discover mods, and understand every recent improvement.

Start the guide Read release notes
CURRENT BUILD 1.4.5 premium launcher refresh
View what changed
01 Quick start 02 Profiles 03 Mods 04 Fix an issue 05 Release notes

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.

  1. 01
    Install

    Run Keyverse Setup, choose where it lives, and finish the guided setup.

  2. 02
    Sign in

    Open Accounts, copy the device code, and complete Microsoft sign-in in your browser.

  3. 03
    Create a profile

    Choose a Minecraft version, loader, name, and game folder for your setup.

  4. 04
    Play

    Keyverse checks files, prepares Java when needed, and launches Minecraft with live progress.

A calm first boot

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.

WindowsGuided 64-bit setup with per-user installation and shortcut choices.Get the installer →
macOS & LinuxDownload destinations are listed on the website when the platform package is available.Choose a platform →
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.

1Copy the code

Select Copy code in the launcher. A confirmation appears when it is on your clipboard.

2Finish in your browser

Use the Microsoft page opened by Keyverse and sign in to the account that owns Minecraft.

3Return to Keyverse

Keep Keyverse open until the account card appears. You can then select it for launch.

Your password stays in Microsoft's page

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 preferences and resource packs

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. Worlds, mods, pack selection, version metadata, and mod-specific configuration remain local.

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. Open the shared library from Settings to manage the collection.

Your original options file is preserved in the instance’s .keyverse-backups/options-before-universal.txt. You can turn either sharing option off; existing local files are kept.

VanillaThe official game version with no mod loader.
Fabric / QuiltLightweight loader choices for compatible client-side content.
Forge / NeoForgeProfiles for projects made for their wider mod ecosystems.
Safe profile deletion

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.

Essentials first Catalogs deferred Logs batched Stop control ready
Java & memoryChoose a runtime and sensible RAM allocation for the profile. macOS runtime detection supports Mojang's bundled Java layout.
While playingUse Stop playing to end the launched game. If the launcher is set to hide while playing, reopening Keyverse does not stop Minecraft.
Fast without being mysterious

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.

01Find it

Search Modrinth inside Keyverse, or open the official CurseForge catalog from its own tab.

02Match it

Check Minecraft version, loader, and dependencies before adding a file.

03Import it

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.

Custom themeAccent, background, and text colors carry through buttons, progress rails, loading backdrops, and the structured Home-screen signal pattern.
Icon variantsChoose a built-in mark or add PNG variants before packaging. Accent, background, and text colors stay in sync.
Heading underlinesSet an independent underline color in General & Theme, or reset it to follow the active theme. Automatic heading reveals remain visible after the animation.

SETTINGS & PERFORMANCE

Fine-tune memory, Java, and visuals.

Control memory allocation, custom JVM arguments, theme preferences, and dashboard widget layouts.

Smart RAM Allocation

Presets from 2 GB to 12 GB with automatic heap recommendations for your system.

Custom Themes

Choose your accent color, launcher logo variant, and dark/light mode preference.

Dashboard Widgets

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 receives game stdout and stderr. Use search and level filters to narrow output, pause automatic scrolling to inspect a problem, or copy/save logs for support. Clearing the displayed console does not restart Minecraft. Stopping and restarting act on the tracked game process.

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.

Share logs carefully

Review exported logs before posting them publicly. They can contain local paths, player names, and server addresses.

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.sql in a new Supabase SQL Editor query, then run supabase/verify.sql. 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.

Availability is explicit

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.

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 and preview

Import a supported cape PNG, toggle its visibility, and preview its placement on the model. Save appearance assets to your Keyverse profile, or export the edited assets. A Keyverse cape is not an entitlement to an official Mojang cape; visibility in Minecraft depends on supported client/server integration.

Save and apply

Export PNG saves a local asset. Apply to Profile updates the selected profile appearance; Cloud profile persistence requires Keyverse Cloud sign-in. Watch the operation's success or error result before leaving the editor.

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.

UPDATED
18 AUG 2026
1.4.5premium launcher refreshCurrent release

Resilient updates and downloads, illustrated instance setup, universal game files, premium feature cards, and a dedicated live console.

NEW

  • Fixed In-App Auto-Updater: Fixed updater engine with live accurate download percentage progress and real-time MB/s speed metrics.
  • Real-Time Progress Bar: Added smooth animated progress fill and instant auto-refresh upon download completion to reveal the "Install & Restart" button.
  • Pulsing Topbar Pill: Real-time update status push notifications in the top bar.

IMPROVED

  • Installer UI & Hero Card: Revamped modern update hero card with official 3D green block icon and state-reactive glow.
  • Safe Auto-Updater: 100% preservation of instance profiles, custom mods, configs, and saved worlds.

FIXED

  • Updater Fixes: Fixed IPC subscription handling and resolved download tracking bottlenecks.
  • Optimized blockmap validation and GitHub CDN streaming.
1.4.2In-App Background Auto-Updater, Live Progress & Minecraft 26.2 EnginePrior release

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.
0.2.0KeyClient In-Game UI, 100,000+ Modrinth Live Search & Instant PNG EnginePrior release

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 Select component with spring pop-ins, green checkmarks (✓), and click-outside listeners.
  • Launcher Animations: Modal spring pop-ins (@keyframes kv-modal-pop), card hover glow effects (@keyframes kv-card-pop), and backdrop blur filters.

FIXED

  • Fixed infinite recursive loop in ConfigUIImpl.postReload() causing in-game Client Options screen freezes.
  • Fixed missing Updatable interface implementation in GenericWidget preventing option button clicks.
  • Fixed missing mod card title property names and implemented ModCardIcon fallback handling.
  • Added local disk caching for Mojang version manifests (versionJsonPath) for 100% offline launching.
0.1.6Google & Discord OAuth 2.0, 25MB Media Attachments & Auto-UpdaterPrior release

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.
0.1.5Offline Accounts, Skin Upload & Creator SupportPrior release

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.
0.1.4Cross-platform loaders & a leaner launcherPrior release

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.
0.1.0Launcher foundationPrevious release

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 .jar import.
  • 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.
Next releases will be listed here with their date, version, new features, improvements, and fixes.Get the latest build →

PRIVACY & FAIR PLAY

A launcher should respect the game and the player.

What belongs herePerformance tools, allowed visual improvements, organization, profiles, launch controls, and transparent game setup.
What does notCombat automation, ESP, reach, autoclickers, packet manipulation, authentication bypasses, cracked launching, or hidden telemetry.
Fair Play Guard

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:linux

The custom installer assets live in build/installer-sidebar.bmp and build/installer-header.bmp. Build platform-specific release files on their matching operating systems.