TrainCarts/命令/选择器
介绍
TC 添加了命令选择器，用于定位列车或列车上的乘客，类似于 Minecraft 的目标选择器。除了基于类型的选择器外，其他 train 属性也可以用来筛选符合特定条件的列车。这些选择器可以与其他插件一起使用。如果要选择多个玩家或列车为目标，则命令会为每个玩家或列车重复执行。
存在两个选择器：@train和@ptrain。两者都接受相同的选择器条件，这将在本页的其余部分讨论。
要快速预览游戏中可用的条件，请使用/train info --train @ptrain[等 TC 命令，该命令会显示支持的条件。
快速命令示例
| 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 |
Conditions
Multiple conditions can be specified, which are all AND-ed together. All number-based conditions support Minecraft range syntax: a..b. For example, -5..5 (-5 to 5), ..6 (6 or less) and 12.. (12 or more). Prefixing the condition value with ! will make it evaluate as 'not'.
In all examples below @train can be substituted with @ptrain to instead target the player passengers of the trains.
Position Cuboid
The x/y/z conditions specify where on the world trains should be selected. This specifies a cuboid range. The dx/dy/dz 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 world condition can optionally be specified to operate on other worlds, or to run from a server terminal where no world can be inferred.
| @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 distance condition filters trains based on distance to the sender, or a cuboid specified. This is a spherical distance.
| @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 sort and limit conditions can be used to pick a single result from many based on distance, or to pick limited results at random. Sort supports conditions nearest, furthest and random. Limit must be a natural integer.
| @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 name condition can be used to select trains by name, or a name pattern. Supports the same wildcard pattern rules as the remote control syntax.
| @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 tag 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.
| @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 passengers and playerpassengers 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 @train[passengers=5..]
Derailed
The derailed condition selects trains that have derailed. For example: @train[derailed=1] or @train[derailed=true]
Unloaded
The unloaded condition selects trains that are inside unloaded chunks and are therefore no longer simulated. Example: @train[unloaded=1] or @train[unloaded=true].
Trains that keep chunks loaded do not unload.
Speed
The speed condition (alias: velocity) 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: @train[speed=0] 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
| destination | 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 ticket names instead |