Make sure that you link people back to this page if your mod requires this API.
It may NOT be redistributed without my ("TightMrKI113r" or "The Owner"/"Owner") written permission.

Dont want to muddle your graphics with notch's ?
RUN OUT of space to put any more graphics ?

This simple API is a modding tool that allows modders to load item sprites from custom indexes (Like 'MyItems.png' instead of 'items.png').

This not only means that you can use up all 32000 item slots instead of the restrictive 256 slot graphic index, but you can keep your graphics together instead of all separate.

Installation:
For Users:

1. Go to %APPDATA%Roaming.minecraftbin
   
2. Open minecraft.jar with an archiving software (E.g. 7-Zip, WinRAR)
   
3. Delete the folder called META-INF
   
4. Click and drag the mods class files into minecraft.jar
   
5. You are done. The rest is up to the mod developers...
   

For Developers:

1. Get a fresh MCP
   
2. Before decompiling, go to jarsbin and install the mod to the minecraft.jar using the above method
   
3. Install any other API's you wish to use
   
4. Run decompile.bat
   
5. When creating a new Item you would use this code normally:
   
6. 'public static Item myItem = (new Item(ID)).setIconIndex(0).setItemName("myItem");'
   
7. When using the API, before the Icon Index declaration, simply add the following:
   
8. '.setTextureIndex(new TextureIndex("/indexName.png"))', replacing indexName with the filepath within minecraft.jar
   
9. It should now look like this:
   
10. public static Item myItem = (new Item(ID)).setTextureIndex(new TextureIndex("/indexName.png")).setIconIndex(0).setItemName("name");
    
11. Create a file called indexName.png (Replace it with the file name you want) and make sure that it is 256x256 pixels.
    
12. Add your graphics to the index. You can have one graphic per 16 pixels squared on the index.
    
13. The first slot's ID is 0 (In the top left hand corner), the last being 255 (Bottom right).
    
14. Add this graphic to your MCP's minecraft.jar in the same path that you specified before in the setTextureIndex() method.
    
15. Test your mod and make sure the graphics load correctly.
    
16. Run recompile and re-obfuscate and then distribute YOUR MODS FILES. DO NOT DISTRIBUTE THE API FILES, JUST PUT UP A LINK TO THIS PAGE!!!
    

Troubleshooting:
For Users:

• My minecraft black screens after installing the API! - Did you delete META-INF?
  
• My minecraft works with the API, but I installed a mod for it and minecraft crashes - Then there is either an incompatibility or, the mod wasnt coded correctly.
  

For Developers:

• The Item just has a white texture with bits of black on it - Then either: the index doesnt exist, you misspelled the name or the file isnt in the right path.
  

What is with the 'setTextureIndex(new TextureIndex("/textureIndex.png"))' instead of just 'setTextureIndex("/textureIndex.png");' ?
I decided to make a change to how it reads new indexes. Instead of just reading a file directly, it now reads a TextureIndex object. This allows me to store more details on an index, like Height, Width, that kind of thing. This allows a lot more customisation to the indexes, which will be added in future updates.

If you have any other queries, PM me and i'll help you