Name: Pchan3's Airship
Version: 1.4_01 V4
Date: 8/4/2011
Category: Minecraft Mod
Author(s): Pchan3
Source: 
Forum: http://www.minecraftforum.net/viewtopic.php?f=25&t=178612
Homepage: http://www.steam-craft.com/forum


DISCLAIMER!
================
I bare no responsibility of destroying your Minecraft.jar or your saves.
backup before you install anything.
this mod is used at your own risk.
if this README doesn't help. look for videos online for tutorials at installing it.

Description
===========
This mod introduces a craft-able Flying Vehicle, the airship. It is based on Victorian era technology a la steam punk.


Details
=======
Requires Modloader to be installed.

Controls(See Keys at the bottom for accepted ones): 
Default: 
ascend=SPACE
descend=LSHIFT
chest=RSHIFT
fire=LCONTROL

Boiler. the boiler and chimney + smoke can be disabled.
in the properties file there is a "boiler=show"
change this to "boiler=hide"
and save.

Inventory/Chest
=========
Click Right Shift (or whatever you have changed it to)

Fuel & Arrows go in here.
+ whatever. don't put fuel sources you don't want to lose in here. 
(like if your transporting wood or lavabuckets)
This mod does NOT affect your main inventory at all.




Fuel DISABLED FOR V4! ITS BROKEN AND NEEDS TO BE REDONE!
======
New Feature as of Beta V3 of the Airship mod.

Your beloved Airship is now more expensive.
1 Piece of Coal will give you approximate 10 minutes of flight.
Acceptable Fuel Sources:
Coal
Lava Buckets
Wood
Planks
Gunpowder - Increases speed by a decent factor. (Turbo boost) will probably nerf this in a later version :P

Weaponry
=======
(its current state is sort of like: better than nothing)

Press the FIRE! button and aim at your ghast enemies.

Warning: there are a few bugs i haven't quite worked out.
-the starting point of the arrow is offset to the left of the crosshairs.
-due to the speed of the arrows, its not reccomended firing at short range.
-firing up can make the arrow land on you. :|


You now have an Arrow launcher! 
its not as accurate as your regular bow.
and you can't fire as fast.
but its arrow velocity is pretty fast.


LOOK OUT FOR PIRATE AIRSHIPS IN A NEW MOD! :D 
COMING SOON TO THE SKIES NEAR YOU! 





Install
=======
1a. BACKUP YO SAVES!
1. Extract the files to a temporary location.
2. Examine the folder structure and make corrections where necessary.
3. Copy .class files to the root directory of your minecraft.jar opened using WinRAR or similar tool
4. Choose either the 16px or 32px files from the archive. copy the whole subfolders (gui and items) into the jar
5. Run Minecraft :)

Note:
must be run once to generate properties file or you can use provided file and put in the .minecraft folder
easier to run MC and then find it.



BALLOON.png AND AIRSHIP.png
==========================
There are many different versions of the balloon. so please pick one and rename that to balloon.png
there should be just one airship.png
these go in the ITEMS folder of your minecraft.jar
if there is not an items folder. create one.
65% of errors are cause by not having these installed properly
the other 34% are caused by not having the icons installed properly

wait. what about the 1%. unforseeable and or errors caused by my notch's coding.
my code is perfect.*RAWR* :D








Uninstall
=========
1. Open Minecraft.jar and Delete the following Class file:
-mod_airship
-RenderAirship
-ModelAirship
-EntityAirship
-ModelBalloon
-ItemAirship
-FuelTask
-FuelTimer

DO NOT DELETE: 
-CustomModelRenderer
-CustomTexturedQuad
(These Belong to Steamboat as well as Airship
only delete if you intend to uninstall both.or only have Airship installed.)

Archive\ClassFiles -  .Class Locations
Archive\gui\16 - 16x16 Icons Location
Archive\gui\32 - 32x32 Icon Location
Archive\items - Balloon and Airship textures

