Mods/The Aether/Troubleshooting

When installing the Aether Collaboration mod, 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, an error test batch file (or mctest.sh for linux users) is available that allows you to easily retrieve a log of the startup process, so that you can determine the issue that is occurring.

= Aether 1.02 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 pre-existing 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.
 * Deal with the META-INF folder
 * Install Aether in this correct order: ModLoader, AudioMod, Player API, ShockAhPI r5.1 and lastly Aether Mod.
 * Check that Minecraft runs after each mod is installed.
 * Contents of ShockAhPI 5.1 Bin folder go into mincraft.jar
 * Contents of Aether Jar folder go into minecraft.jar
 * Contents of the Resources folder from AetherMod (The Mod folder) go into the .minecraft/resources/ folder.

If you still continue to face trouble manually installing the mods, an installation batch file has been created that will automatically install Aether 1.02 using your installation of either 7-Zip or WinRAR.

META-INF
On a PC you can just delete the folder.

On a Mac you need to keep the folder, and delete everything inside except for the MANIFEST.MF folder.

ModLoader
If after installing ModLoader you test Minecraft and it blackscreens, you might have forgotten to deal with the META-INF folder.

If you continue to then have trouble ModLoader your .minecraft/mods/ folder is likely to be causing you trouble. Move the contents out until you can reinstall them later on.

AudioMod
No troubleshooting typically needs to occur with this mod

Player API
It's important to install the Player API before ShockAhPI 5.1 mod, as parts of ShockAhPI rely on Player API already being installed.

ShockAhPI 5.1
Only one type of ShockAhPI file can be used with Aether.
 * ShockAhPI r5.1 is only to be used for Aether 1.02
 * ShockAhPI r5 is only to be used for Aether 1.01
 * ShockAhPI r6 does not work on any kind of Aether install

Do not drag all of the contents of the AhockAhPI zip file in to minecraft.jar. Instead, go in to the Bin folder and transfer over only the contents that are in there to the minecraft.jar file.

Aether
This 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 while as it loads things, 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.

And 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 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.

=Aether 1.01 Install =

Issue: ShockAhPI revision 6
SYMPTOMS

When you log in to Minecraft, the game starts up with a black screen for several seconds, shows a crash log for a brief second then closes.

CAUSE

Aethor 1.01 requires ShockAhPI revision 5. If ShockAhPI revision 6 is accidentally used, the mod just won't work.

The log from the error test will have the following error in its log:

Failed to load mod from "mod_Aether.class" Mod Loaded: mod_SAPI r6

ERROR LOG

A sample log that contains this error is:

===Simple Minecraft Error Test===

Starting Minecraft...

16 achievements 151 recipes ModLoader Beta 1.7.3 Initializing... Overriding /terrain.png with /aether/blocks/Portal.png @ 30. 82 left. Overriding /terrain.png with /aether/blocks/Dirt.png @ 54. 81 left. Overriding /terrain.png with /aether/blocks/GrassTop.png @ 76. 80 left. ... Overriding /gui/items.png with /aether/items/PhoenixBow.png @ 164. 84 left. Overriding /gui/items.png with /aether/items/LifeShard.png @ 165. 83 left. Overriding /gui/items.png with /aether/items/GoldenFeather.png @ 166. 82 left. Failed to load mod from "mod_Aether.class" Mod Loaded: mod_SAPI r6 Mod Loaded: mod_Trivia 1.7.3 Aether Edition Done. WARNING: Found unknown Windows version: Windows 7 Attempting to use default windows plug-in. Loading: net.java.games.input.DirectAndRawInputEnvironmentPlugin

