Troubleshooting

Modded Minecraft can be incredibly complex. Modpacks with upwards of 300 mods exist and it's impossible for every mod interaction to be vetted ahead of time. In addition, individual hardware and software configurations, driver versions, and other independent factors can all impact stability. As such, crashes can and do happen. This page tries to distill common scenarios and baseline knowledge for troubleshooting crashes you're experiencing to get you back into your Minecraft world as quickly as possible.

Crash Logs
If you are experiencing game crashes while playing modded Minecraft, the best source of information as to what is happening is the crash log files. There are a couple different files that you may need to look through before finding the information you need.

There are two folders which might contain relevant information. If you are experiencing an actual crash, the crash-reports folder will have a file starting with crash- and then a time stamp of the crash so you can easily determine which file contains the information for that crash.

If that file doesn't have useful information, doesn't exist, or you're not experiencing a full crash, the next place you want to check is the logs folder. This folder holds the logs generated by Minecraft as it runs, and there is a new one generated each time you launch Minecraft. As such, there are many more files here and older ones are archived and zipped up, so you might have to do a little more hunting to find the correct file, but usually latest.log is what you're looking for. A dedicated server will have fml-server-latest.log instead.

Please remember to share your logs on a paste site.

FTB App
Feed The Beast Knowledge Base - How do I find my client logs?

CurseForge App

 * 1) Open the CurseForge App and right click the modpack profile
 * 2) Select Open folder
 * 3) Open either the logs folder or the crash-reports folder
 * 4) *For crash reports, the file you want is the latest crash report
 * 5) *For logs, the file you want is either latest.log OR debug

More information can be found from documentation such as CreeperHost.

Prism Launcher

 * 1) Open Prism Launcher and select the modpack instance.
 * 2) Select Edit in the right panel.
 * 3) In the new window, select Other logs at the bottom of the left panel.
 * 4) * The latest crash report will be shown here.
 * 5) * Additional logs can be viewed by selecting the dropdown that is the log name.
 * 6) Select Upload to automatically create and copy-to-clipboard a log report on mclo.gs.

GDLauncher
See the GDLauncher Wiki for more information
 * 1) Open GDLauncher and right click on the modpack instance
 * 2) Select Open folder
 * 3) Open either the logs folder or the crash-reports folder
 * 4) *For crash reports, the file you want is the latest crash report
 * 5) *For logs, the file you want is either latest.log OR debug

Other
If you are using a different launcher or none at all, you will need to be able to locate your Minecraft modpack directory on your own. Once you do, the same folder structure as described above should exist and you should be able to hunt down your crash logs without issue.

Sharing Logs
If you need to share your log with the community so you can get assistance with someone else, please do not copy and paste it into a discussion thread. The logs are large and if you try to prune them you may omit important details, and some websites mess up the formatting. Instead, share the file via a paste service, of which there are many. Here are a few in no particular order: Once you've put the file on one of these sites, you can simply share the link to the paste rather than the whole file. Also, please note that it is simpler if you use one of these services rather than something like Dropbox, Google Drive, or OneDrive. While these are great for sharing other data, they're overly complex for this purpose and are the reason the sites above are available.
 * mclo.gs
 * FTB Paste
 * Pastebin
 * Ubuntu Paste
 * Paste.ee
 * GitHub Gist

Interpreting Crash Logs
Understanding all of the details of a crash log is far beyond the scope of this tutorial page, but is also unnecessary in a lot of cases. Try the following to be able to help yourself solve a problem quicker than waiting on help from the internet!

A Java Stacktrace
When Minecraft crashes, it produces what is known as a stacktrace. Put simply, this is a list of what Minecraft was trying to do when things went wrong. Here is a pruned example of one: Minecraft Crash Report // Uh... Did I do that?

Time: 26/02/16 11:04 PM Description: Ticking block entity

java.lang.NoSuchMethodError: appeng.api.features.IInscriberRegistry.getRecipesLjava/util/List; at net.bdew.ae2stuff.machines.inscriber.TileInscriber.findFinalRecipe(TileInscriber.scala:128) at net.bdew.ae2stuff.machines.inscriber.TileInscriber$$anonfun$1.apply$mcV$sp(TileInscriber.scala:59) at net.bdew.lib.Event0$$anonfun$trigger$1.apply(Event.scala:19) at net.bdew.lib.Event0$$anonfun$trigger$1.apply(Event.scala:19) at scala.collection.immutable.List.foreach(List.scala:383) at net.bdew.lib.Event0.trigger(Event.scala:19) at net.bdew.lib.tile.TileExtended.func_145845_h(TileExtended.scala:63) at net.minecraft.world.World.func_72939_s(World.java:1939) at net.minecraft.world.WorldServer.func_72939_s(WorldServer.java:489) at net.minecraft.server.MinecraftServer.func_71190_q(MinecraftServer.java:636) at net.minecraft.server.dedicated.DedicatedServer.func_71190_q(DedicatedServer.java:334) at net.minecraft.server.MinecraftServer.func_71217_p(MinecraftServer.java:547) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:427) at net.minecraft.server.MinecraftServer$2.run(MinecraftServer.java:685) This looks like a big mess but there are a few hints as to what's going on. First of all, the Description line tells us that the problem is with a "Ticking block entity" - ticking essentially refers to something doing the work that it does (i.e. when a furnace "ticks" it makes a bit of progress towards processing the item it's working on) and a block is simply that, a block in the world.

