TrainCarts/Commands/Selectors/en - Revision history

TC Bot: Updating to match new version of source page

2025-10-12T09:44:57Z

Updating to match new version of source page

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

	== Introduction ==		== Introduction ==

	Traincarts adds command selectors that can be used to target trains, or passengers of trains, similar to how vanilla minecraft's [https://minecraft.~~fandom.com~~/~~wiki~~/Target_selectors @e selector] works. Besides the usual position-based selector filters, other train properties can be used to select trains that match specific criteria. These selectors can be used with '''other plugins'''. If a selector targets more than one player/train, then the entire command is repeated for every player/train result.		Traincarts adds command selectors that can be used to target trains, or passengers of trains, similar to how vanilla minecraft's [https://minecraft.wiki/w/Target_selectors @e selector] works. Besides the usual position-based selector filters, other train properties can be used to select trains that match specific criteria. These selectors can be used with '''other plugins'''. If a selector targets more than one player/train, then the entire command is repeated for every player/train result.

	Two selectors exist: <code>@train</code> and <code>@ptrain</code>. Both accept identical selector conditions, which will be discussed on the rest of this page.		Two selectors exist: <code>@train</code> and <code>@ptrain</code>. Both accept identical selector conditions, which will be discussed on the rest of this page.

TC Bot: Updating to match new version of source page

2022-08-22T23:52:18Z

Updating to match new version of source page

← Older revision		Revision as of 23:52, 22 August 2022
Line 49:		Line 49:
	\| All trains in cuboid (10, 23, -100) -> (12, 56, 80)		\| All trains in cuboid (10, 23, -100) -> (12, 56, 80)
	\|-		\|-
	\| @train[x=10,y=23,z=-100, dx=2,dy=33,dz=20]		\| @train[x=10,y=23,z=-100,dx=2,dy=33,dz=20]
	\| Same as above, but specified with dx/dy/dz to 'grow' the cuboid		\| Same as above, but specified with dx/dy/dz to 'grow' the cuboid
	\|-		\|-

TC Bot: Updating to match new version of source page

2022-08-22T23:36:31Z

Updating to match new version of source page

← Older revision		Revision as of 23:36, 22 August 2022
Line 37:		Line 37:
	Multiple conditions can be specified, which are all AND-ed together. All number-based conditions support Minecraft range syntax: <code>a..b</code>. For example, <code>-5..5</code> (-5 to 5), <code>..6</code> (6 or less) and <code>12..</code> (12 or more). Prefixing the condition value with <code>!</code> will make it evaluate as 'not'.		Multiple conditions can be specified, which are all AND-ed together. All number-based conditions support Minecraft range syntax: <code>a..b</code>. For example, <code>-5..5</code> (-5 to 5), <code>..6</code> (6 or less) and <code>12..</code> (12 or more). Prefixing the condition value with <code>!</code> will make it evaluate as 'not'.

	In all examples below, <code>@train</code> can be substituted with <code>@ptrain</code>.		In all examples below <code>@train</code> can be substituted with <code>@ptrain</code> to instead target the player passengers of the trains.


Line 61:		Line 61:
	\| The world name to target can be used to target trains on other worlds		\| The world name to target can be used to target trains on other worlds
	\|}		\|}


	=== Distance ===		=== Distance ===

TC Bot: Updating to match new version of source page

2022-08-22T23:23:17Z

Updating to match new version of source page

← Older revision		Revision as of 23:23, 22 August 2022
Line 4:		Line 4:
	== Introduction ==		== Introduction ==

	Traincarts adds command selectors that can be used to target trains, or passengers of trains, similar to how vanilla minecraft's [https://minecraft.fandom.com/wiki/Target_selectors @e selector] works. Besides the usual position-based selector filters, other train properties can be used to select trains that match specific criteria. These selectors can be used with '''other plugins'''. If a selector targets more than one player/train, then the entire command is repeated for every player/train ~~argument~~.		Traincarts adds command selectors that can be used to target trains, or passengers of trains, similar to how vanilla minecraft's [https://minecraft.fandom.com/wiki/Target_selectors @e selector] works. Besides the usual position-based selector filters, other train properties can be used to select trains that match specific criteria. These selectors can be used with '''other plugins'''. If a selector targets more than one player/train, then the entire command is repeated for every player/train result.

	Two selectors exist: <code>@train</code> and <code>@ptrain</code>. Both accept identical selector conditions, which will be discussed on the rest of this page.		Two selectors exist: <code>@train</code> and <code>@ptrain</code>. Both accept identical selector conditions, which will be discussed on the rest of this page.

TC Bot: Updating to match new version of source page

2022-08-22T23:19:45Z

Updating to match new version of source page

← Older revision		Revision as of 23:19, 22 August 2022
Line 140:		Line 140:

	=== Unloaded ===		=== Unloaded ===
	The <code>unloaded</code> condition selects trains that are inside unloaded chunks and are therefore no longer simulated. <code>@train[unloaded=1]</code> or <code>@train[unloaded=true]</code>.		The <code>unloaded</code> condition selects trains that are inside unloaded chunks and are therefore no longer simulated. Example: <code>@train[unloaded=1]</code> or <code>@train[unloaded=true]</code>.
	Trains that keep chunks loaded do not unload.		Trains that keep chunks loaded do not unload.

TC Bot: Updating to match new version of source page

2022-08-22T22:58:06Z

Updating to match new version of source page

← Older revision		Revision as of 22:58, 22 August 2022
Line 1:		Line 1:
	<languages/>		<languages/>
	[[Special:MyLanguage/TrainCarts/Commands\|« Go back]]		[[Special:MyLanguage/TrainCarts/Commands\|« Go back]]


	== Introduction ==		== Introduction ==
Line 10:		Line 9:

	To quickly view what conditions are available in-game, use a Traincarts command like <code>/train info --train @ptrain[</code> which will then auto-complete and show suggestions of supported conditions.		To quickly view what conditions are available in-game, use a Traincarts command like <code>/train info --train @ptrain[</code> which will then auto-complete and show suggestions of supported conditions.


	=== Quick Command Examples ===		=== Quick Command Examples ===
Line 34:		Line 32:
	\| Launches the train with tag 'express' to a speed of 0.5 over 2 blocks distance		\| Launches the train with tag 'express' to a speed of 0.5 over 2 blocks distance
	\|}		\|}


	== Conditions ==		== Conditions ==
Line 137:		Line 134:

	The <code>passengers</code> and <code>playerpassengers</code> conditions select the trains that meet a certain number of (player) passengers. This supports the range command to check for 'at least' a number of passengers, such as <code>@train[passengers=5..]</code>		The <code>passengers</code> and <code>playerpassengers</code> conditions select the trains that meet a certain number of (player) passengers. This supports the range command to check for 'at least' a number of passengers, such as <code>@train[passengers=5..]</code>


	=== Derailed ===		=== Derailed ===
Line 150:		Line 146:

	The <code>speed</code> condition (alias: <code>velocity</code>) selects trains that move at a certain speed. This is the actual movement speed, which is at most the speed limit set for the train. Example: <code>@train[speed=0]</code> for trains that are not moving.		The <code>speed</code> condition (alias: <code>velocity</code>) selects trains that move at a certain speed. This is the actual movement speed, which is at most the speed limit set for the train. Example: <code>@train[speed=0]</code> for trains that are not moving.


	=== Miscellaneous Properties ===		=== Miscellaneous Properties ===

TC Bot: Updating to match new version of source page

2022-08-22T22:53:48Z

Updating to match new version of source page

← Older revision		Revision as of 22:53, 22 August 2022
Line 143:		Line 143:
	The <code>derailed</code> condition selects trains that have derailed. For example: <code>@train[derailed=1]</code> or <code>@train[derailed=true]</code>		The <code>derailed</code> condition selects trains that have derailed. For example: <code>@train[derailed=1]</code> or <code>@train[derailed=true]</code>

			=== Unloaded ===
			The <code>unloaded</code> condition selects trains that are inside unloaded chunks and are therefore no longer simulated. <code>@train[unloaded=1]</code> or <code>@train[unloaded=true]</code>.
			Trains that keep chunks loaded do not unload.

	=== Speed ===		=== Speed ===

TC Bot: Updating to match new version of source page

2022-08-22T19:55:17Z

Updating to match new version of source page

← Older revision		Revision as of 19:55, 22 August 2022
Line 7:		Line 7:
	Traincarts adds command selectors that can be used to target trains, or passengers of trains, similar to how vanilla minecraft's [https://minecraft.fandom.com/wiki/Target_selectors @e selector] works. Besides the usual position-based selector filters, other train properties can be used to select trains that match specific criteria. These selectors can be used with '''other plugins'''. If a selector targets more than one player/train, then the entire command is repeated for every player/train argument.		Traincarts adds command selectors that can be used to target trains, or passengers of trains, similar to how vanilla minecraft's [https://minecraft.fandom.com/wiki/Target_selectors @e selector] works. Besides the usual position-based selector filters, other train properties can be used to select trains that match specific criteria. These selectors can be used with '''other plugins'''. If a selector targets more than one player/train, then the entire command is repeated for every player/train argument.

	Two selectors exist: <code>@train</code> and <code>@ptrain</code>. Both accept identical selector ~~options~~, which will be discussed on the rest of this page.		Two selectors exist: <code>@train</code> and <code>@ptrain</code>. Both accept identical selector conditions, which will be discussed on the rest of this page.

	To quickly view what ~~options~~ are available ~~ingame~~, use a Traincarts command like <code>/train info --train @ptrain[</code> which will then auto-complete and show suggestions of supported ~~options~~.		To quickly view what conditions are available in-game, use a Traincarts command like <code>/train info --train @ptrain[</code> which will then auto-complete and show suggestions of supported conditions.


Line 36:		Line 36:


	== ~~Options~~ ==		== Conditions ==

	Multiple ~~options~~ can be specified, which are all AND-ed together. All number-based ~~options~~ support Minecraft range syntax: <code>a..b</code>. For example, <code>-5..5</code> (-5 to 5), <code>..6</code> (6 or less) and <code>12..</code> (12 or more). Prefixing the ~~option~~ value with <code>!</code> will make it evaluate as 'not'.		Multiple conditions can be specified, which are all AND-ed together. All number-based conditions support Minecraft range syntax: <code>a..b</code>. For example, <code>-5..5</code> (-5 to 5), <code>..6</code> (6 or less) and <code>12..</code> (12 or more). Prefixing the condition value with <code>!</code> will make it evaluate as 'not'.

	In all examples below, <code>@train</code> can be substituted with <code>@ptrain</code>.		In all examples below, <code>@train</code> can be substituted with <code>@ptrain</code>.
Line 45:		Line 45:
	=== Position Cuboid ===		=== Position Cuboid ===

	The <code>x/y/z</code> ~~options~~ specify where on the world trains should be selected. This specifies a cuboid range. The <code>dx/dy/dz</code> can also be specified to grow this cuboid. If only dx/dy/dz are specified, then the x/y/z of the sender is used. The <code>world</code> ~~option~~ can optionally be specified to operate on other worlds, or to run from a server terminal where no world can be inferred.		The <code>x/y/z</code> conditions specify where on the world trains should be selected. This specifies a cuboid range. The <code>dx/dy/dz</code> can also be specified to grow this cuboid. If only dx/dy/dz are specified, then the x/y/z of the sender is used. The <code>world</code> condition can optionally be specified to operate on other worlds, or to run from a server terminal where no world can be inferred.

	{\| class="wikitable"		{\| class="wikitable"
Line 68:		Line 68:
	=== Distance ===		=== Distance ===

	The <code>distance</code> ~~option~~ filters trains based on distance to the sender, or a cuboid specified. This is a spherical distance.		The <code>distance</code> condition filters trains based on distance to the sender, or a cuboid specified. This is a spherical distance.

	{\| class="wikitable"		{\| class="wikitable"
Line 88:		Line 88:
	=== Sort and Limit ===		=== Sort and Limit ===

	The <code>sort</code> and <code>limit</code> ~~options~~ can be used to pick a single result from many based on distance, or to pick limited results at random. '''Sort''' supports ~~options~~ <code>nearest</code>, <code>furthest</code> and <code>random</code>. '''Limit''' must be a natural integer.		The <code>sort</code> and <code>limit</code> conditions can be used to pick a single result from many based on distance, or to pick limited results at random. '''Sort''' supports conditions <code>nearest</code>, <code>furthest</code> and <code>random</code>. '''Limit''' must be a natural integer.

	{\| class="wikitable"		{\| class="wikitable"
Line 105:		Line 105:
	=== Train Name ===		=== Train Name ===

	The <code>name</code> ~~option~~ can be used to select trains by name, or a name pattern. Supports the same wildcard pattern rules as the [[Special:MyLanguage/TrainCarts/Signs#Remote_Control\|remote control]] syntax.		The <code>name</code> condition can be used to select trains by name, or a name pattern. Supports the same wildcard pattern rules as the [[Special:MyLanguage/TrainCarts/Signs#Remote_Control\|remote control]] syntax.

	{\| class="wikitable"		{\| class="wikitable"
Line 122:		Line 122:
	=== Train Tags ===		=== Train Tags ===

	The <code>tag</code> ~~option~~, which can be specified multiple times, can be used to select the tags assigned to trains and filter on those. Like the ''name'' ~~option~~, this supports a wildcard pattern. This only checks that a particular tag is or isn't present, not that it is the only tag present.		The <code>tag</code> condition, which can be specified multiple times, can be used to select the tags assigned to trains and filter on those. Like the ''name'' condition, this supports a wildcard pattern. This only checks that a particular tag is or isn't present, not that it is the only tag present.

	{\| class="wikitable"		{\| class="wikitable"
Line 136:		Line 136:
	=== Passenger Count ===		=== Passenger Count ===

	The <code>passengers</code> and <code>playerpassengers</code> ~~options~~ select the trains that meet a certain number of (player) passengers. This supports the range command to check for 'at least' a number of passengers, such as <code>@train[passengers=5..]</code>		The <code>passengers</code> and <code>playerpassengers</code> conditions select the trains that meet a certain number of (player) passengers. This supports the range command to check for 'at least' a number of passengers, such as <code>@train[passengers=5..]</code>


	=== Derailed ===		=== Derailed ===

	The <code>derailed</code> ~~option~~ selects trains that have derailed. For example: <code>@train[derailed=1]</code> or <code>@train[derailed=true]</code>		The <code>derailed</code> condition selects trains that have derailed. For example: <code>@train[derailed=1]</code> or <code>@train[derailed=true]</code>


	=== Speed ===		=== Speed ===

	The <code>speed</code> ~~option~~ (alias: <code>velocity</code>) selects trains that move at a certain speed. This is the actual movement speed, which is at most the speed limit set for the train. Example: <code>@train[speed=0]</code> for trains that are not moving.		The <code>speed</code> condition (alias: <code>velocity</code>) selects trains that move at a certain speed. This is the actual movement speed, which is at most the speed limit set for the train. Example: <code>@train[speed=0]</code> for trains that are not moving.

TC Bot: Updating to match new version of source page

2022-08-20T21:06:12Z

Updating to match new version of source page

New page

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

== Introduction ==

Traincarts adds command selectors that can be used to target trains, or passengers of trains, similar to how vanilla minecraft's [https://minecraft.fandom.com/wiki/Target_selectors @e selector] works. Besides the usual position-based selector filters, other train properties can be used to select trains that match specific criteria. These selectors can be used with '''other plugins'''. If a selector targets more than one player/train, then the entire command is repeated for every player/train argument.

Two selectors exist: <code>@train</code> and <code>@ptrain</code>. Both accept identical selector options, which will be discussed on the rest of this page.

To quickly view what options are available ingame, use a Traincarts command like <code>/train info --train @ptrain[</code> which will then auto-complete and show suggestions of supported options.

=== Quick Command Examples ===

{| class="wikitable"
|-
! Example
! Description
|-
| /say hello @ptrain[distance=..5]
| Message "hello" to the passengers of all trains 5 blocks away or less
|-
| /kick @ptrain[name=train23]
| Kicks players inside train with name 'train23'
|-
| /train destroy --train @train[destination=InterState5]
| Destroy the trains heading for InterState5
|-
| /train eject --train @train[dx=-2..2,dy=-3..3,dz=-2..2]
| Eject the trains within a cuboid range of the sender
|-
| /train launch 0.5 --options 2 --train @train[tag=express]
| Launches the train with tag 'express' to a speed of 0.5 over 2 blocks distance
|}

== Options ==

Multiple options can be specified, which are all AND-ed together. All number-based options support Minecraft range syntax: <code>a..b</code>. For example, <code>-5..5</code> (-5 to 5), <code>..6</code> (6 or less) and <code>12..</code> (12 or more). Prefixing the option value with <code>!</code> will make it evaluate as 'not'.

In all examples below, <code>@train</code> can be substituted with <code>@ptrain</code>.

=== Position Cuboid ===

The <code>x/y/z</code> options specify where on the world trains should be selected. This specifies a cuboid range. The <code>dx/dy/dz</code> can also be specified to grow this cuboid. If only dx/dy/dz are specified, then the x/y/z of the sender is used. The <code>world</code> option can optionally be specified to operate on other worlds, or to run from a server terminal where no world can be inferred.

{| class="wikitable"
|-
| @train[x=10..12,y=23..56,z=-100..-80]
| All trains in cuboid (10, 23, -100) -> (12, 56, 80)
|-
| @train[x=10,y=23,z=-100, dx=2,dy=33,dz=20]
| Same as above, but specified with dx/dy/dz to 'grow' the cuboid
|-
| @train[x=10,y=10,z=10,dx=-2..2,dy=-10..10,dz=-2..2]
| Complex use: grows the cuboid from point (10, 10, 10) in both directions. This becomes cuboid (8, 0, 8) -> (12, 20, 12)
|-
| @train[dx=-10..10,dy=-5..5,dz=-10..10]
| Selects a cuboid around the sender (command block / player) of the command
|-
| @train[world=world_the_end,x=10,y=89,z=-20,dx=-10..10,dy=-10..10,dz=-10..10]
| The world name to target can be used to target trains on other worlds
|}

=== Distance ===

The <code>distance</code> option filters trains based on distance to the sender, or a cuboid specified. This is a spherical distance.

{| class="wikitable"
|-
| @train[distance=..10]
| All trains 10 blocks or less away from the sender
|-
| @train[distance=1000..]
| All trains 1000 blocks away or more from the sender
|-
| @train[x=100,y=50,z=-100,distance=..5]
| All trains 5 blocks or less away from coordinate (100, 50, -100)
|-
| @train[x=10,y=10,z=10,dx=50,dz=50,distance=..10]
| All trains 10 blocks or less away from cuboid (10, 10, 10) -> (60, 10, 60)
|}

=== Sort and Limit ===

The <code>sort</code> and <code>limit</code> options can be used to pick a single result from many based on distance, or to pick limited results at random. '''Sort''' supports options <code>nearest</code>, <code>furthest</code> and <code>random</code>. '''Limit''' must be a natural integer.

{| class="wikitable"
|-
| @train[distance=..100,sort=random,limit=1]
| Picks a single random train 100 blocks away or less
|-
| @train[distance=..100,sort=nearest,limit=2]
| Picks at most 2 nearest trains, 100 blocks away or less
|-
| @train[distance=1000..,sort=furthest,limit=10]
| Picks at most 10 trains furthest away, 1000 blocks distance away or more
|}

=== Train Name ===

The <code>name</code> option can be used to select trains by name, or a name pattern. Supports the same wildcard pattern rules as the [[Special:MyLanguage/TrainCarts/Signs#Remote_Control|remote control]] syntax.

{| class="wikitable"
|-
| @train[name=train12]
| Selects train with name 'train12'
|-
| @train[name=Intercity*Express]
| Selects trains with name starting with "Intercity" and ending with "Express"
|-
| @train[name=*]
| Selects all trains on the world
|}

=== Train Tags ===

The <code>tag</code> option, which can be specified multiple times, can be used to select the tags assigned to trains and filter on those. Like the ''name'' option, this supports a wildcard pattern. This only checks that a particular tag is or isn't present, not that it is the only tag present.

{| class="wikitable"
|-
| @train[tag=mytag]
| Selects trains that have tag 'mytag'
|-
| @train[tag=*fast,tag=!express]
| Selects trains that have a tag ending with 'fast', but do not have tag 'express'
|}

=== Passenger Count ===

The <code>passengers</code> and <code>playerpassengers</code> options select the trains that meet a certain number of (player) passengers. This supports the range command to check for 'at least' a number of passengers, such as <code>@train[passengers=5..]</code>

=== Derailed ===

The <code>derailed</code> option selects trains that have derailed. For example: <code>@train[derailed=1]</code> or <code>@train[derailed=true]</code>

=== Speed ===

The <code>speed</code> option (alias: <code>velocity</code>) selects trains that move at a certain speed. This is the actual movement speed, which is at most the speed limit set for the train. Example: <code>@train[speed=0]</code> for trains that are not moving.

=== Miscellaneous Properties ===

More might be added in the future, but the additional properties can be used to filter the selection

{| class="wikitable"
|-
| destination
| [[Special:MyLanguage/TrainCarts/PathFinding|Destination]] set for the train
|-
| friction
| Friction modifier of the train (default: 1)
|-
| gravity
| Gravity modifier of the train (default: 1)
|-
| keepchunksloaded
| Whether the train keeps nearby chunks loaded
|-
| speedlimit
| Speed limit set for the train
|-
| ticket
| Same checks as for tags, but for [[Special:MyLanguage/TrainCarts/Tickets|ticket names]] instead
|-
|}