Starting up SoundSystem... Initializing LWJGL OpenAL (The LWJGL binding of OpenAL. For more information, see http://www.lwjgl.org) OpenAL initialized.

Stopping!

SoundSystem shutting down... Author: Paul Lamb, www.paulscode.com

Finished session

RESOLUTION

The minecraft.jar file needs to have ShockAhPI revision 6 removed from it, by forcing an update of minecraft.jar to return it to a known clean state (Options -> Force Update! -> Done -> Login), from which the Aether installation process can occur, but this time with ShockAhPI revision 5 instead.

Issue: ShockAhPI revision 6 overwritten with revision 5
SYMPTOMS

When you log in to Minecraft and load a map, the game shows "Saving Chunks" followed by a black screen that remains until you close it.

CAUSE

ShockAhPI revision 6 introduces additional changes that ShockAhPI revision 5 is not capable of reversing..

ERROR LOG

The log from the error test will have the following error in its log:

Using ShockAhPI r5 16 achievements ... Mod Loaded: mod_Aether 1.7.3 v1.01 Mod Loaded: mod_SAPI r6

A sample log that contains this error is:

===Simple Minecraft Error Test===

Starting Minecraft...

Using ShockAhPI r5 16 achievements 151 recipes ModLoader Beta 1.7.3 Initializing... Overriding /terrain.png with /aether/blocks/Portal.png @ 30. 82 left. Overriding /terrain.png with /aether/blocks/Dirt.png @ 54. 81 left. Overriding /terrain.png with /aether/blocks/GrassTop.png @ 76. 80 left. ... Overriding /gui/items.png with /aether/items/Glove.png @ 177. 74 left. Overriding /gui/items.png with /aether/items/GloveChain.png @ 178. 73 left. Overriding /gui/items.png with /aether/items/CloudParachute.png @ 179. 72 left. Mod Loaded: mod_Aether 1.7.3 v1.01 Mod Loaded: mod_SAPI r6 Mod Loaded: mod_Trivia 1.7.3 Aether Edition Done. WARNING: Found unknown Windows version: Windows 7 Attempting to use default windows plug-in. Loading: net.java.games.input.DirectAndRawInputEnvironmentPlugin

Starting up SoundSystem... Initializing LWJGL OpenAL (The LWJGL binding of OpenAL. For more information, see http://www.lwjgl.org) OpenAL initialized.

Stopping!

SoundSystem shutting down... Author: Paul Lamb, www.paulscode.com

Finished session

RESOLUTION

The minecraft.jar file needs to have ShockAhPI revision 6 removed from it, by forcing an update of minecraft.jar to return it to a known clean state (Options -> Force Update! -> Done -> Login), from which the Aether installation process can occur, but this time with ShockAhPI revision 5 instead.

Issue: META-INF
SYMPTOMS

When you log in to Minecraft, the game starts up with a black screen which remains until you close it.

CAUSE

The META-INF folder has not been deleted. If on a Mac, the META-INF folder must remain with the MANIFEST.MF folder within it, and the only files that should have been deleted are MOJANG_C.SF and MOJANG_C.DSA.

ERROR LOG

The log from the error test will have the following error in its log:

Exception in thread "main" java.lang.SecurityException: SHA1 digest error for dc .class

The full version of a log with this META-INF error is:

===Simple Minecraft Error Test===

Starting Minecraft...

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) at java.util.jar.JarVerifier.update(Unknown Source) at java.util.jar.JarVerifier$VerifierStream.read(Unknown Source) at sun.misc.Resource.getBytes(Unknown Source) at java.net.URLClassLoader.defineClass(Unknown Source) at java.net.URLClassLoader.access$100(Unknown Source) at java.net.URLClassLoader$1.run(Unknown Source) at java.net.URLClassLoader$1.run(Unknown Source) at java.security.AccessController.doPrivileged(Native Method) at java.net.URLClassLoader.findClass(Unknown Source) at java.lang.ClassLoader.loadClass(Unknown Source) at sun.misc.Launcher$AppClassLoader.loadClass(Unknown Source) at java.lang.ClassLoader.loadClass(Unknown Source) at java.lang.Class.getDeclaredMethods0(Native Method) at java.lang.Class.privateGetDeclaredMethods(Unknown Source) at java.lang.Class.getMethod0(Unknown Source) at java.lang.Class.getMethod(Unknown Source) at sun.launcher.LauncherHelper.getMainMethod(Unknown Source) at sun.launcher.LauncherHelper.checkAndLoadMain(Unknown Source)

Finished session

RESOLUTION

Delete the META-INF folder from minecraft.jar (or on a Mac, just delete the MOJANG_C.SF and MOJANG_C.DSA files from within the META-INF folder) to resolve this issue.

Issue: Jar folder instead of contents from Jar folder
SYMPTOMS

Minecraft starts and plays as if the Aether has not been installed. The inventory shows no extra slots for items, and creating a portal to the Aether doesn't work.

CAUSE

The Jar folder in the compressed Aether file has been copied across, when instead it should only be the contents of that Jar folder that should be copied across.

RESOLUTION

Delete the Jar folder from within minecraft.jar and then transfer over instead from the compressed Aether file, the contents of the Jar folder to minecraft.jar in order to resolve this issue.