Mods/The Aether/Troubleshooting

When installing the Aether modification, there are some common installation issues that can occur when the installation does not correctly occur.

What follows are some common installation issues that people come across, their cause, and how to resolve them.

Because Minecraft commonly shows a black screen when many of these issues occur, a crash report can help you to determine the issue that is occurring. If you are still experiencing problems, you can get more help at the #aethermod chat channel on http://www.esper.net/

= Aether 1.9 Pre-release Install = If you have trouble installing Minecraft, something has happened to confuse Minecraft as it is loading the minecraft.jar file. Unless precise details about what went wrong are known, the only viable option is to either reinstall, or to use a working backup of minecraft.jar file of yours that is known to work.

Reinstall

 * Open Minecraft and click Options, then Force Update, followed by Login.
 * Remove any texturepacks until after the Aether is installed.
 * Delete the META-INF folder
 * Install Aether in this correct order:
 * 1) Forge build #152
 * 2) Player API 1.5
 * 3) Aether 1.9 Pre-release
 * Check that Minecraft runs after each mod is installed.
 * Contents of Aether Jar folder go into minecraft.jar
 * Contents of Aether Resources folder go into the .minecraft/resources/ folder.

Aether
This .rar file contains two folder, Jar and Resources. The contents of the Jar folder should go into minecraft.jar, and the contents of the Resources folder from AetherMod (The Mod folder) go into the .minecraft/resources/ folder.

After a successful install Minecraft will show a dirt background for a few moments, and then the Aether menu will show in front of the where you were last playing in your world.

If you have trouble with loading the Aether menu, you can disable it by using a text editor to edit the .minecraft/config/Aether.cfg file by setting aethermenu and worldmenu to false. Do not edit the first half of the config file that has lines starting with # symbols. It is in the lower half of the file where you need to make your edits.

An example of one of the edits to Aether.cfg is highlighted below:

idBlockLockedDungeonStone=191 worldMenu=false idItemObsidianLegs=17076

After Installing Aether
Once you've confirmed that you've correctly installed the Aether, you can move on to installing [=Mods/The Aether#Compatibility_with_other_mods|other mods]. It can be wise though to first make a copy of your working minecraft.jar file, so that if an installation causes problems you can easily get back to a working minecraft.jar file.

= What Went Wrong? = If you have trouble starting Minecraft after making changes to minecraft.jar, something has been done incorrectly. Most of the time it's dependency issues where a mod cannot find what it requires from another one, or it can be due to conflicts between other mods, some of which can be resolved.

You can get a crash report to help get details of what went wrong.

With the crash report, that will allow you to more easily investigate the cause of the problem.

= Common Aether 1.9 Pre-release Install Issues =

Symptom: SHA1 digest error
ISSUE

Java prevents Minecraft from running when it detects a change to the minecraft.jar file.

CAUSE

The META-INF folder within minecraft.jar still contains the files CODESIGN.RSA and CODESIGN.SF - they need to be deleted.

ERROR REPORT

The log from the error report will contain the following error in its log:

java.lang.SecurityException: SHA1 digest error

A sample log that contains this error is:

Exception in thread "main" java.lang.SecurityException: SHA1 digest error for dc .class at sun.security.util.ManifestEntryVerifier.verify(Unknown Source) at java.util.jar.JarVerifier.processEntry(Unknown Source) ...

RESOLUTION

Delete the META-INF folder.

= Archived =
 * Aether 1.02 troubleshooting info
 * Aether 1.01 troubleshooting info