Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

<languages/>
<div lang="en" dir="ltr" class="mw-content-ltr">
[[Special:MyLanguage/TrainCarts/Commands|« Go back]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Introduction ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Quick Command Examples ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{| 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
|}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Conditions ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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'.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In all examples below <code>@train</code> can be substituted with <code>@ptrain</code> to instead target the player passengers of the trains.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Position Cuboid ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{| 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
|}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Distance ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The <code>distance</code> condition filters trains based on distance to the sender, or a cuboid specified. This is a spherical distance.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{| 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)
|}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Sort and Limit ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{| 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
|}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Train Name ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{| 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
|}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Train Tags ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{| 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'
|}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Passenger Count ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Derailed ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The <code>derailed</code> condition selects trains that have derailed. For example: <code>@train[derailed=1]</code> or <code>@train[derailed=true]</code>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Unloaded ===
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Speed ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Miscellaneous Properties ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
More might be added in the future, but the additional properties can be used to filter the selection
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{| 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
|-
|}
</div>

Export translations

Navigation menu

Search