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, 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. If you are still experiencing problems, you can get more help at the #aethermod chat channel on http://www.esper.net./

= 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 (ad f.ly/2OW94), ShockAhPI r5.1 (ad  f.ly/2On8p) and lastly Aether 1.02 (ad  f.ly/2Ox1E).
 * 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 ShockAhPI 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.

It is not possible to fix a bad ShockAhPI r5 install by installing ShockAhPI 5.1 over the top. You will need to install Player API and then ShockAhPI 5.1 to fix that.

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.

= 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 use one of the these Minecraft error test scripts to provide you with a log of what occurs when you run Minecraft, so that details of what went wrong can be found.


 * windows error test
 * mac error test
 * linux error test

The above error test can also be useful if Minecraft shows only a flash of an error report before changing to a blackscreen. By running the error test, that will allow you to investigate the error report and find a likely cause.

With the log from the error test, and the info from the error report, the cause of the problem can be more easily investigated.

= Common Aether 1.02 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 MOJANG_C.DSA and MOJANG_C.SF - they need to be deleted.

ERROR LOG

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

java.lang.SecurityException: SHA1 digest error

A sample log that contains this 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

Macs need to delete only the two files from within META-INF called MOJANG_C.DSA and MOJANG_C.SF - and leave the META-INF and MANIFEST.MF folders. If using Windows or Linux, you can get away with deleting the entire META-INF folder.

Symptom: Error test script shows NoClassDefFoundError: PlayerBase
ISSUE

ShockAhPI 5.1 cannot find classes from a mod that it requires.

Running Minecraft will result in only a blackscreen, and when running the error test script you will see the following exception in the log:

Exception in thread "main" java.lang.NoClassDefFoundError: PlayerBase

CAUSE

Player API has not been installed, which is required by ShockAhPI 5.1

ERROR LOG

The error test script shows the following in its log:

===Simple Minecraft Error Test===

Starting Minecraft...

Exception in thread "main" java.lang.NoClassDefFoundError: PlayerBase at java.lang.ClassLoader.defineClass1(Native Method) at java.lang.ClassLoader.defineClass(Unknown Source) at java.security.SecureClassLoader.defineClass(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 SAPI. (SAPI.java:27) at Tool. (Tool.java:5) at gm. (SourceFile:61) at uu. (SourceFile:208) at vs. (SourceFile:14) at net.minecraft.client.Minecraft. (SourceFile:233) at kq. (SourceFile:1930) at net.minecraft.client.Minecraft.a(SourceFile:1929) at net.minecraft.client.Minecraft.a(SourceFile:1908) at net.minecraft.client.Minecraft.main(SourceFile:1995) Caused by: java.lang.ClassNotFoundException: PlayerBase 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) ... 22 more

RESOLUTION

This issue can be fixed by installing Player API (ad f.ly/2OW94), which is required for ShockAhPI 5.1 to work.

Symptom: Error report about NoClassDefFoundError: IInterceptBlockSet
ISSUE

After installing ShockAhPI 5.1 to the wrong location, and continuing with installing Aether 1.02, Minecraft crashes with an error report about:

"java.lang.NoClassDefFoundError: IInterceptBlockSet"

CAUSE

ShockAhPI 5.1 has either been forgotten to be installed, or it has been installed to the wrong location. Most commonly this is due to the bin/ folder being transferred over to the minecraft.jar file, which results in ShockAhPI being incapable of being found by mods that require it, such as the Aether mod.

ERROR LOG

A sample error report that shows this error is:

--- BEGIN ERROR REPORT e9df3db Generated 26/08/11 9:04 PM

Minecraft: Minecraft Beta 1.7.3 OS: Windows Vista (x86) version 6.0 Java: 1.7.0, Oracle Corporation VM: Java HotSpot(TM) Client VM (mixed mode), Oracle Corporation LWJGL: 2.4.2 OpenGL: GeForce 9800 GT/PCI/SSE2/3DNOW! version 3.3.0, NVIDIA Corporation

