TC HangRail 1.18.1-v2

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14
• 1.15
• 1.16
• 1.17
• 1.18

Source Code:

https://github.com/bergerhealer/TC-HangRail

Contributors:

bergerkiller, mg_1999

This plugin requires TrainCarts to be installed.

Generally this plugin will work on newer versions of Minecraft as well, so long you keep BKCommonLib and TrainCarts updated.

Introduction
The Hang Rail TrainCarts add-on allows trains to be suspended below iron bars, and move along them as if they are rails. Straight, curved and sloped rail logic are all working just like normal rails would. Create rides through the air, without ugly tracks below!

It is also possible to have the train move on top or below other block types, allowing trains to float above custom blocks such as different colors wool.

Installation
Install TrainCarts and then add the jar file of this add-on to the plugins folder as well. It will automatically register the new available rail type.

Usage
By placing iron bars in a horizontal line you can create tracks. To get a minecart on these tracks, place a normal track leading to it 2 blocks below it. When the minecart leaves the tracks it goes onto the hang rail and stays there. There are no commands or permissions you have to set up: just place the rails and you're done.

TrainCarts signs can be placed on top of the rail, that is, place a block (such as stone, grass, wood, etc.) on top of the rail and attach signs to it. All signs, including stations, spawners, etc, function. Path finding also supports hangrails.

How to show that suspension block above?
You can change the block displayed in the Minecart to be this block. In this case, use the two commands:

Code (Text):

/train setblock cobblewall
/train blockoffset 48

Similarly, with a blockchanger sign:

Code (Text):

[train]
blockchanger 48
cobblewall

Configuring custom rails block types
It is possible to specify the block types that act as hang rails. This allows functionality beyond just iron bars. These things are configured in the config.yml of the plugin, which is automatically generated the first time TC-HangRail runs. In addition to hanging below blocks, you can also make trains hover above them.

Example configuration where minecarts float above red wool (and not other colors wool). The iron fence default is kept. Only integer values for the offsets are presently supported, so things like "2.6" are not possible here.

Code (Text):

# Define the block types and their applied offsets that will act as hang rails
# For each type the block and offset settings can be configured
# Legacy block data can be specified using a colon (:), for example 'WOOL:RED'
# Similarly, to specify all data variants of a legacy type, you can use 'WOOL:'
# Running on Minecraft 1.13 and later, new material names may replace legacy ones
# Omitting data means data of the block is ignored entirely
# The offset is up/down relative to the block. >0=above, <0=below
# The sign offset is up/down relative to the block trains see signs
# The sign direction specifies in what direction trains look for signs for this rails
# A sign direction of SELF (default) uses UP/DOWN based on the offset of the Minecart
types:
  - block: IRON_FENCE
    offset: -2
    signOffset: 0
    signDirection: SELF
  - block: WOOL:RED
    offset: 1
    signOffset: 0
    signDirection: DOWN