Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.
“A JNI error has occurred” is a generic Java startup warning, not the diagnosis. The exception immediately below it tells you what to fix. If the log contains UnsupportedClassVersionError, the Java runtime that actually launched Minecraft is older than the version used to compile the game or mod, or the launcher/server selected the wrong executable. Other exceptions point to JVM options, missing files, permissions, native libraries, or downloads instead.
Record the exact Minecraft release, whether this is the client or a server, and the way it was started. Then inspect the full error, match that release to its Java requirement, correct the executable used by that launch path, and restart the same profile or service to verify the result.
PC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteAs an Amazon Associate I earn from qualifying purchases.
What does “A JNI error has occurred” mean in Minecraft?
JNI is Java’s interface for connecting Java code with native operating-system code. Minecraft’s launcher prints the JNI line when Java cannot complete startup, but that line is shared by many unrelated failures. The useful evidence is the first exception after it and every subsequent Caused by line.
A message such as java.lang.UnsupportedClassVersionError is a class-version mismatch. A message about creating the Java Virtual Machine concerns JVM arguments or memory settings. A missing file, access-denied, native-library, or authentication message requires a different remedy. Do not change Java versions simply because the word “JNI” appears.
Popular on Amazon
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
Which details should I capture before changing anything?
Write down enough context to reproduce the same failure. This prevents you from repairing one Java installation while Minecraft continues to use another.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Repair Windows errors before they cause bigger problemsFix Now →- The complete Minecraft version, including a point release such as 1.20.4 or 1.20.5.
- Whether the failure is the Java Edition client, a local server, a modded profile, or a remotely hosted server.
- Your operating system and whether Java and the operating system are 32-bit or 64-bit where the error mentions architecture.
- How you started it: the official Launcher, a third-party launcher, a batch or shell script, a scheduled task, a system service, or a hosting control panel.
- The complete terminal or launcher log, including the first exception and all
Caused bylines.
Keep the original log in a separate file. If a runtime change causes a different error, the new exception is the one to investigate.
How do I tell whether this is a Java-version mismatch?
Look specifically for UnsupportedClassVersionError or wording such as “class file version X … recognizes up to Y.” The numbers identify the compiler level and the maximum class level accepted by the runtime.
| Log wording | What it means | Typical action |
|---|---|---|
class file version 61.0 ... recognizes up to 52.0 |
The program contains Java 17 class files, while the runtime supports only Java 8. | Use a Java 17-or-newer runtime for a release that requires it, or select the runtime required by that specific older profile. |
UnsupportedClassVersionError without those numbers |
The selected Java major version is too old for the game, loader, or mod. | Identify the exact release and inspect the executable selected by the launch path. |
| No class-version exception | The JNI headline is not enough to diagnose Java age. | Follow the named exception instead of forcing a version upgrade. |
The 61-versus-52 example is a Java 17 program being started on Java 8. It does not mean every Minecraft release needs Java 17; it describes the particular class files in that failure.
What Java version does each Minecraft release need?
Java requirements are release-specific. Use Mojang’s documentation for the exact release whenever it is available, especially for snapshots, loaders, and newly published versions.
Also popular on Amazon
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
| Minecraft release or range | Java guidance | Evidence and limits |
|---|---|---|
| Java Edition 1.18 | Java 17 or above for custom Java setups and third-party launchers. | Mojang’s 1.18 release documentation states that users with a custom setup or third-party launcher must ensure Java is version 17 or above. The default Launcher downloads and installs the correct version. |
| Java Edition 1.18–1.20.4 | Java 17 | A community compatibility chart lists this range; verify the exact release rather than treating the chart as an official guarantee. |
| Java Edition 1.20.5 and later versions covered by that chart | Java 21 | The same community chart gives this guidance for its covered versions. Check the release’s own notes when available. |
| Java Edition 26.1 | Java 25 | Mojang’s Technical Changes for 26.1, published March 24, 2026, says “The game now requires Java 25.” Its included distribution is Microsoft OpenJDK 25. |
| Older Forge profiles | May require Java 8 | Legacy Forge environments can depend on Java 8. Installing the newest Java globally is not a universal fix for old modpacks. |
“Java 17 or above” is a minimum for the cited 1.18 custom setup, not a promise that every newer or modded combination will work. Conversely, Java 25 is required for 26.1, but that requirement cannot be applied retroactively to every release.
Why does java -version look correct while Minecraft still fails?
A terminal command reports the Java found through that shell’s PATH. A launcher profile, server script, service, scheduled task, or hosting panel can point to a different executable. You can therefore install Java 17, run java -version, and still launch Minecraft with an older Java 8 binary.
Check the executable used by the failing path itself. In a local shell, identify the resolved binary with the operating system’s command lookup, then run that exact file with -version. A script that contains only java can silently select another installation; an explicit full path removes that ambiguity.
java -versionFor a launcher, copy the full Java executable path shown in the instance or installation settings and run that path with -version. Compare its major version with the Minecraft release requirement, not merely with the Java version installed elsewhere on the computer.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
How do I fix the official Minecraft Launcher?
Repair the installation profile that fails, not just the operating system’s default Java.
Also popular on Amazon
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
- Open the official Launcher and go to the installations list.
- Select the installation profile for the exact Minecraft release that produces the error.
- Open its settings and inspect the Java executable or runtime field. If you manually entered a path, note it before changing anything.
- For Minecraft 1.18, restore the Launcher-managed runtime unless you have a specific reason to use a custom one; Mojang says the default Launcher supplies the appropriate Java.
- For 26.1, ensure the profile uses a Java 25 runtime. A profile pinned to Java 17 or 21 will not satisfy that release.
- Save the profile, close the Launcher completely, reopen it, and start that same installation.
If the error changes after the runtime correction, stop treating it as a class-version mismatch and follow the new exception. A successful Java selection can expose a separate mod, memory, or file problem that was previously hidden.
How do I fix a third-party launcher or modded instance?
Third-party launchers usually store a Java setting per instance. Changing a global preference may leave the failing profile untouched.
- Open the settings for the specific instance, not only the launcher-wide settings.
- Copy the complete Java executable path currently selected.
- Run that exact executable with
-versionand record the reported major version. - Choose a runtime compatible with the Minecraft, Forge, Fabric, or other loader version in that instance.
- Check old modpacks separately. An older Forge profile can require Java 8 even when a newer unmodded profile needs Java 17 or 21.
- Launch the same instance again and retain the new log if the exception changes.
Do not assume that “latest Java” is safest. A loader may depend on an older runtime, while a current game release may refuse an older one. The exact game-loader combination determines the choice.
Recommended Free Tools
How do I fix a local Minecraft server?
Inspect the command that actually starts the server. The relevant setting may be in a Windows batch file, a Unix shell script, a scheduled task, a service definition, or a panel-generated command.
- Open the startup script or service configuration and locate the Java command.
- If it uses only
java, determine which binary that environment resolves, rather than relying on an interactive terminal check. - Run the selected executable with
-version. - Replace the bare command with the full path to the required Java executable when multiple installations exist.
- Review JVM flags at the same time. Do not copy options from another Minecraft release; an option accepted by one Java version can produce “Could not create the Java Virtual Machine” on another.
- Restart the server through the same script, task, or service used in normal operation.
A server launched as a service may have a different account, environment variables, and working directory from your login shell. That is why a manual terminal test can pass while the service continues to fail.
Also popular on Amazon
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
How do I fix a hosted Minecraft server?
On a hosted server, the runtime belongs to the host’s machine or container. Installing Java on your personal computer cannot change it.
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →- Open the hosting panel’s server settings or startup configuration.
- Find the Java-version selector, runtime image, or container image setting.
- Choose the major version required by the exact Minecraft and loader release.
- Apply the change and restart the server from the panel.
- Read the new console log. If the host does not offer the needed version, ask support which images are available or migrate the server files to an environment that does.
For a remote server, the path and version shown in your local terminal are irrelevant unless you are also running a local client or local server.
What should I do when the exception is not UnsupportedClassVersionError?
Use the named failure as the decision point. The following branches prevent an unnecessary Java reinstall.
Could not create the Java Virtual Machine: inspect memory limits and every JVM option. Remove or update flags that the selected Java version does not recognize, then test with the simplest supported startup command.- Missing-file or permission text: verify the profile directory, server working directory, file permissions, and any antivirus quarantine named in the message. Restoring Java will not recreate a deleted library or grant access to a protected folder.
- Native-library or architecture text: compare the operating-system architecture, Java architecture, and the named native library. Follow that library’s error rather than changing the Minecraft release at random.
- Launcher download or authentication text: repair the account session, network path, or download location identified by the launcher. A download failure is not evidence of an incompatible Java class file.
How can I verify that the fix really worked?
Verification must use the same launch path that originally failed.
- Close the launcher, terminal, service, or panel session that may have cached the old process.
- Start the identical profile, script, task, or hosted server with the corrected runtime.
- Check the fresh log for the original exception. Its absence is more useful than a successful Java check in an unrelated terminal.
- If another exception appears, classify that new message using the branches above.
- Keep the working executable path and release-to-Java pairing documented for future profile or modpack changes.
Why does installing Java 17 or Java 21 sometimes fail to solve it?
There are four common reasons: the launcher still points to an older executable, the server is remote, the release requires a different major version, or the original exception was not a class-version problem. Minecraft 26.1 requires Java 25, while an old Forge profile may require Java 8. A system-wide installation changes none of those per-profile or per-host selections automatically.
Also popular on Amazon
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
The reliable comparison is always the same: who controls Java, which exact Minecraft and loader release is running, which major version the selected executable reports, and what exception follows the JNI line.
What is the shortest safe troubleshooting checklist?
- Capture the full log and the first exception.
- Confirm the exact Minecraft release and launch method.
- Check the Java executable selected by that method, not only the system default.
- Match the release to its documented Java requirement.
- Use an explicit executable path when multiple Java installations exist.
- Restart the same profile, script, service, or hosting panel.
- Follow any new exception on its own terms.
Frequently Asked Questions
Can I keep several Java versions installed on one computer?
Yes. Multiple Java installations can coexist; the important control is which executable each launcher profile, script, or service selects. Keep separate paths documented and avoid assuming that changing the system PATH updates every Minecraft installation.
Does reinstalling the Minecraft Launcher automatically repair the Java path?
Not necessarily. A profile with a manually overridden executable can retain that override, and a server or third-party launcher has its own runtime setting. Inspect the failing profile or startup command before reinstalling software.
Can a Minecraft server and client use different Java versions?
Yes. They are separate processes and can select different runtimes, provided each runtime satisfies its own Minecraft and loader requirements. This is common when a current client is used with a legacy modded server.
What if the log shows both a JNI line and several different exceptions?
Start with the first exception after the JNI warning and read each Caused by line in order. Later messages may be consequences of the first failure, so changing Java for a secondary message can obscure the actual cause.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
