Skip to content

Version Management ​

VoxVer Launcher provides complete Minecraft version management functionality, supporting all official version types and integrating one-click installation of four major ModLoaders. This chapter will detail the version list usage, version installation and deletion, ModLoader installation, and the version isolation mechanism.

Version List ​

VoxVer Launcher fetches the official Minecraft version list from the BMCLAPI mirror, covering all historical versions.

Refresh Version List ​

  1. Go to the Versions page
  2. Click the "Refresh Version List" button
  3. VoxVer Launcher will pull the latest version metadata from the remote server
  4. After refreshing, the version list will be grouped by type

Version Type Description ​

Version TypeDescriptionStability
ReleaseFully tested stable versionsHigh, recommended for use
SnapshotDevelopment preview of the next releaseMedium, may contain bugs
Old VersionEarly historical versions such as Alpha / BetaLow, for nostalgia only
April FoolsJoke versions released on April 1st each yearLow, for entertainment only

Install Version ​

Installation Steps ​

  1. Find the desired version in the version list
  2. Click the "Install" button next to that version
  3. VoxVer Launcher starts downloading the game core files, including:
    • Game main program JAR file
    • Game library files (libraries)
    • Asset files (assets)
    • Native library files (natives)
  4. Download progress is displayed in real time in the global download popup at the bottom right
  5. Once the download is complete, the version status updates to "Installed"

Note

After installation, game files are saved in the versions/<version name>/ folder under the game directory. The first installation typically requires downloading 200MB - 500MB of files, depending on the version.

Version Isolation ​

Version isolation is an important feature of VoxVer Launcher. It allows each game version to have its own independent runtime environment, preventing mods, configurations, and saves from interfering with each other across different versions.

Isolation Mechanism Description ​

Isolated ContentDescription
Game filesEach version has its own independent JAR and JSON files
Mod filesEach version has its own independent mods/ directory
Configuration filesEach version has its own independent config/ directory
Save dataEach version has its own independent saves/ directory
Resource packsEach version has its own independent resourcepacks/ directory

Tip

If you are using the Instance System, each instance has full version isolation enabled by default. You can also enable isolation for a specific version individually in version management.

Install ModLoader ​

ModLoaders are essential tools for loading and managing game mods. VoxVer Launcher supports one-click installation of four major ModLoaders.

Installation Steps ​

  1. Find the installed vanilla game on the Versions page
  2. Click the "Install ModLoader" button next to that version
  3. Select the ModLoader type from the popup dialog
  4. Choose the corresponding version number (usually "Latest" and "Recommended" options are available)
  5. Click confirm and wait for the installation to complete
  6. Installation progress is pushed to the frontend in real time

Supported ModLoaders ​

ModLoaderCurrent Maintenance StatusSupported Game VersionsFeatures
FabricActively maintained1.14+Lightweight, fast loading, broad mod compatibility, active community
ForgeActively maintained1.7.10+Established loader, mature ecosystem, excellent support for large mods
NeoForgeActively maintained1.20.1+The new successor to Forge, rebuilt for newer versions, better performance
QuiltActively maintained1.14+A fork of Fabric, more modular design, provides additional API extensions

Selection Guide

  • New players: Fabric is recommended for its simple installation and good mod compatibility.
  • Large modpack players: Forge or NeoForge are recommended for better support of large mods.
  • Pursuing the latest version: NeoForge is recommended for the fastest support of new versions.
  • Advanced users: You can try Quilt for a more modular API design.

Note

  • Different versions of ModLoaders only support corresponding game version ranges. Please verify compatibility before installation.
  • Only one ModLoader can be installed per game version. To switch, uninstall the current ModLoader first before reinstalling.
  • After installing a ModLoader, the launcher will automatically create the corresponding configuration files and directory structure.

Delete Version ​

If you no longer need a particular game version, you can delete it to free up disk space.

Deletion Steps ​

  1. Go to the Versions page
  2. Find the installed version you want to delete
  3. Click the "Delete" button next to that version
  4. Click "Confirm" in the confirmation dialog

Deletion Considerations ​

ItemDeleted?Description
Game core files (JAR/JSON)YesCore files under the version directory will be removed
ModLoader for this versionYesAssociated ModLoader files will also be cleaned up
Instance dataNoData in the instance system is not affected
Save filesDependsIf version isolation is enabled, saves for this version will also be deleted
Shared resource filesNoShared files in the assets and libraries directories will not be deleted

Important Reminder

Before deleting a version, make sure there is no important save data under that version. It is recommended to back up your saves before proceeding with deletion.