Upgrade
=======
1. Uninstall the old mod.
2. Install the new mod.
3. Start Minecraft and play. 
There should be no effect on saves. But As i have not extensively tested it. things could go bad. backup before you install. :)

You should be able to copy all the class files and overwrite the previous ones. but i list this just in case.


Incompatibility
===============

Non-Modloader mods which affect Rendering, Items etc. 
Anything thats not compatible with modloader.
I do not know if there are any modloader mods which aren't compatiable with mine.
so if you come accross one, let me know in the forums/website etc.

Known Issues or Bugs
====================

Tell me what they are! :|
(other than ones i mention above)


FAQ'S
========
Q.My screen goes black at startup.
A.This could be due to something funky in the minecraft.exe
F.Use Notch's NEW Minecraft Launcher that he released on twitter/tumblr

Q.The previous F didn't help.
A.This could be due to images not being the in the right place. (ICONS!)
Don't use 32x Icons if you don't have Xau's patcher in place.
F. Use 16x Icons. if you used 16x icons and it broke. use 32x icons. :|

Q.It crashes when i place the Airship
A.The Items folder in the Minecraft.jar does not contain a balloon.png and/or airship.png
F.Follow the instructions and put those images in the folder.


History
=======

Alpha:
-Flies
-Textured

Beta:
-Flies
-Textured
-Balloon Separate (and seperately textured)
-Icons
-Full Recipe 

Beta V3:
-Arrow Shooting (not perfect)
-Viewing bug fixed
-gui and items are now BOTH in 16 and 32 for their respective sizes.
-Inventory
-Fuel
-Probably more but i forget. D:

Contact
=======

Pchan3 on Minecraftforum.net
Pchan3 on youtube.com



Credits
=======


Thanks to Notch & Mojang for creating Minecraft
Thanks to Glimmar for creating awesome sauce textures & icons to go with thismod
Thanks to Gestankfaust for creating a chuthulu
Thanks to ShaRose, which i finally managed to decipher his code and make the arrow launcher. :D
Thanks to Maud'Dib for creating the original steamboat mod (i got inspiration/idea from it).
Thanks to YOU! for downloading this mod and supporting me :)
Thanks again to you for reading the DAMN readme. A lot of people don't and it can help a lot.
and save me several hundred posts on the forums...

Tools Used
==========
7-Zip 
GIMP 
Paint.NET 
Readme Generator - http://lhammonds.game-host.org/obmm/tools_readme_generator1.asp
Eclipse
Minecraft Coders Pack 2.9


Licensing/Legal
===============

You must contact me and obtain my permission before re-packaging any part of
this mod. If I do not respond within 4 weeks, feel free to do whatever you
like with this mod.

If you wish to ask for artwork, they are owned by Glimmar please contact him if you wish to use them in your own work.







Accepted KEYS(others will prolly crash the game) THEY MUST BE COPIED EXACLY AS IS:
YEN
NOCONVERT
CONVERT
F1
CAPITAL
SPACE
LMENU
MULTIPLY
RSHIFT
SLASH
PERIOD
COMMA
M
KANA
N
B
V
C
X
Z
BACKSLASH
LSHIFT
GRAVE
APOSTROPHE
F15
F14
F13
SEMICOLON
L
K
J
H
G
F
D
S
A
LCONTROL
RETURN
RBRACKET
LBRACKET
P
O
F12
I
F11
U
Y
T
DECIMAL
NUMPAD0
NUMPAD3
NUMPAD2
8
7
6
5
4
3
2
1
ESCAPE
NONE
R
E
W
Q
TAB
NUMPAD1
BACK
ADD
EQUALS
NUMPAD6
MINUS
NUMPAD5
0
NUMPAD4
9
SUBTRACT
NUMPAD9
NUMPAD8
NUMPAD7
SCROLL
NUMLOCK
F10
F9
F8
F7
F6
F5
F4
F3
F2


