Mods/Minecart Mania!

Minecart Mania! is a Minecraft Alpha client and server mod created by Afforess that reinvents the minecart game mechanics. It can create boosted track sections, brakes, cart dispensers and more. A video demonstration of some of the features is available here.

= Overview =

= Installation = The installation package can be downloaded from here.

Minecraft Windows Client
Note: When playing on unmodified servers, the mine carts will behave as normal.
 * 1) Open the Minecraft .jar binary with WinRAR or 7-Zip. Mind the capitalization Mincraft.jar is the laucher, minecraft.jar is the binary.
 * 2) Drag the class from the Minecart Mania! installation folder into the .jar.
 * 3) Delete the META-INF folder.
 * 4) Close the program and launch the .jar

Minecraft Linux Client

 * 1. Open a terminal.
 * 2. Change directory to the directory where the minecraft.jar binary is located. Normally this is ~/.minecraft/bin. Mind the capitalization, Minecraft.jar is the launcher and minecraft.jar is the binary.
 * 3. Extract the classes from the Minecart Mania! archive to this directory.
 * 4. Backup your minecraft.jar

cp minecraft.jar minecraft.jar.date
 * 5. Merge the classes with the minecraft.jar:

jar uvf minecraft.jar file1.class file2.class ...
 * 5. Delete the META-INF folder from minecraft.jar.
 * 6. Launch the client and try it in single player.

Note: When playing on unmodified servers, the mine carts will behave as normal.

Minecraft Server
Note: It is not required for clients to install the mod when playing on a modded server.

Windows Servers
If you use MCAdmin continue here
 * 1) Open the Minecraft .jar binary with WinRAR or 7-Zip.
 * 2) Drag the class from the Minecart Mania! Multiplayer installation folder into the .jar.
 * 3) Do not delete the META-INF folder.
 * 4) Close the program and launch the .jar.

MCAdmin
Note: This does not require editing of mincraft_server.jar
 * 1) Create a new folder in the mods folder, within the MCAdmin root folder, it can be named anything you wish
 * 2) Drag the class files from the Minecart Mania! Multiplayer installation folder into this folder
 * 3) Restart MCAdmin and the server

Linux Servers

 * 1. Extract the class files from the downloaded zip file
 * 2. Upload the class files to your Minecraft server directory using your favorite SFTP or Secure Copy client (such as WinSCP for Windows.)
 * 3. Make a backup copy of your working server jar:

cp minecraft_server.jar minecraft_server.jar.date
 * 4. Merge the modded class files into the server jar by running the following command:

jar uvf minecraft_server.jar file1.class file2.class ...
 * 5. Launch your server and try it out.

= Track Modifiers = Track modifiers work by placing different block types underneath (or in some cases in between) the track sections. Depending on what block is used, different effects can be achieved.

Boosters
Placing minecart tracks on top of gold ore or gold blocks (made from 9 gold ingots) will yield boosted track sections. Gold ore will only boost the minecart by 25% of its speed / momentum, while gold blocks will double it. Minecarts that are not moving will not be affected by these track sections. Boosted track sections can be disabled by applying a redstone current to them.

Brakes
Placing Slow Sand from the Nether, or gravel underneath a section of minecart track will cause any minecart in motion to slow down dramatically as it passes over it. Slow Sand slows a minecart by 50%, gravel only by 20%. This means one Slow Sand block will undo the boost given by a gold block, while one gravel will undo the boost from a gold ore block. Additionally, hooking up a powered redstone current to the brake will disable the brake, making it have no effect.

Pushers
Placing an iron block underneath of a track section will force any player or mobs out of a cart as it passes over it, placing them directly behind where the minecart previously was. This can be disabled by applying an active redstone current.

Pressure Plates
Both Wooden and Stone Pressure Plates act as straight tracks. Although it won't be visible in the game, they will act as a combination of a plate and a track when a minecart passes over them. Pressure plates can also act as a neutral 4 way intersection. Normally, track intersections force carts to switch directions. Using a pressure plate allows minecarts to continue in their original direction. This way, intersecting lanes of track can be built that don't cause the carts to change directions.

Bouncers
Placing a Cloth block underneath a section of track will cause any minecart in motion to change directions, and continue in the opposite direction with the same speed it had before. Additionally, hooking up a powered redstone current to the Cloth will disable the bouncing mechanic, making it have no effect.

Launchers / Catchers
Obsidian can be used to launch stopped minecarts forward. Placing Obsidian underneath track, and applying an active redstone current to it will cause a stationary minecart placed on top to accelerate in the direction the track continues in. In case there is more than one direction available to launch in, the game will follow the compass rose, trying North, East, South and last, West. Their exact speed can be controlled by signs. Signs with the text "speed X%", where X is a integer between 1 and 100 affect it's initial speed. 100% implies full speed, 50% half speed, etc...

Obsidian can also be used to catch moving minecarts and hold them until a redstone current launches them forward again. To make Obsidian act as a catcher, an inactive redstone current must be applied to the block. No redstone, or an active current will not work. Because the catching mechanic can sometimes interfere with the launching mechanic of the block, signs can be used to disable catching. Placing a sign adjacent to the track above the obsidian with the word "Launcher" in any of the 4 lines will disable the ability for it to catch moving carts, until the sign is removed.

Obsidian can be used to stop a cars motion temporarily. Placing obsidian underneath a track, and a sign adjacent to it with the text "hold for X" will hold a cart stationary on the obsidian for X seconds. (Only for values of X between 1 and 999). If there is room on the sign, a countdown will appear.

Dispensers
Minecarts be automatically stored in single or double chests without the aid or intervention of a player. Placing a track up to a chest, and pushing a minecart towards it will cause the minecart to be stored in the chest, thus dissappearing from the track once it touches the chest. Giving the chest a redstone current will dispense a minecart if one is available. Used in conjunction with a minecart launcher, this can automate minecart storage. In case there is more than one direction available to dispense to, the game will follow the compass rose, trying North, East, South and last, West. Alternatively, a player can place a sign adjacent to the chest with the direction name on any of the four lines to force a specific direction.

Placing a sign next to a chest with the text "Minecarts:" on one of the lines will cause it to be updated with a total number of the minecarts present in the chest, useful for knowing whether dispensers are empty or full without looking in each one. Open the chest or apply a redstone current to update the sign.

Additionally, a sign placed to a chest with text "collect only" in one of the lines will force the chest to only collect passing carts. Chests designated as only collectors will also collect carts that pass parallel to it. Further, a sign with the text "collect empty" in one of the lines will force the chest to only collect empty minecarts, ignoring those who anything in them. This can be used in combination with the "collect only" line.

Kill Switch for Empty Minecarts
A kill switch for empty minecarts has also been made available in a configuration file that is automatically created the first time the mod is run, for both servers and clients. The file, "MinecartManiaSettings.txt" allows the user to set a specified time period for killing empty minecarts. Intended mostly for server use (but it does work on clients), it will destroy and remove minecarts that remain empty for longer than the time allotted. Entering and exiting the minecart reset the timer for each particular minecart. Integer (whole numbers) only.

Known Bugs

 * Pressure Plates on Servers do not always correctly detect minecarts and will fail to activate a redstone current
 * The Pusher (Iron block) will not work on Servers.
 * Minecarts with a player, when being absorbed by a chest, may crash the player's client with an "Internal Server Error". This crash does not damage servers, and is a result of health not working
 * Signs may lag on updating Minecart quantities or countdowns for held minecarts

= Version History =

= Links = Forum Thread