Installing Java

Java is required in order to run Minecraft. As such, until Java downloading is implemented, you will need to manually install Java to run Minecraft with Prism Launcher.

Oracle Java is not recommended. As of 2019, it has licensing that prohibits certain uses, and it requires an account to download certain versions. Their downloads are intended for those who have purchased a support contract from Oracle.

Instead, this guide recommends installing OpenJDK from one of the reputable vendors. OpenJDK is a source code only distribution of Java made by a collaboration between Oracle and industry partners such as Adoptium, Microsoft, Red Hat, and Azul. Unlike Oracle Java, it is released under a license that minimizes legal risk for users and does not require payment.

If you would like to learn more about OpenJDK and the vendors mentioned in this page, here are their websites:

Otherwise, continue reading for quick download links and a guide for which one to choose.

Selecting Java

Once you have installed Java, Prism Launcher will be able to detect it during the first time set-up wizard.

If you installed Java after already completing the first time setup process, you can access and modify your Java configuration globally for all instances through:

Settings > Java > Java Runtime > Auto-Detect...

or for a specific instance:

Right click an instance > Edit > Settings > Java > Java installation > Auto-Detect...

If you have just installed a version of Java and it doesn't show up, try pressing Refresh or restart the launcher. If you don't have your desired Java version installed, keep reading.

Installing Java on Windows

First, check your CPU architecture. Here is a method that works on all Windows versions:

  1. Click or tap on the Start Menu
  2. Search Command Prompt or Terminal and click on it
  3. Type in echo %PROCESSOR_ARCHITECTURE% and press enter
  4. Read the result.
    • If it says AMD64, you have a 64-bit x86-64 CPU. This is sometimes called x64 or amd64.
    • If it says X86, you have a 32-bit x86 CPU. This is sometimes called x32 or x86-32.
    • If it says ARM64, you have a 64-bit ARM CPU. This is sometimes called aarch64 or ARM64.

Then, download the appropriate Java:

