Skip to main content

Using custom Java versions

Legacy Launcher uses Mojang's recommended Java builds by Microsoft. This guide will help you to replace these Java versions with the ones of your choice.

info

This page requires localization of screenshots. Feel free to open PR if you want to help

How to?​

  1. Install required Minecraft version
  2. Open launcher settings, select "Minecraft" tab and open Java settings Settings => Minecraft => Java => Java => "Customize"
  3. Select "Recommended" option Select "Recommended" Java
  4. Click "open folder" Open folder
  5. In the folder, create a file named override, e.g. override.txt Creating an override file
  6. Done! This Java version is customized, and can be freely modified or replaced
Where I can get alternative Java distributions?

You can download alternate Java distributions from their developers' websites, such as Temurin and Azul. You should download the archive, not the installer.

Simplified method​

Due to complaints about the stability of Mojang recommended Java builds we have prepared a ready-to-use package to replace Java with more stable ones.

  1. Download the archive:
  2. Open the launcher settings, select "Minecraft" tab and go to Java settings Settings => Minecraft => Java => Java => "Customize".
  3. In the window that opens, select the "Recommended" option Select "Recommended" Java
  4. Click "Open Folder" Open folder
  5. In the opened folder, twice move up a level.
    tip

    If you see folders named java-runtime-alpha, java-runtime-beta, java-runtime-gamma, jre-legacy then you have done everything correctly

    warning

    If you see the .version file next to a folder and/or don't see any other Java folders, or see lib and bin folders - you're probably in the wrong folder

  6. Replace folder contents with the one from the downloaded archive.
  7. Run the launcher and the game