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.

Placing a sign next to a chest with the text "parallel" will allow the chest to collect carts passing by while still allowing the chest to dispense minecarts. This can be used in combination with "collect empty" to allow the chest to collect passing minecarts that are empty and dispense minecarts unlike "collect only" which only collects and does not allow the chest to dispense minecarts.

Example sign with most switches enabled. (Order does not matter.)

Line 1: North Line 2: Minecarts: Line 3: collect only Line 4: collect empty

Stations
Station blocks are only used in SMP. When a station block is placed underneath an intersection, any minecart with a player inside will stop and prompt the user for instructions on how to continue via the chat dialog. Users then can use the chat dialog to change their direction. The accepted chat commands are "/straight", "/left", "/right", "/north", "/south", "/east", and "/west". For ease of typing, the first letter lowercase of straight, left and right can be used (straight can either be "/straight" or "/s"), and the first letter uppercase for cardinal directions (north can be "/north" or "/N"). Once players issue a command, the minecart will continue in the new direction with the previous momentum.

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.

= SMP Chat Commands = Chat commands is a chat entry that begins with a '/' character, and they are only available to users using the SMP version of the mod.

Throttle
Using "/throttle [percentage]" when inside of a minecart will adjust your speed on the fly. While originally intended for autocart only, to allow users to see scenic views and vistas without whipping by everything, it also works in non-autocart servers. Stepping out of the minecart will reset the throttle to 100%.

Brake
Using "/brake" inside of a minecart will engage the braking mechanism, bringing a full speed minecart to a hard stop in several blocks. The brake will not reset when you leave the minecart, so it can be used to put minecarts in the way of other people's tracks, or use minecarts as roadblocks.

Momentum
Using "/momentum" when inside of a minecart will show your minecart's X, Y, and Z momentum on the chat dialog.

Track Direction
Track direction and placement can be altered by using the "/trackdir" command. For example, using "/trackdir n-s" will force the minecart track you are standing on to switch to face north-south directions, ignoring the track around it. The total list of usable track direction commands is "/trackdir n-s", "/trackdir e-w", "/trackdir slope-s", "/trackdir slope-n", "/trackdir slope-e", "/trackdir slope-w", "/trackdir curve-sw", "/trackdir curve-nw", "/trackdir curve-se", and "/trackdir curve-ne".

Track Direction
= Version History =

= Links = Forum Thread