Difference between revisions of "TC-Coasters"

From BergerHealer Wiki
Jump to navigation Jump to search
m (Manual update of moved page)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
{{WIP|Bergerkiller}}
+
<languages/>
 +
<translate>
 +
<!--T:1-->
 +
[[Special:MyLanguage/Main Page|« Go back]]
  
−
[[Main Page|« Go back]]
+
</translate>
 +
{{Plugin|TC-Coasters|Rollercoaster track for TrainCarts|https://www.spigotmc.org/resources/tc-coasters.59583/|https://github.com/bergerhealer/TC-Coasters/|Tcc-logo.png|250px}}
 +
<translate>
  
−
{{Plugin|TC-Coasters|Rollercoaster track for TrainCarts|https://www.spigotmc.org/resources/tc-coasters.59583/|https://github.com/bergerhealer/TC-Coasters/|Tcc-logo.png|250px}}
+
<!--T:2-->
 +
'''TC-Coasters''' is an add-on for [[Special:MyLanguage/TrainCarts|TrainCarts]] which adds smooth rollercoaster track. These track can be placed anywhere and are not bound to discrete block positions. An interactive ingame editor allows players to modify the track in realtime, with track rendered as levers and leashes. The created track supports junctions, track animations and placing objects on the track (for supporting custom models).
  
−
'''TC-Coasters''' is an add-on for [[TrainCarts]] which adds smooth rollercoaster track. These track can be placed anywhere and are not bound to discrete block positions. An interactive ingame editor allows players to modify the track in realtime, with track rendered as levers and leashes. The created track supports junctions, track animations and placing objects on the track (for supporting custom models).
+
== Nodes == <!--T:3-->
  
−
== Nodes ==
+
<!--T:4-->
 
[[File:TCC_Tracks.png|thumb|Train drives on a loop of connected '''TC-Coasters''' track nodes]]
 
[[File:TCC_Tracks.png|thumb|Train drives on a loop of connected '''TC-Coasters''' track nodes]]
 
The plugin works with '''Nodes''' and '''Connections'''. Nodes are represented as ''levers'', and are points in the 3D world that act as anchors for the track. Nodes can be connected together, represented as ''leashes''. Trains drive over connections, passing from node to node.
 
The plugin works with '''Nodes''' and '''Connections'''. Nodes are represented as ''levers'', and are points in the 3D world that act as anchors for the track. Nodes can be connected together, represented as ''leashes''. Trains drive over connections, passing from node to node.
  
−
== Usage ==
+
== Usage == <!--T:5-->
−
To get started, players first need to give themselves the in-game editor [[Map Display]] using the following command:
+
 
 +
<!--T:6-->
 +
To get started, players first need to give themselves the in-game editor [[Special:MyLanguage/Map Display|Map Display]] using the following command:
 +
</translate>
 
{{Command|tcc give|Give the player a TC-Coasters editor item|train.coasters.use}}
 
{{Command|tcc give|Give the player a TC-Coasters editor item|train.coasters.use}}
 +
<translate>
  
 +
<!--T:7-->
 
Generally players will want to put the map item in their off-hand so that they can move around and see the world properly. With the map item in their off-hand they can left-click and right-click in the world with an empty hand to interact with TC-Coasters.
 
Generally players will want to put the map item in their off-hand so that they can move around and see the world properly. With the map item in their off-hand they can left-click and right-click in the world with an empty hand to interact with TC-Coasters.
  
−
=== Menu ===
+
=== Menu === <!--T:8-->
−
While holding the map item, players can switch between different menus using [[Map_Display#Controls|steering controls]] to begin making changes. The following menu's are available:
+
 
 +
<!--T:9-->
 +
While holding the map item, players can switch between different menus using [[Special:MyLanguage/Map_Display#Controls|steering controls]] to begin making changes. The following menu's are available:
 
* '''Disabled (Hidden)''': Hides the track, editor is inactive
 
* '''Disabled (Hidden)''': Hides the track, editor is inactive
 
* '''Create Track''': Players can right-click to create new track nodes or connect nodes together
 
* '''Create Track''': Players can right-click to create new track nodes or connect nodes together
 
* '''Change Position''': Players can right-click and drag to move nodes around
 
* '''Change Position''': Players can right-click and drag to move nodes around
 
* '''Change Orientation''': Players can right-click and drag on the node's rendered levers to change the orientation of carts on it
 
* '''Change Orientation''': Players can right-click and drag on the node's rendered levers to change the orientation of carts on it
−
* '''Change Rail Block''': Players can change where the rail block is located, which is important when using [[TrainCarts/Signs|TrainCarts signs]].
+
* '''Change Rail Block''': Players can change where the rail block is located, which is important when using [[Special:MyLanguage/TrainCarts/Signs|TrainCarts signs]].
−
* '''Manage Animations''': Players can create named animation states, which can be animated using the [[TC-Coasters/Animations#Sign|TC-Coasters Animate Sign]]
+
* '''Manage Animations''': Players can create named animation states, which can be animated using the [[Special:MyLanguage/TC-Coasters/Animations#Sign|TC-Coasters Animate Sign]]
 
* '''Track Objects''': Players can place down static objects (items, blocks, etc.) which are positioned on the track
 
* '''Track Objects''': Players can place down static objects (items, blocks, etc.) which are positioned on the track
 
* '''Delete Track''': Players can right-click to delete nodes or disconnect two selected nodes
 
* '''Delete Track''': Players can right-click to delete nodes or disconnect two selected nodes
  
−
=== Selecting Nodes ===
+
 
 +
=== Selecting Nodes === <!--T:10-->
 +
 
 +
<!--T:11-->
 
[[File:TCC_Selecting_demo.gif|thumb|All different ways of selecting nodes]]
 
[[File:TCC_Selecting_demo.gif|thumb|All different ways of selecting nodes]]
 
The following interactive selecting mechanics are available:
 
The following interactive selecting mechanics are available:
Line 37: Line 53:
 
* A range of connected nodes can be selected by selecting one, then sneak-double-left-clicking another node
 
* A range of connected nodes can be selected by selecting one, then sneak-double-left-clicking another node
  
−
=== Creating Nodes ===
+
=== Creating Nodes === <!--T:12-->
 +
 
 +
<!--T:13-->
 
[[File:TCC_Creating_Nodes.gif|thumb|Three different ways of creating new nodes]]
 
[[File:TCC_Creating_Nodes.gif|thumb|Three different ways of creating new nodes]]
 
There are several ways to create new nodes:
 
There are several ways to create new nodes:
  
−
==== Right-Clicking in the world ====
+
==== Right-Clicking in the world ==== <!--T:14-->
 +
 
 +
<!--T:15-->
 
Players can switch to the '''Create Track''' menu, put the map item in their off-hand, and then right-click on top or against blocks to place nodes there. When clicking in the air, nodes are placed in front of the player, where the player is looking. The newly placed node is automatically selected. If a previous node was already selected, a connection is created from the previous node to the newly placed node. This way players can click against the blocks multiple times in a row to create a long chain of nodes.
 
Players can switch to the '''Create Track''' menu, put the map item in their off-hand, and then right-click on top or against blocks to place nodes there. When clicking in the air, nodes are placed in front of the player, where the player is looking. The newly placed node is automatically selected. If a previous node was already selected, a connection is created from the previous node to the newly placed node. This way players can click against the blocks multiple times in a row to create a long chain of nodes.
  
−
==== Dragging a node and left-clicking ====
+
==== Dragging a node and left-clicking ==== <!--T:16-->
 +
 
 +
<!--T:17-->
 
Players can switch to the '''Change Position''' menu, put the map item in their off-hand, select a node, and then drag that node along with them. By left-clicking once while dragging this node, the node is duplicated in place, with the newly duplicated node now being dragged. When wanting to complete a loop, the dragged node can be dragged on top of another node to merge with it.
 
Players can switch to the '''Change Position''' menu, put the map item in their off-hand, select a node, and then drag that node along with them. By left-clicking once while dragging this node, the node is duplicated in place, with the newly duplicated node now being dragged. When wanting to complete a loop, the dragged node can be dragged on top of another node to merge with it.
  
−
==== Create command ====
+
==== Create command ==== <!--T:18-->
 +
 
 +
<!--T:19-->
 
The following command can be used to emulate the right-click create behavior without having to be in the menu:
 
The following command can be used to emulate the right-click create behavior without having to be in the menu:
 +
</translate>
 
{{Command|tcc create|Creates new nodes or makes connections|train.coasters.use}}
 
{{Command|tcc create|Creates new nodes or makes connections|train.coasters.use}}
 +
<translate>
  
 +
<!--T:20-->
 
-----
 
-----
  
−
=== Moving Nodes ===
+
=== Moving Nodes === <!--T:21-->
−
To move nodes around, switch to the '''Change Position''' menu, [[TC-Coasters#Selecting Nodes|select]] the node(s) to move, then press and hold the right-click mouse button to move them around with you. Nodes can be moved to connect with Vanilla Minecart rails, with purple dust particles displayed when connected successfully.
 
  
−
=== Deleting Nodes ===
+
<!--T:22-->
 +
To move nodes around, switch to the '''Change Position''' menu, [[Special:MyLanguage/TC-Coasters#Selecting Nodes|select]] the node(s) to move, then press and hold the right-click mouse button to move them around with you. Nodes can be moved to connect with Vanilla Minecart rails, with purple dust particles displayed when connected successfully.
 +
 
 +
=== Deleting Nodes === <!--T:23-->
 +
 
 +
<!--T:24-->
 
Players can select the node to delete, switch to the '''Delete Track''' menu, and right-click once to delete it. They can also use the following command:
 
Players can select the node to delete, switch to the '''Delete Track''' menu, and right-click once to delete it. They can also use the following command:
 +
</translate>
 
{{Command|tcc delete|Disconnects two selected nodes or deletes the selected nodes|train.coasters.use}}
 
{{Command|tcc delete|Disconnects two selected nodes or deletes the selected nodes|train.coasters.use}}
 +
<translate>
  
−
=== Connecting Nodes ===
+
=== Connecting Nodes === <!--T:25-->
 +
 
 +
<!--T:26-->
 
There are several ways to connect two nodes together:
 
There are several ways to connect two nodes together:
  
−
==== Drag one node on top of another ====
+
==== Drag one node on top of another ==== <!--T:27-->
 +
 
 +
<!--T:28-->
 
While inside the '''Change Position''' menu, selected nodes can be dragged around by holding right-click. By dragging one node near to another, the nodes merge together as one, effectively connecting what was connected to the dragged node.
 
While inside the '''Change Position''' menu, selected nodes can be dragged around by holding right-click. By dragging one node near to another, the nodes merge together as one, effectively connecting what was connected to the dragged node.
  
−
==== Select two nodes and Create ====
+
==== Select two nodes and Create ==== <!--T:29-->
 +
 
 +
<!--T:30-->
 
After selecting the two nodes that need to be connected, players can right-click while inside the '''Create Track''' menu or use the ''/tcc create'' command to connect two nodes together.
 
After selecting the two nodes that need to be connected, players can right-click while inside the '''Create Track''' menu or use the ''/tcc create'' command to connect two nodes together.
  
−
=== Disconnecting Nodes ===
+
=== Disconnecting Nodes === <!--T:31-->
 +
 
 +
<!--T:32-->
 
To disconnect nodes, players can select the two nodes to disconnect and right-click while inside the '''Delete Track''' menu. Alternatively, they can use the ''/tcc delete'' command.
 
To disconnect nodes, players can select the two nodes to disconnect and right-click while inside the '''Delete Track''' menu. Alternatively, they can use the ''/tcc delete'' command.
  
−
== Junctions ==
+
== Junctions == <!--T:33-->
−
[[File:TCC_Junctions.png|thumb|'''TC-Coasters''' junction with 3 directions]]
 
−
Junctions are created when three or more other nodes are connected to a single node. When created, colored hovering block items show up, with a hovering number for each direction. The items can be left-clicked by players to switch the junction. The switched direction is marked using a ''#'' prefix. Trains coming from a direction not marked take the most-straight path to one of the switched directions.
 
  
−
[[TrainCarts/Signs/Switcher|Switcher signs]] can be used to switch the rails automatically. Prefix each statement with the number of the junction to switch, for example:
+
<!--T:34-->
−
{{Sign|[+train]|switcher|1-3:empty|2-3:default}}
+
[[File:TCC_Junctions_Alter.png|thumb|'''TC-Coasters''' junction with 3 directions]]
−
Which will switch 1-3 for empty trains, and 2-3 otherwise.
+
'''Junctions''', or '''Switchers''' are created when three or more other nodes are connected to a single node. This can be done by dragging one node on top of another or by selecting two nodes and running <code>/tcc create</code>. Once created, colored hovering block items show up, with a hovering number for each direction. The items can be left-clicked by players to switch the junction. The switched direction is marked using a ''#'' prefix. Trains coming from a direction not marked take the most-straight path to one of the switched directions.
  
−
== Animations ==
+
<!--T:35-->
 +
[[Special:MyLanguage/TrainCarts/Signs/Switcher|Switcher signs]] can be used to switch the rails automatically. Prefix each statement with the number of the junction to switch, for example:
 +
</translate>
 +
{{Sign|[+train]|switcher|1-2:empty|1-3:default}}
 +
<translate>
 +
<!--T:36-->
 +
Which will switch 1-2 for empty trains, and 1-3 otherwise.
 +
 
 +
<!--T:37-->
 +
This syntax also supports most other [[Special:MyLanguage/TrainCarts/Signs/Statements|statements]] from traincarts, including the counter syntax to send trains one way or another alternating:
 +
</translate>
 +
{{Sign|[+train]|switcher|1-2:1|1-3:1}}
 +
<translate>
 +
 
 +
== Animations == <!--T:38-->
 +
 
 +
<!--T:39-->
 
Track can move from one position to the next, with trains moving along with it, using track animations. Animations can be triggered through commands, or by using a TrainCarts sign.
 
Track can move from one position to the next, with trains moving along with it, using track animations. Animations can be triggered through commands, or by using a TrainCarts sign.
  
−
[[TC-Coasters/Animations|» Animations]]
+
<!--T:40-->
 +
[[Special:MyLanguage/TC-Coasters/Animations|» Animations]]
  
−
== Track Objects ==
+
== Track Objects == <!--T:41-->
 +
 
 +
<!--T:42-->
 
Floating blocks or items can be placed on top of the track. Objects can be manipulated in a very similar way as the track nodes, with additional mechanics for duplicating and dragging around.
 
Floating blocks or items can be placed on top of the track. Objects can be manipulated in a very similar way as the track nodes, with additional mechanics for duplicating and dragging around.
  
−
[[TC-Coasters/Track-Objects|» Track Objects]]
+
<!--T:43-->
 +
[[Special:MyLanguage/TC-Coasters/Track-Objects|» Track Objects]]
  
−
== Signs ==
+
== Signs == <!--T:44-->
−
[[TrainCarts/Signs|Traincarts signs]] can be placed at nodes in two ways: physical signs at the rail block position, or assigned to the node.
 
  
−
[[TC-Coasters/Signs|» Signs]]
+
<!--T:45-->
 +
[[Special:MyLanguage/TrainCarts/Signs|Traincarts signs]] can be placed at nodes in two ways: physical signs at the rail block position, or assigned to the node.
  
−
== Commands and Permissions ==
+
<!--T:46-->
 +
[[Special:MyLanguage/TC-Coasters/Signs|» Signs]]
 +
 
 +
== Commands and Permissions == <!--T:47-->
 +
 
 +
<!--T:48-->
 
There are a lot of extra commands for advanced uses, such as undo, redo, copy, paste, import and export.
 
There are a lot of extra commands for advanced uses, such as undo, redo, copy, paste, import and export.
  
−
[[TC-Coasters/Commands and Permissions|» Commands and Permissions]]
+
<!--T:49-->
 +
[[Special:MyLanguage/TC-Coasters/Commands and Permissions|» Commands and Permissions]]
 +
 
 +
== No Limits 2 Import/Export == <!--T:50-->
  
−
== No Limits 2 Import/Export ==
+
<!--T:51-->
 
You can export tracks from No Limits 2 to TC-Coasters. You can also export tracks from TC-Coasters to No Limits 2!
 
You can export tracks from No Limits 2 to TC-Coasters. You can also export tracks from TC-Coasters to No Limits 2!
  
−
[[TC-Coasters/NoLimits|» NL2 Export/Import]]
+
<!--T:52-->
 +
[[Special:MyLanguage/TC-Coasters/NoLimits|» NL2 Export/Import]]
 +
</translate>

Latest revision as of 10:10, 1 June 2025

Other languages:
English

« Go back

TC-Coasters
Tcc-logo.png
Rollercoaster track for TrainCarts
Spigot: TC-Coasters
GitHub: TC-Coasters


TC-Coasters is an add-on for TrainCarts which adds smooth rollercoaster track. These track can be placed anywhere and are not bound to discrete block positions. An interactive ingame editor allows players to modify the track in realtime, with track rendered as levers and leashes. The created track supports junctions, track animations and placing objects on the track (for supporting custom models).

Nodes

Train drives on a loop of connected TC-Coasters track nodes

The plugin works with Nodes and Connections. Nodes are represented as levers, and are points in the 3D world that act as anchors for the track. Nodes can be connected together, represented as leashes. Trains drive over connections, passing from node to node.

Usage

To get started, players first need to give themselves the in-game editor Map Display using the following command:

Give the player a TC-Coasters editor item
Command: /tcc give
Permission: train.coasters.use


Generally players will want to put the map item in their off-hand so that they can move around and see the world properly. With the map item in their off-hand they can left-click and right-click in the world with an empty hand to interact with TC-Coasters.

Menu

While holding the map item, players can switch between different menus using steering controls to begin making changes. The following menu's are available:

  • Disabled (Hidden): Hides the track, editor is inactive
  • Create Track: Players can right-click to create new track nodes or connect nodes together
  • Change Position: Players can right-click and drag to move nodes around
  • Change Orientation: Players can right-click and drag on the node's rendered levers to change the orientation of carts on it
  • Change Rail Block: Players can change where the rail block is located, which is important when using TrainCarts signs.
  • Manage Animations: Players can create named animation states, which can be animated using the TC-Coasters Animate Sign
  • Track Objects: Players can place down static objects (items, blocks, etc.) which are positioned on the track
  • Delete Track: Players can right-click to delete nodes or disconnect two selected nodes


Selecting Nodes

All different ways of selecting nodes

The following interactive selecting mechanics are available:

  • The previous selection is cleared and a new node is selected by looking at it and left-clicking
  • The previous selection is cleared by not looking at a node/the sky and left-clicking
  • Multiple nodes can be selected by holding the sneak button and left-clicking each node
  • All nodes that are connected together can be selected by double-left-clicking
  • A range of connected nodes can be selected by selecting one, then sneak-double-left-clicking another node

Creating Nodes

Three different ways of creating new nodes

There are several ways to create new nodes:

Right-Clicking in the world

Players can switch to the Create Track menu, put the map item in their off-hand, and then right-click on top or against blocks to place nodes there. When clicking in the air, nodes are placed in front of the player, where the player is looking. The newly placed node is automatically selected. If a previous node was already selected, a connection is created from the previous node to the newly placed node. This way players can click against the blocks multiple times in a row to create a long chain of nodes.

Dragging a node and left-clicking

Players can switch to the Change Position menu, put the map item in their off-hand, select a node, and then drag that node along with them. By left-clicking once while dragging this node, the node is duplicated in place, with the newly duplicated node now being dragged. When wanting to complete a loop, the dragged node can be dragged on top of another node to merge with it.

Create command

The following command can be used to emulate the right-click create behavior without having to be in the menu:

Creates new nodes or makes connections
Command: /tcc create
Permission: train.coasters.use


Moving Nodes

To move nodes around, switch to the Change Position menu, select the node(s) to move, then press and hold the right-click mouse button to move them around with you. Nodes can be moved to connect with Vanilla Minecart rails, with purple dust particles displayed when connected successfully.

Deleting Nodes

Players can select the node to delete, switch to the Delete Track menu, and right-click once to delete it. They can also use the following command:

Disconnects two selected nodes or deletes the selected nodes
Command: /tcc delete
Permission: train.coasters.use


Connecting Nodes

There are several ways to connect two nodes together:

Drag one node on top of another

While inside the Change Position menu, selected nodes can be dragged around by holding right-click. By dragging one node near to another, the nodes merge together as one, effectively connecting what was connected to the dragged node.

Select two nodes and Create

After selecting the two nodes that need to be connected, players can right-click while inside the Create Track menu or use the /tcc create command to connect two nodes together.

Disconnecting Nodes

To disconnect nodes, players can select the two nodes to disconnect and right-click while inside the Delete Track menu. Alternatively, they can use the /tcc delete command.

Junctions

TC-Coasters junction with 3 directions

Junctions, or Switchers are created when three or more other nodes are connected to a single node. This can be done by dragging one node on top of another or by selecting two nodes and running /tcc create. Once created, colored hovering block items show up, with a hovering number for each direction. The items can be left-clicked by players to switch the junction. The switched direction is marked using a # prefix. Trains coming from a direction not marked take the most-straight path to one of the switched directions.

Switcher signs can be used to switch the rails automatically. Prefix each statement with the number of the junction to switch, for example:

Signtemplate.png
[+train]
switcher
1-2:empty
1-3:default

Which will switch 1-2 for empty trains, and 1-3 otherwise.

This syntax also supports most other statements from traincarts, including the counter syntax to send trains one way or another alternating:

Signtemplate.png
[+train]
switcher
1-2:1
1-3:1


Animations

Track can move from one position to the next, with trains moving along with it, using track animations. Animations can be triggered through commands, or by using a TrainCarts sign.

» Animations

Track Objects

Floating blocks or items can be placed on top of the track. Objects can be manipulated in a very similar way as the track nodes, with additional mechanics for duplicating and dragging around.

» Track Objects

Signs

Traincarts signs can be placed at nodes in two ways: physical signs at the rail block position, or assigned to the node.

» Signs

Commands and Permissions

There are a lot of extra commands for advanced uses, such as undo, redo, copy, paste, import and export.

» Commands and Permissions

No Limits 2 Import/Export

You can export tracks from No Limits 2 to TC-Coasters. You can also export tracks from TC-Coasters to No Limits 2!

» NL2 Export/Import

Retrieved from "https://wiki.traincarts.net/index.php?title=TC-Coasters&oldid=7180"