Minecraft CPU type Download page Viable alternatives
Minecraft 1.20.5 or above x86-64 Microsoft OpenJDK 21 for Windows x64, .msi installer Azul, Coretto, Temurin, GraalVM
x86 Not available :(
aarch64 Microsoft OpenJDK 21 for Windows aarch64, .msi installer Azul
Minecraft 1.17 to 1.20.4 x86-64 Microsoft OpenJDK 17 for Windows x64, .msi installer Azul, Coretto, Temurin, GraalVM
x86 Temurin OpenJDK 17 for Windows x32, .msi installer Azul, Coretto
aarch64 Microsoft OpenJDK 17 for Windows aarch64, .msi installer Azul
Minecraft 1.16 or below x86-64 Temurin OpenJDK 8 for Windows x64, .msi installer Azul, Coretto
x86 Temurin OpenJDK 8 for Windows x64, .msi installer Azul, Coretto
aarch64 Not available :(

Tip: If you are on Windows 11, you can automatically install 8, 17 and 21 by running winget install Microsoft.OpenJDK.21; winget install Microsoft.OpenJDK.17; winget install EclipseAdoptium.Temurin.8.JDK in the Terminal app.

Installing Java on macOS

First, check your CPU architecture.

  1. Open the Apple menu in the top left corner of the screen
  2. Click "About This Mac"
  3. Check what it says after "Processor"
    • If it contains Intel, you have a 64-bit x86-64 CPU. This is sometimes called x64 or amd64.
    • If it contains Apple, you have a 64-bit ARM CPU. This is sometimes called aarch64 or ARM64.

Then, download the appropriate Java:

Minecraft CPU type Download page Viable alternatives
Minecraft 1.20.5 or above x86-64 Microsoft OpenJDK 21 for macOS x64, .pkg installer Azul, Coretto, Temurin, GraalVM
aarch64 Microsoft OpenJDK 21 for macOS aarch64, .pkg installer Azul, Coretto
Minecraft 1.17 to 1.20.4 x86-64 Microsoft OpenJDK 17 for macOS x64, .pkg installer Azul, Coretto, Temurin, GraalVM
aarch64 Microsoft OpenJDK 17 for macOS aarch64, .pkg installer Azul, Coretto
Minecraft 1.16 or below x86-64 Temurin OpenJDK 8 for macOS x64, .pkg installer Azul, Coretto
aarch64 Azul OpenJDK 8 for macOS aarch64, .dmg installer Coretto

Installing Java on Linux

On Linux, it's recommended to use your package manager for installing Java.

Fedora, RHEL, CentOS, AlmaLinux, or RockyLinux

On the COPR package all required Java versions should be installed, but this is the command to install it:

sudo dnf install java-1.8.0-openjdk java-17-openjdk java-21-openjdk

Void Linux

sudo xbps-install openjdk17-jre openjdk8-jre openjdk21-jre 

Arch Linux, Manjaro, EndeavorOS, Garuda

sudo pacman -S jre17-openjdk jre8-openjdk jre21-openjdk

Ubuntu, Pop!_OS, Linux Mint, Zorin OS, or elementaryOS

sudo apt install openjdk-17-jre openjdk-8-jre openjdk-21-jre

Debian, MX Linux

sudo apt install openjdk-17-jre openjdk-21-jre

Java 8 is not available in Debian 10+ due to lack of security support, but you can use the Adoptium repository for security support until 2026:

wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add -
sudo add-apt-repository --yes https://packages.adoptium.net/artifactory/deb/
sudo apt-get update && sudo apt-get install temurin-8-jdk

Alpine Linux

sudo apk add openjdk17 openjdk8

Flatpak

The Prism Launcher Flatpak already bundles Java.

NixOS

The Prism Launcher NixOS package already bundles Java.

Special cases

Forge 1.16.5 and Java 8u321+

Old versions of Forge crash with Java 8u321+. For this reason, using Java 8u312 or lower is recommended

A note about Intel HD 2000/3000 on Windows 10

Since those iGPUs are not officially supported on Windows 10, with them the game is likely going to crash with any modern java binary.

For 1.16.5 or older there's a workaround, you need to install an older java binary (note: these links are official MultiMC links, and we can't guarantee the safety of the content on them):

After you download the required java binary for your architecture, extract the zip, and move the folder to your Prism Launcher data folder (%appdata%/Prism Launcher for non-portable, the Prism Launcher folder for portable builds), you need to go to the Prism Launcher java settings, then to browse, then go to the folder with this particular java, click java.exe then open.
This should fix your issue.
Unfortunately there's no workaround for java 17 (and so newer Minecraft), so you can only downgrade your Windows or switch to Linux there.
If you want to try, there's this guide that could work. Nothing is guaranteed here, though.

Older Minecraft on MacOS

If you use some older Minecraft versions, you might have had this error:

Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'NSWindow drag regions should only be invalidated on the Main Thread!'

Here is a fix:


Pages in Getting Started:

Comment Rules

By submitting a comment, you agree to uphold the Prism Launcher Code of Conduct.

✅ What user-contributed comments are for

  • Share additional information relevant to the article.
  • Mention a workaround for a common issue.
  • Link to useful third-party resources that are relevant to the current page, such as tutorials or articles.
    • It is allowed to occasionally link to resources you've created. When doing so, you must disclose your affiliation with the resource in some way. However, linking to resources you've created should not represent the majority of your interactions with user notes. Excessive self-promotion is not allowed and will be moderated away.

🚫 What user-contributed comments are not for

Comments not following the above rules will be removed.

Licensing of user-contributed comments

Launcher contributors may occasionally go through the comments and may incorporate information from them in the documentation. By submitting a comment, you accept that it may be incorporated in unmodified or modified form in the launcher and/or documentation, subject to the GPL-3.0 license for the launcher and AGPL-3.0 license for the documentation.