java.lang.NoClassDefFoundError: IInterceptBlockSet at java.lang.ClassLoader.defineClass1(Native Method) at java.lang.ClassLoader.defineClass(Unknown Source) at java.security.SecureClassLoader.defineClass(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 java.lang.ClassLoader.loadClass(Unknown Source) at ModLoader.addMod(ModLoader.java:267) at ModLoader.readFromClassPath(ModLoader.java:1104) at ModLoader.init(ModLoader.java:812) at ModLoader.AddAllRenderers(ModLoader.java:183) at th. (th.java:60) at th. (th.java:9) at net.minecraft.client.Minecraft.a(SourceFile:318) at net.minecraft.client.Minecraft.run(SourceFile:716) at java.lang.Thread.run(Unknown Source) Caused by: java.lang.ClassNotFoundException: IInterceptBlockSet 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 java.lang.ClassLoader.loadClass(Unknown Source) ... 20 more --- END ERROR REPORT b3c9fc82 --

RESOLUTION

This issue can be fixed without reinstalling from scratch. Just go in to the ShockAhPI 5.1 bin/ folder and move all of its contents over to minecraft.jar - and if minecraft.jar also contains that bin/ folder, you can clean that up by deleting from minecraft.jar the mistaken bin/ folder.

Symptom: "Saving Chunks" and then a black screen that remains
ISSUE

An old version of ShockAhPI causes a loading world to show "Saving Chunks" and then a black screen that remains until you close it.

CAUSE

Aether 1.02 requires ShockAhPI 5.1 (ad f.ly/2On8p) in order to run.

ERROR LOG

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

Class not found: LightCache java.lang.NoSuchFieldError: playerBases at PlayerAPI.getPlayerBase(PlayerAPI.java:20

A sample log that contains this error is:

===Simple Minecraft Error Test===

Starting Minecraft...

Using ShockAhPI r5.1 16 achievements 151 recipes

OptiFine_1.7.3_HD_MT_G Fri Aug 26 20:38:06 NZST 2011 OS: Windows Vista (x86) version 6.0 Java: 1.7.0, Oracle Corporation VM: Java HotSpot(TM) Client VM (mixed mode), Oracle Corporation LWJGL: 2.4.2 OpenGL: GeForce 9800 GT/PCI/SSE2/3DNOW! version 3.3.0, NVIDIA Corporation OpenGL Version: 3.3 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 @ 183. 68 left. Overriding /gui/items.png with /aether/items/GloveChain.png @ 184. 67 left. Overriding /gui/items.png with /aether/items/CloudParachute.png @ 185. 66 left. Mod Loaded: mod_Aether r1 Mod Loaded: mod_TooManyItems 1.7.2 2011-07-01 Mod Loaded: mod_Trivia 1.7.3 Aether Edition Done. Loading: net.java.games.input.DirectAndRawInputEnvironmentPlugin

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

Texture registered: cg@19f0c0e, image: 0, index: 237 Texture registered: vs@d0a462, image: 0, index: 205 Texture registered: hs@441507, image: 0, index: 14 ... Texture registered: ModTextureStatic@cecb06, image: 1, index: 109 Texture registered: ModTextureStatic@ebe0fa, image: 1, index: 121 Texture registered: ModTextureStatic@11df832, image: 1, index: 183 Class not found: LightCache java.lang.NoSuchFieldError: playerBases at PlayerAPI.getPlayerBase(PlayerAPI.java:20) at mod_Aether.getPlayer(mod_Aether.java:737) at RenderPlayerAether.invisible(RenderPlayerAether.java:270) at RenderPlayerAether.b(RenderPlayerAether.java:167) at ra.a(SourceFile:336) at px.b(EntityRenderer.java:405) at px.a(EntityRenderer.java:855) at px.b(EntityRenderer.java:575) at EntityRendererProxy.b(EntityRendererProxy.java:14) at net.minecraft.client.Minecraft.run(SourceFile:781) at java.lang.Thread.run(Unknown Source) Stopping!

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

Finished session

RESOLUTION

The minecraft.jar file needs to have the old ShockAhPI r5 replaced with the files from Player API and ShockAhPI 5.1 (ad f.ly/2On8p) instead.

Symptom: Minecraft starts and plays as if the Aether has not been installed
ISSUE

The Aether menu doesn't appear, the inventory shows no extra slots for items, and attempting to creating a portal to the Aether just doesn't work.

CAUSE

Aether has been installed to the incorrect location. The Jar folder in the compressed Aether zip file has been accidentally copied across.

RESOLUTION

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

Symptom: The error log shows NoClassDefFoundError: IReach
ISSUE

Aether 1.02 cannot find what it needs from ShockAhPI r8

CAUSE

A different version of ShockAhPI is being used. With Aether 1.02, you need to use ShockAhPI 5.1 (ad f.ly/2On8p) in order for it to run correctly.

ERROR REPORT

The error test script from the After Installing Aether section allows the error report to remain onscreen long enough for you to study. The error report will mention the following error:

java.lang.NoClassDefFoundError: IReach

A sample error report that contains this error is:

Mods loaded: 1 ModLoader Beta 1.7.3

Minecraft has crashed! --

Minecraft has stopped running because it encountered a problem.

If you wish to report this, please copy this entire text and email it to support@mojang.com. Please include a description of what you did when the error occured.

--- BEGIN ERROR REPORT e9df3db Generated 8/09/11 12:08 PM

Minecraft: Minecraft Beta 1.7.3 OS: Windows 7 (x86) version 6.1 Java: 1.7.0, Oracle Corporation VM: Java HotSpot(TM) Client VM (mixed mode), Oracle Corporation LWJGL: 2.4.2 OpenGL: GeForce 9800 GT/PCI/SSE2 version 3.3.0, NVIDIA Corporation

java.lang.NoClassDefFoundError: IReach at java.lang.ClassLoader.defineClass1(Native Method) at java.lang.ClassLoader.defineClass(Unknown Source) at java.security.SecureClassLoader.defineClass(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 AetherItems. (AetherItems.java:76) at mod_Aether. (mod_Aether.java:106) at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) at sun.reflect.NativeConstructorAccessorImpl.newInstance(Unknown Source) at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(Unknown Source) at java.lang.reflect.Constructor.newInstance(Unknown Source) at java.lang.Class.newInstance0(Unknown Source) at java.lang.Class.newInstance(Unknown Source) at ModLoader.addMod(ModLoader.java:272) at ModLoader.readFromClassPath(ModLoader.java:1104) at ModLoader.init(ModLoader.java:812) at ModLoader.AddAllRenderers(ModLoader.java:183) at th. (th.java:60) at th. (th.java:9) at net.minecraft.client.Minecraft.a(SourceFile:318) at net.minecraft.client.Minecraft.run(SourceFile:716) at java.lang.Thread.run(Unknown Source) Caused by: java.lang.ClassNotFoundException: IReach 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) ... 29 more --- END ERROR REPORT 8ea8105a --

RESOLUTION

ShockAhPI r8 makes changes to px.class and tk.class within minecraft.jar that cannot be easily reversed or fixed. The minecraft.jar file needs to be deleted, and you need to force an update of Minecraft so that you can then reinstall Aether 1.02 from a working minecraft.jar file. Do not use ShockAhPI r8 for an Aether 1.02 install, and only use ShockAhPI 5.1 (ad f.ly/2On8p).

= Archived issues for earlier releases = Archived to Mods/Aether Collaboration/Troubleshooting/1.01