TrainCarts/PathFinding/en - Revision history

TC Bot: Updating to match new version of source page

2025-10-12T09:45:12Z

Updating to match new version of source page

← Older revision		Revision as of 09:45, 12 October 2025
Line 1:		Line 1:
	<languages/>		<languages/>
	~~[[Special:MyLanguage/TrainCarts\|« Go back]]~~


	== Introduction ==		== Introduction ==

Line 60:		Line 57:

	==== Keep Chunks Loaded ====		==== Keep Chunks Loaded ====
	Prevent trains unloading when no player is nearby or in the train, by enabling the train [[Special:MyLanguage/TrainCarts/Signs/Property\|keep chunks loaded property]].		Prevent trains unloading when no player is nearby or in the train, by enabling the train [[Special:MyLanguage/TrainCarts/Signs/Property#Keep_Chunks_Loaded\|keep chunks loaded property]].

	You can use this property sign to set it:		You can use this property sign to set it:

TC Bot: Updating to match new version of source page

2024-09-23T15:21:27Z

Updating to match new version of source page

← Older revision		Revision as of 15:21, 23 September 2024
Line 60:		Line 60:

	==== Keep Chunks Loaded ====		==== Keep Chunks Loaded ====
	Prevent trains unloading when no player is nearby or in the train, by enabling the train [[TrainCarts/Signs/Property\|keep chunks loaded property]].		Prevent trains unloading when no player is nearby or in the train, by enabling the train [[Special:MyLanguage/TrainCarts/Signs/Property\|keep chunks loaded property]].

	You can use this property sign to set it:		You can use this property sign to set it:
	{{sign\|[+train]\|property\|keepchunksloaded\|true}}		{{sign\|[+train]\|property\|keepchunksloaded\|true}}

	Or you can create your train, use <code>/train keeploaded true</code> and save it under a saved train name using <code>/train save name</code>. You can then automatically spawn it by this name using the [[TrainCarts/Signs/Spawner#Automated_spawning\|spawner sign]].		Or you can create your train, use <code>/train keeploaded true</code> and save it under a saved train name using <code>/train save name</code>. You can then automatically spawn it by this name using the [[Special:MyLanguage/TrainCarts/Signs/Spawner#Automated_spawning\|spawner sign]].

	==== Wait Distance ====		==== Wait Distance ====
	To maintain distance between trains and avoid collisions over long stretches, use the [[TrainCarts/Signs/Property#Wait_Property\|wait distance property]].		To maintain distance between trains and avoid collisions over long stretches, use the [[Special:MyLanguage/TrainCarts/Signs/Property#Wait_Property\|wait distance property]].

	==== Mutex Zones ====		==== Mutex Zones ====
	Protects intersections against collisions with [[TrainCarts/Signs/Mutex\|mutex zones]].		Protects intersections against collisions with [[Special:MyLanguage/TrainCarts/Signs/Mutex\|mutex zones]].

	==== Station Routing ====		==== Station Routing ====
	[[TrainCarts/Signs/Station\|Station signs]] can launch the train into the direction of the next destination.		[[Special:MyLanguage/TrainCarts/Signs/Station\|Station signs]] can launch the train into the direction of the next destination.

	{{sign\|[!train]\|station\|\|route}}		{{sign\|[!train]\|station\|\|route}}

TC Bot: Updating to match new version of source page

2024-01-12T15:47:23Z

Updating to match new version of source page

← Older revision		Revision as of 15:47, 12 January 2024
Line 61:		Line 61:
	==== Keep Chunks Loaded ====		==== Keep Chunks Loaded ====
	Prevent trains unloading when no player is nearby or in the train, by enabling the train [[TrainCarts/Signs/Property\|keep chunks loaded property]].		Prevent trains unloading when no player is nearby or in the train, by enabling the train [[TrainCarts/Signs/Property\|keep chunks loaded property]].

			You can use this property sign to set it:
			{{sign\|[+train]\|property\|keepchunksloaded\|true}}

			Or you can create your train, use <code>/train keeploaded true</code> and save it under a saved train name using <code>/train save name</code>. You can then automatically spawn it by this name using the [[TrainCarts/Signs/Spawner#Automated_spawning\|spawner sign]].

	==== Wait Distance ====		==== Wait Distance ====

TC Bot: Updating to match new version of source page

2022-08-20T21:42:21Z

Updating to match new version of source page

← Older revision		Revision as of 21:42, 20 August 2022
Line 5:		Line 5:
	== Introduction ==		== Introduction ==

	[[~~Special:MyLanguage/~~Image:Pathfinding.png\|thumb\|right\|Setup of 3 destinations and a switcher sign to route trains between them]]		[[Image:Pathfinding.png\|thumb\|right\|Setup of 3 destinations and a switcher sign to route trains between them]]

	Trains can be routed to different locations in the Minecraft world by automatically switching the track. By placing signs the track network topology is configured, which pre-configured trains will follow to reach their destination.		Trains can be routed to different locations in the Minecraft world by automatically switching the track. By placing signs the track network topology is configured, which pre-configured trains will follow to reach their destination.
Line 56:		Line 56:

	Once the basic system is understood, there are some more complicated features to discuss.		Once the basic system is understood, there are some more complicated features to discuss.

			=== Useful Side-Features ===

			==== Keep Chunks Loaded ====
			Prevent trains unloading when no player is nearby or in the train, by enabling the train [[TrainCarts/Signs/Property\|keep chunks loaded property]].

			==== Wait Distance ====
			To maintain distance between trains and avoid collisions over long stretches, use the [[TrainCarts/Signs/Property#Wait_Property\|wait distance property]].

			==== Mutex Zones ====
			Protects intersections against collisions with [[TrainCarts/Signs/Mutex\|mutex zones]].

			==== Station Routing ====
			[[TrainCarts/Signs/Station\|Station signs]] can launch the train into the direction of the next destination.

			{{sign\|[!train]\|station\|\|route}}


	=== Debugger ===		=== Debugger ===

	[[File:~~Pathfinding_Debug_Destinations~~.png\|thumb\|Displays the destinations with a distance to them]]		[[File:Pathfinding Debug Destinations.png\|thumb\|Displays the destinations with a distance to them]]
	The plugin offers a ''debug stick'' with which path finding information can be displayed. Use the stick item to click on rails to show information about the route(s) that can be taken. Sneak (shift) while clicking performs a ''reroute'', which recalculates the track reachable from where you clicked. If you have multiple smaller rail networks, this can be more efficient than executing the global reroute command.		The plugin offers a ''debug stick'' with which path finding information can be displayed. Use the stick item to click on rails to show information about the route(s) that can be taken. Sneak (shift) while clicking performs a ''reroute'', which recalculates the track reachable from where you clicked. If you have multiple smaller rail networks, this can be more efficient than executing the global reroute command.

Line 73:		Line 89:
	==== A single destination ====		==== A single destination ====

	[[File:~~Pathfinding_Debug_Destination_Specific~~.png\|thumb\|Displays the precise route to one destination]]		[[File:Pathfinding_Debug_Destination_Specific_One.png\|thumb\|Displays the precise route to one destination]]
	Use the following command to debug a specific destination:		Use the following command to debug a specific destination:
	<pre>/train debug destination [destination]</pre>		<pre>/train debug destination [destination]</pre>

TC Bot: Updating to match new version of source page

2021-02-08T17:38:52Z

Updating to match new version of source page

New page

<languages/>
[[Special:MyLanguage/TrainCarts|« Go back]]

== Introduction ==

[[Special:MyLanguage/Image:Pathfinding.png|thumb|right|Setup of 3 destinations and a switcher sign to route trains between them]]

Trains can be routed to different locations in the Minecraft world by automatically switching the track. By placing signs the track network topology is configured, which pre-configured trains will follow to reach their destination.

Locations trains can go to are known as ''Destinations'', which are designated using [[Special:MyLanguage/TrainCarts/Signs/Destination|destination signs]]. Locations where track is being switched, as well as the end-locations, are known as ''Nodes'' in the network, which are designated using [[Special:MyLanguage/TrainCarts/Signs/Switcher|switcher signs]]. To enforce a single direction on the tracks, [[Special:MyLanguage/TrainCarts/Signs/Blocker|blocker signs]] can be employed, which disables routes that go against the flow of traffic.

== Getting Started ==

=== Designate the destinations ===

Start by placing down destination signs with a name for the destination on the third line. The fourth line can be used to set a new destination to go to once a train goes over the sign, but can be left empty.
<gallery mode="slideshow">
File:Pathfinding_Destination.png|Station with destination sign. Trains can go here, are stopped for 30 seconds, then move on to the right.
</gallery>

=== Designate the switched nodes ===

Places where the track should be switched need to have an always-powered switcher sign placed. Now when a train moves over it that has a destination set, a route will be calculated and then the track is switched.
<gallery mode="slideshow">
File:Pathfinding_Switcher.png|Switcher sign will automatically switch the track to go from/to any of the 3 directions.
</gallery>

=== Enforce one direction ===

When it is desirable that trains only ever go in one direction over a piece of track, an always-powered blocker sign can be used. This is useful when having two tracks side-by-side, each going in opposing directions. The path finding system will automatically ignore paths that are blocked by blocker signs.
<gallery mode="slideshow">
File:Pathfinding_Blocker.png|With ''[+train:left]'' trains coming from the left are blocked, only allowing movement from right to left. Similarly, ''[+train:right]'' and other directions can be used.
</gallery>

=== Test it out ===

Place down a minecart on the track, and use the [[Special:MyLanguage/TrainCarts/Commands#Destination|Destination command]] to set a destination:
<pre>/train destination [name]
/train destination output</pre>
Now give the minecart a push towards the switcher sign, and observe how it will automatically switch the track to send the train towards the destination. You can change the destination again and send it to the switcher again. Continue to experiment with multiple switchers, blockers and destinations.

If you run into a problem where the switcher appears to make a mistake, use the [[Special:MyLanguage/TrainCarts/Commands#Reroute|Reroute command]] to force a recalculation of all routing information:
<pre>/train reroute</pre>

It is also possible to use the property sign to set a destination:
{{sign|[+train]|property|destination|outpost}}

== Advanced ==

Once the basic system is understood, there are some more complicated features to discuss.

=== Debugger ===

[[File:Pathfinding_Debug_Destinations.png|thumb|Displays the destinations with a distance to them]]
The plugin offers a ''debug stick'' with which path finding information can be displayed. Use the stick item to click on rails to show information about the route(s) that can be taken. Sneak (shift) while clicking performs a ''reroute'', which recalculates the track reachable from where you clicked. If you have multiple smaller rail networks, this can be more efficient than executing the global reroute command.

==== All destinations ====

Use the following command to get a stick item that displays all destinations reached from a given track:
<pre>/train debug destination</pre>
The track clicked is followed until a ''node'' of the track network is found, after which all routeable destinations are listed. For every destination the total distance to it is listed, and particles are displayed leading into it. If you find that a certain destination is not listed that should be, you can move further along the track clicking occasionally to find where the break is.

==== A single destination ====

[[File:Pathfinding_Debug_Destination_Specific.png|thumb|Displays the precise route to one destination]]
Use the following command to debug a specific destination:
<pre>/train debug destination [destination]</pre>
Now when you click on the track, particles are displayed what route is taken to reach the destination. This is useful when debugging a specific destination so no particles are displayed for routes and destinations that aren't relevant to you.

=== Route Manager ===

Normally only one destination is set at a time. It is possible to set the next destination to go to on the destination sign itself, but that means you can only have one possible route. With the route manager a list of destinations to visit can be configured, and then applied to trains. Trains will then go down this list, advancing it every time they pass by a destination on it.

==== Commands ====

First, edit a train, then use the following commands to set a list of destinations:
<pre>/train route set [destination1] ([destination2] [destination3...])
/train route set outpost hillfort dungeon</pre>
[[File:Pathfinding_routes_set.png|File:Pathfinding_routes_set.png]]

To add additional destinations to the existing route, or to remove them, use these commands:
<pre>/train route add [destination1] ([destination2] [destination3...])
/train route remove [destination1] ([destination2] [destination3...])</pre>

You can then use the destination command or property to start the route at a desired destination. Otherwise, the route is started from the beginning the moment the train hits a destination sign. To inspect the route of a train, use the base route command. The current destination the train has is highlighted green.
<pre>/train route</pre>
[[File:Pathfinding_route_info.png|File:Pathfinding_route_info.png]]

==== Persistence ====

The route of a train can be saved globally under a name so it can later be applied to other trains instantly.
<pre>/train route save [name]</pre>
To load a saved route, this command can be used:
<pre>/train route load [name]</pre>
Alternatively, it can be done using a property sign as well:
{{sign|[+train]|property|loadroute|myroute}}