TrainCarts/命令/选择器
介绍
TC 添加了命令选择器，用于定位列车或列车上的乘客，类似于 Minecraft 的目标选择器。除了基于类型的选择器外，其他 train 属性也可以用来筛选符合特定条件的列车。这些选择器可以与其他插件一起使用。如果要选择多个玩家或列车为目标，则命令会为每个玩家或列车重复执行。
存在两个选择器：@train和@ptrain。两者都接受相同的选择器条件，这将在本页的其余部分讨论。
要快速预览游戏中可用的条件，请使用/train info --train @ptrain[等 TC 命令，该命令会显示支持的条件。
快速命令示例
| 实例 | 描述 |
|---|---|
| /say hello @ptrain[distance=..5] | 向 5 格方块距离内的列车上的乘客发送 "hello"。 |
| /kick @ptrain[name=train23] | 踢出名为“train23”的列车上的乘客。 |
| /train destroy --train @train[destination=InterState5] | 销毁目的地为“InterState5”的列车。 |
| /train eject --train @train[dx=-2..2,dy=-3..3,dz=-2..2] | 在以命令执行者为中心设置的长方体范围内弹出列车。 |
| /train launch 0.5 --options 2 --train @train[tag=express] | 将带有“express”标签的列车以 0.5 的速度启动到 2 格方块以外的距离。 |
条件
可以指定多个条件，之间为逻辑与。所有基于数值的条件都支持 Minecraft 范围语法：a..b。例如，-5..5（-5 到 5），..6（6 或 更小）和12..（12 或 更大）。在条件前面加上!会使条件反转检测，检测某条件是否“不”。
在下面的所有示例中，若要针对列车上的乘客，可以将@train替换为@ptrain。
坐标长方体
x/y/z条件指定了世界上要选择列车的位置，其指定的是一个长方体区域。也可以指定dx/dy/dz来增大长方体。如果仅指定 dx/dy/dz，则使用命令执行者的 x/y/z 坐标。可以使用world条件来在特定世界上运行，或从无法推断世界的服务器控制台运行。
| @train[x=10..12,y=23..56,z=-100..-80] | 选择所有在（10, 23, -100）->（12, 56, 80）内部的列车。 |
| @train[x=10,y=23,z=-100,dx=2,dy=33,dz=20] | 同上，但使用 dx/dy/dz 指定“增大”的长方体。 |
| @train[x=10,y=10,z=10,dx=-2..2,dy=-10..10,dz=-2..2] | 复杂使用：从点（10, 10, 10）开始在 y 和 z 两个方向上扩大长方体。将长方体变为（8, 0, 8）->（12, 20, 12）。 |
| @train[dx=-10..10,dy=-5..5,dz=-10..10] | 在命令执行者（命令方块 / 玩家）周围选择的长方体。 |
| @train[world=world_the_end,x=10,y=89,z=-20,dx=-10..10,dy=-10..10,dz=-10..10] | 指定世界名称可用于定位其他世界的列车。 |
距离
distance条件根据与命令执行者之间的距离（球面距离）或指定的长方体来选择列车。
| @train[distance=..10] | 距离命令执行者 10 格及以内的所有列车。 |
| @train[distance=1000..] | 距离命令执行者 1000 格及以外的所有列车。 |
| @train[x=100,y=50,z=-100,distance=..5] | 距离坐标（100, 50, -100）5 格及以内的所有列车。 |
| @train[x=10,y=10,z=10,dx=50,dz=50,distance=..10] | 距离长方体（10, 10, 10）->（60, 10, 60）10 格及以内的所有列车。 |
排序和限制
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 |
列车名称
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 |
列车标签
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' |
乘客数量
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..]
出轨
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.
速度
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 |