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.

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.