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 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 either to install ShockAhPI 5.1 over the top of ShockAhPI r5, so a reinstall with a clean and fresh minecraft.jar is required.

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.

= Common Aether 1.02 Issues =

Issue: ShockAhPI 5.1 incorrectly installed
SYMPTOMS

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

The following will be included in the error report from when Minecraft crashes:

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

A sample error report that contains 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.

Issue: An old ShockAhPI is still in place
SYMPTOMS

When you attempting to load a world you see "Saving Chunks" and then a black screen that remains until you close it.

CAUSE

Aether 1.02 requires ShockAhPI 5.1 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 ShockAhPI r5 replaced with the files from ShockAhPI revision 5.1 instead.