Skip to main content
← All Guides
Troubleshooting · 8 min read

Minecraft Troubleshooting Guide: Every Error and Fix

Complete Minecraft troubleshooting hub. Find fixes for crashes, connection errors, performance issues, mod conflicts, server problems, and launch failures.

Minecraft Troubleshooting Guide: Every Error and Fix

This hub collects every Minecraft troubleshooting guide we have published. Use the categories below to jump to the section that matches your problem. Each guide contains the exact error message, a quick fix, step-by-step diagnosis, and answers to frequently asked questions.

All guides target Minecraft Java Edition 1.21+ unless stated otherwise. Server-specific guides assume Paper or Spigot. Client-specific guides cover the official launcher and popular third-party launchers.

How to Use This Guide

  1. Find your error message or symptom in the categories below.
  2. Click the link to go to the full guide.
  3. Follow the Quick Fix first. If that does not resolve it, work through the Step-by-Step Diagnosis.
  4. If your issue is not listed, check the server or client logs for the exact error message and search for it on this page.

Crashes Issues

Connection Issues

Performance Issues

Mods Issues

Server Issues

Launch Issues

Other Issues

General Troubleshooting Steps

If your specific error is not listed above, follow this general diagnostic process:

  1. Read the log. Every Minecraft error is logged. Check .minecraft/logs/latest.log (client) or logs/latest.log (server) for the first ERROR or FATAL line.
  2. Read the crash report. If a crash report was generated in crash-reports/, the top of the file contains the exception and a description of what failed.
  3. Search for the exact error message. Copy the first line of the exception (like java.lang.NullPointerException) and search for it. Include "Minecraft" and your version number.
  4. Test without mods. Move the mods/ or plugins/ folder and test. If the problem disappears, a mod or plugin is the cause.
  5. Test with a fresh profile. Create a new launcher profile or a new server directory. If the problem disappears, something in your existing configuration is corrupt.
  6. Update everything. Java, GPU drivers, the game version, mod loader version, and all mods/plugins. Many issues are fixed in updates.

When to Ask for Help

If you have followed the relevant guide and the problem persists:

  • Collect your crash report, latest.log, and a list of installed mods/plugins.
  • Note your Java version (java -version), Minecraft version, and mod loader version.
  • Post on the server's Discord, the Minecraft subreddit, or the mod/plugin's issue tracker with all of this information.

FAQ

How do I find my Minecraft logs?

Client: .minecraft/logs/latest.log. On Windows, press Win+R and type %appdata%\.minecraft\logs. On macOS: ~/Library/Application Support/minecraft/logs. On Linux: ~/.minecraft/logs.

Where are crash reports stored?

Client: .minecraft/crash-reports/. Server: crash-reports/ in the server directory. Files are named with the date and time of the crash.

Should I use Forge or Fabric?

For Minecraft 1.21+, Fabric generally has better performance and faster updates. Forge (and its successor NeoForge) has a larger mod library for older versions. Choose based on which mods you want to use.

What Java version do I need?

Minecraft 1.21+ requires Java 21. Minecraft 1.17-1.20 requires Java 17. Minecraft 1.16 and older requires Java 8. Always use 64-bit Java.

Need a server that handles all this? Astroworld Hosting, NVMe SSDs, Pterodactyl panel, DDoS protection on every plan.

Related Tools & Resources

🔧

Minecraft Tools

Calculators, generators & server tools

🧱

Item Database

Browse all Minecraft items, stats & recipes

⚒️

Crafting Recipes

Visual crafting guides for every recipe