The really important pieces are here: java.lang.NoSuchMethodError: appeng.api.features.IInscriberRegistry.getRecipesLjava/util/List; at net.bdew.ae2stuff.machines.inscriber.TileInscriber.findFinalRecipe(TileInscriber.scala:128) This information is going to get us 90% towards understanding what's going on. In the first line, we see a mention of "IInscriberRegistry" which could mean absolutely anything, but what was I doing when this crash occurred? Oh, I was interacting with an Advanced Inscriber from AE2 Stuff! The second line confirms that as it shows the issue was in "net.bdew.ae2stuff.machines.inscriber...". At this point there's a hint at what's going on, but what can be done about it?

Dealing with the issue
This section is not called Solving the issue because sometimes you simply cannot solve the problem and it's out of your hands. Instead, what should we do to deal with this issue? These are in order of general effectiveness, but of course there are caveats for every step. Updating the mod is usually the simplest solution but is not always practical, especially if you're playing on a server with a modpack that you do not control. At the end of the day, you're going to have to decide how you deal with it. The next section goes into detail on dealing with a specific type of crash.
 * 1) Check for an updated version of the mod
 * 2) Check to see if the issue has been reported to the mod author and if not, do so. If it was, can you provide additional detail?
 * 3) If the bug was reported, is there a workaround?
 * 4) If possible, just avoid doing the thing that causes the crash

Updating Java
Keeping your Java up to date can have a few benefits, including getting access to the latest performance increases as well as bug and security fixes. Step by step instructions on how to update your particular system are beyond the scope of this document but you can start at java.com. Please note, if your system supports it (which most modern systems should), you should be using 64-bit Java.

FTB App
The FTB App bundles its own Java to ensure that there are no external requirements beyond the app to run Minecraft. However, this means that if you update Java on your system, it will be ignored by instances launched through the FTB App. Normally this is not a problem, but if you are experiencing an issue and would like to update the Java that an instance in the FTB App uses, you can do the following:


 * 1) Open the FTB App
 * 2) Open an instance page by clicking on the picture
 * 3) Click on 'Settings'
 * 4) Click on either the Java version combobox or the 'Browse' button

At this point your Minecraft instances launched through the FTB App should be using the Java version you changed to. You can verify this from within Minecraft by looking at the debug screen, typically bound to the F3 key.

Removing crashing entities
Having gotten to the point where we understand what mod is causing the issue, in certain cases there is a straightforward solution to the problem.

Automatically
Forge includes two configuration options for automatically removing crashing entities, and crashing tile entities. If you open your modpack folder, go into the config folder, and open forge.cfg, under the general section you should find the following lines: # Set this to true to remove any Entity that throws an error in its update method instead of closing the server and reporting a crash log. BE WARNED THIS COULD SCREW UP EVERYTHING USE SPARINGLY WE ARE NOT RESPONSIBLE FOR DAMAGES. B:removeErroringEntities=false

# Set this to true to remove any TileEntity that throws an error in its update method instead of closing the server and reporting a crash log. BE WARNED THIS COULD SCREW UP EVERYTHING USE SPARINGLY WE ARE NOT RESPONSIBLE FOR DAMAGES. B:removeErroringTileEntities=false When you change these from false to true, the next time you start your world any entities or tile entities that were going to cause a crash will simply be removed. Note the warnings in the comments before each option, and heed them. These should only be enabled when necessary, not all the time.

Manually
Dealing with removing broken blocks or items from the world manually is beyond the scope of this document. However, the tools to do these things should be mentioned. If you are dealing with a block in the world that is causing a crash and you want to remove it, you can use MCEdit to edit the world while it is offline. Find it at the MCEdit site. If there is a problem with an item or something in someones inventory, a useful tool is NBTExplorer. Find it at its GitHub page.

Getting more help
You've tried what you can and are at the end of your abilities but stuff is still broken - not a problem, there are lots of places where the community can help you out. Here are a few places to check out: If you're really running out of options, you may also try these:
 * Feed The Beast forums: The main FTB forums (make sure you're posting in the right place).
 * Feed The Beast Discord server
 * FTB App feedback
 * FTB modpack bug reports
 * FTB mod bug reports
 * Minecraft Forum: A ton of Minecraft conversation happens here. Dive into the modding forums for more information.
 * FTB subreddit: A subreddit dedicated to modded Minecraft discussion. General inquiries are okay here, but if you're experiencing crashes, please use...
 * FTB crashes subreddit ...this subreddit. Again, this is not for general help, it is for crashes and every post here should be accompanied by a crash log.
 * Forge Forums or Forge Discord server (Do not ask for help with old versions on the Forge discord or the Forge forums. You will not receive support when you are using older versions)
 * Fabric Discord server for Fabric based FTB modpacks
 * ModdedMC Discord server