Skip to content
Try a Minecraft server free. No card needed.48 hours free
AwakeNode
Find my serverMinecraft plansFree trialPay-to-PlayWikiSupport
Legacy billingClient DashboardView plans
Guides

Guide

Which Java version does my Minecraft server need?

The Java version each Minecraft version needs, how to change it, and the errors you see when it's wrong.

AwakeNode Team · Updated 5 Nov 2026

Minecraft and its mods are written in Java, and each Minecraft version needs a particular Java version. The wrong one is one of the most common reasons a server won't start.

The short answer

Minecraft versionJava
26.1 and newer25
1.20.5 to 1.21.x21
1.18 to 1.20.417
1.1716 or 17
1.12 to 1.16.58 (some modded 1.16.5 packs run on 11)

Future Minecraft releases may need newer Java again. The error message always says which version is needed.

Change it

Open the Startup tab, choose the Java version and restart the server. You can pick Java 8, 11, 17, 21 or 25.

Signs it's wrong

Too old:

java.lang.UnsupportedClassVersionError: ... has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 61.0

The class file version tells you what's needed: 61 is Java 17, 65 is Java 21, 69 is Java 25. See UnsupportedClassVersionError.

Too new (mostly old Forge versions on 1.16.5 and earlier): crashes mentioning ClassCastException with class loaders, or "Unsupported Java version" from the loader. Go back to Java 8.

Plugins and mods

A plugin or mod built for a newer Java than your server runs fails with the same UnsupportedClassVersionError, naming that plugin. Either run a newer Java (if your Minecraft version allows it) or use an older build of the plugin.

Questions

Should I always use the newest Java?+

Use the newest one your Minecraft version and mods support. Very old versions, especially older Forge, break on new Java.

Do players need the same Java?+

No. The Minecraft Launcher brings its own Java for players. This only matters for the server.

More guides

The Top 10 Fabric Optimization Mods to Boost Server TPSBoost your Minecraft server's performance with our curated list of the top 10 Fabric optimization mods, designed to improve TPS and reduce lag.Best optimization mods Fabric 2026Boost your Minecraft Fabric server performance in 2026. Learn which optimization mods provide the best FPS and TPS gains for your AwakeNode server.How to Monetize Your Minecraft Server Without Breaking the EULALearn how to monetize your Minecraft server while staying compliant with Mojang's EULA. Discover acceptable donation models and avoid common pitfalls.Minecraft server Java 25 error fixLearn how to resolve Java 25 compatibility errors on your Minecraft server. Follow our guide to ensure your server version matches your Java runtime.

On this page

  • The short answer
  • Change it
  • Signs it's wrong
  • Plugins and mods

Start a Minecraft server

Java or Bedrock, vanilla or modded, with a console, file manager and backups.

See plans
AwakeNode

Minecraft server hosting in UK or EU locations. Built by players, for players.

Open a support ticket

Minecraft

  • Minecraft plans
  • Modpack servers
  • Pay-to-Play with friends
  • 48-hour free trial
  • Common questions

Support

  • Wiki and guides
  • Client Dashboard
  • Open a support ticket
  • Legacy game panel (existing servers)
  • Legacy billing (existing accounts)

Company

  • Contact us
  • VPS hosting
  • Terms of service
  • Privacy policy
  • Uptime SLA
  • AwakeNode is a trading name of Falcon Hosting Ltd.
    © 2026 Falcon Hosting Ltd.

    Registered in England & Wales · Company No. 15676555 · ICO registration ZB377567
    Registered office: Anglo Dal House, 5 Spring Villa Park, Spring Villa Road, Edgware, Middlesex, HA8 7EB, United Kingdom