Control Blocks
This documentation is for MCM 2.0
Blocks and Signs
In MCM 2.0 blocks and signs can be used almost interchangeably to control a minecart as it travels down the rail. The things that blocks and signs can do are called Actions. An Action is defined by text on one or more lines of a sign. That same sign (or multiple signs) can be mapped to a type of block in the configuration.
The difference between using signs and blocks are:
- Blocks are executed when the minecart travels directly over them, signs are executed when the minecart passes by them (The sign can be up to 2 blocks in any direction from the block below the track)
- Nearby actions are also executed at the following events:
- A minecart is spawned via a [spawn] action or chest (not by player placement)
- A Player (or other entity) enters a minecart.
- A block mapped with (TRIGGERON) or (TRIGGEROFF) receives the specified redstone signal.
- Nearby actions are also executed at the following events:
- There are no permissions to prevent players from placing control blocks, only signs.
- Multiple actions can be mapped to a block or to a sign, but which actions run can be specified by redstone state only on a block. (see config.yml)
Here is a list of available Actions, their syntax, and the default mapped block/value, if any.
Note that sign syntax is not case sensitive, and that some Actions are intended to be used only on signs or only on blocks, as noted in the description.
Actions for All Minecart Types
Action | Sign Syntax | Description | Default Block(s) |
---|---|---|---|
Set Speed | [Set Speed:000x] or [Set Speed:000] | Set the speed of the minecart either as a multiplier of its current speed or as a percentage of the normal max speed of regular minecarts. | Gold Block: 1.5x, Powered Rail 16x (ON) .5x (OFF) Wool -1x |
Max Speed | [Max Speed:000] | Sets the maximum speed the minecart can achieve through multipliers, as a percent of normal max speed of a minecart | None. |
Launch | [launch] or [launch direction] or [previous dir] | launches a stopped minecart in the specified direction (north, etc) or the first valid direction if not specified. If [previous dir] is used the minecart's speed and direction are unchanged (if there is no valid rail in the minecarts direction it will perform a normal launch] | Diamond Block(ON) Obsidian(prev dir) (Triggered) |
Launch Player | [launch player] | Launches a minecart containing a player, or when a player enters it. | None |
Launch Reverse | [launch2] or [launch2 player] or [previous dir2] | Similar to the launch commands above, but searches for valid directions the opposite way around. | Emerald Block |
Spawn | [spawn] or [spawn:TYPE] | spawns a minecart, typically used only as block, triggered by redstone. If just [spawn] is used a nearby sign can specify the type with [type:TYPE]. TYPE can be 'storage' 'powered' 'hopper' or 'tnt' | Diamond Block, Emerald Block |
Catch | [Catch] [hold for 00] | Stops the minecart instantly and saves its speed. Release a caught minecart with a Launch action. The [hold for 00] on the second line is optional but if specified will launch the cart after the specified number of seconds. | Obsidian |
Kill | [kill] | Destroy a minecart | Diamond Ore |
Jump | [jump] or [jump:00] | makes the minecart jump in the air, if not set to magnetic. 00 is the number of blocks it will jump. if not specified it will jump the server default. | Sponge |
Magnet | [magnet:on] or [magnet:off] | Sets the minecart to be magnetic or not. Magnetic carts cannot jump or leave the track vertically | None |
Platform | [platform] or [platform:00] | Searches around the minecart and sucks in any players or mobs. The range can be specified or it will use the server default | Lime wool |
Lock Cart | {Lock Cart] | Prevents players from right-clicking the minecart to enter or exit it. The cart will remain locked until it comes to a complete stop or an [Unlock Cart] action is encountered. | |
Unlock Cart | {Unlock Cart] | Disables the lock from a [Lock Cart] action. | |
Elevator | [elevator] or [lift up] or [lift down] | Teleports the minecart straight up or down to the next sign or block with the elevator action. using 'lift up' or 'lift down' will only travel in that direction | Red Wool |
Eject At | [Eject At] [x:y:z] [yaw:pitch] | Sets the minecart so that its passenger will be ejected to the specified location, yaw and pitch are optional | None |
Eject Here | [Eject here] | Sets the minecart so that its passenger will be ejected near the sign/block | Lapis ore block |
Eject | [Eject] | Removes any passenger from the minecart. The minecart will search in an 8 block radius for a [eject at] or [eject here] Action and use those instructions to place the passenger. If none are found, a previously encountered [eject at] or [eject here] action will be used. If still no instructions are found, the passenger will be teleported near the [eject] block (which might be on the track!) | Iron block |
Set Station | [Set Station:XXX] [XXXXXXX] [XXXXXXX] [XXXXXXX] | Sets the minecart destination to all the text on all lines following the : on the first line. (The X's) | None |
Announce | [Announce] [XXXXXXX] [XXXXXXX] [XXXXXXX] | Sends the text specified by the X's to the player. You can also use [Announce:dir] on the first line to specify the requires direction of motion for the announcement to be sent (where dir can be north south east or west). Using ! as the first character on the text lines will send that line as a new message. | |
Station | [station] | Searches around the minecart for Station Rule signs and executes them. See stations | Brick |
Stop at Destination | [station stop] Station Name | Stops the minecart If it has a passenger with a destination set to Station Name Also announces to the passenger that the destination has been reached. | None |
Prompt | [prompt] | If used near or under an intersection the rider will be prompted for a direction, regardless of the normal intersection prompting server setting | Nether Brick |
Actions for Storage Minecarts
These actions are only executed by Storage minecarts. Item conditions are described on the item-handling page.
Action | Sign Syntax | Description | Default Block(s) |
---|---|---|---|
Collect | [Collect Item] (Item Conditions) (Item Conditions) (Item Conditions) | Transfers Items from the minecart to a nearby chest | None |
Deposit | [Deposit Item] (Item Conditions) (Item Conditions) (Item Conditions) | Transfer Items from a nearby chest or furnace to the minecart | None |
Trash | [Trash Item] (Item Conditions) (Item Conditions) (Item Conditions) | Destroys Items in the minecart. | None |
Smelt/Fuel | [Smelt:XXX] or [Fuell:XXX] | Transfers the item specified by XXX to either the fuel or smelting slot of a nearby Furnace | None |
Compress | [Compress Items] | Compresses ingots in the minecart into blocks of the same type. | None |
Item Range | [Item Range:X] | Sets the minecart to collect items X blocks around itself as it travels. | None |
Y Item Range | [Item RangeY:X] | Sets the minecart to collect items X blocks above and below itself. | None |
Farm | [Farm] Type | Sets the minecart to automatically farm the specified resource at a radius around the track. See farming | None |
Farm Range | [Farm Range:X] | Sets the minecart to farm X blocks around itself as it travels. | None |
Y Farm Range | [Farm RangeY:X] | Sets the minecart to farm X blocks above and below itself. (Should be at least 1 for all soil-farming) | None |