304 lines
8.8 KiB
Markdown
304 lines
8.8 KiB
Markdown
---
|
||
front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/3_1.21fa97ec.png
|
||
hard: 进阶
|
||
time: 40分钟
|
||
---
|
||
|
||
# 理解指令参数
|
||
|
||
#### 作者：境界
|
||
|
||
|
||
|
||
#### 什么是坐标参数
|
||
|
||
|
||
|
||
上图示例提示下一类指令参数填写坐标参数。
|
||
|
||
|
||
|
||
绝对坐标：世界坐标被视作绝对坐标。例如，冒险家使用指令“/tp 128 64 128”时，会将人物传送到世界坐标为“x:128 y:64 z:128”的位置上。
|
||
|
||
|
||
|
||
相对坐标：相对坐标视为绝对坐标的偏移量。通常，冒险家可以用波浪符号~来指代坐标为当前所站的世界坐标。因此，可以在~符号旁添加计算式来达到坐标偏移的结果。例如，冒险家使用指令“/tp ~+1 ~-1 ~”时，会将他传送到距离当前世界坐标X轴正一格，Y轴负一格的位置上。
|
||
|
||
|
||
|
||
局部坐标：局部坐标为视线方向的偏移量。通常，冒险家可以用插入符号“^”来指代坐标为当前头部的方向坐标。
|
||
|
||
|
||
|
||
与相对坐标不同的是，局部坐标以头部方向为基准点。例如，若冒险家希望让传送对象向面朝方向传送，就会用到插入局部坐标。还是以“tp”指令为例，冒险家使用指令“/tp ^ ^ ^+5”时，会把冒险家从当前位置向面朝方向的位置传送5格。
|
||
|
||
|
||
|
||
#### 什么是目标选择器
|
||
|
||
|
||
|
||
上图示例提示下一类指令参数填写目标选择器。
|
||
|
||
|
||
|
||
在通常情况下，指令由使用者输入，再由使用者执行。如执行“/tp”指令可以传送执行者到一个坐标。
|
||
|
||
但在地图玩法中，往往执行指令的个体不单单是拥有具体名称的玩家，也有可能是地图中的其他生物。如何获取到这些生物，就需要学会如何使用目标选择器。
|
||
|
||
|
||
|
||
目标选择器可以根据使用者所选的变量，再用条件参数筛选出最后满足条件的一个或多个执行指令的个体。
|
||
|
||
目标选择器变量用于指定待选目标的大致分类。共有5种变量：
|
||
|
||
```
|
||
@p：选择最近的玩家
|
||
|
||
@r：选择随机的玩家
|
||
|
||
@a：选择所有玩家
|
||
|
||
@e：选择包括所有玩家在内的全部实体
|
||
|
||
@s：选择您自己
|
||
```
|
||
|
||
|
||
|
||
|
||
|
||
如果仅仅只输入选择器变量，是不足以满足开发者的各种定制需求。因此我的世界指令系统还为使用者提供了条件参数的功能，来筛选出目标个体。这里称之为目标选择器参数。在当前中国版中，共有12种类型：
|
||
|
||
```
|
||
x, y, z：坐标
|
||
|
||
r、rm：距离
|
||
|
||
dx, dy, dz：体积尺寸
|
||
|
||
scores：计分项分数
|
||
|
||
tag：记分板标签
|
||
|
||
c：数量
|
||
|
||
l、lm：经验等级
|
||
|
||
m：游戏模式
|
||
|
||
name：实体名称
|
||
|
||
rx、rxm：垂直旋转角度
|
||
|
||
ry、rym：水平旋转角度
|
||
|
||
type：实体类型
|
||
```
|
||
|
||
|
||
|
||
通过特定格式@变量[<参数>=<值>,<参数>=<值>,<参数>=<值>,.....]来限制选取的群体，其中参数和值不区分大小写。
|
||
|
||
|
||
|
||
#### 坐标参数
|
||
|
||
坐标参数用以定义一个起始点，它常用的用法是和距离参数一起使用。例如，指令使用者希望以某个坐标点开始，让周围半径5格内的实体传送到自己身边。目标选择器可以这么做：
|
||
|
||
|
||
|
||
“x,y,z”三个参数决定世界的一个坐标，“r”代表距离范围内。“rm”则相反，代表距离范围外。两者结合使用，则可以获取从一个范围开始到另一个范围结束的实体目标。
|
||
|
||
因此，起始点的作用常用于配合距离参数来框选一个区域内的实体目标。
|
||
|
||
|
||
|
||
#### 体积尺寸
|
||
|
||
|
||
|
||
体积尺寸参数用于定义一个一定长方体区域。它常与坐标参数一起使用，以坐标参数传入的世界坐标为基准点，向“X”方向(dx)延伸特定格数，向“Y”方向(dy)延伸特定格数，并向“Z”方向(dz)延伸特定格数。最后形成的长方体区域内，与之坐标重叠的实体便是筛选出的实体目标。例子中，指令使用者尝试以某个坐标点开始，让它延伸出5x5x5的立方体区域并将与之重叠的实体传送到自己身边。
|
||
|
||
|
||
|
||
#### 计分项分数参数
|
||
|
||
计分项分数参数允许开发者通过分数选择目标，生物的分数来自“scoreboard”指令，根据指定目标的分数过滤有多种写法，但基本格式是以@变量[scores={计分项=计分值}]为准：
|
||
|
||
```
|
||
@e[scores={myscore=10}]——选择所有记分项myscore分数为10的目标。
|
||
|
||
@e[scores={myscore=10..12}] — 选择所有记分项myscore分数为包含10到12之间的目标。
|
||
|
||
@e[scores={myscore=5..}] — 选择所有记分项myscore分数为5及以上的目标。
|
||
|
||
@e[scores={myscore=..15}] — 选择所有记分项myscore分数为15及以下的目标。
|
||
|
||
@e[scores={foo=10,bar=1..5}] — 选择所有记分项foo分数为10，且记分项bar分数为包含1到5之间的目标。
|
||
```
|
||
|
||
|
||
|
||
#### 记分板
|
||
|
||
记分板标签参数允许开发者通过标签选择目标，生物的分数来自tag指令，基本格式是以@变量[tag=标签名称]为准：
|
||
|
||
```
|
||
@e[tag=标签名称]——选择所有带有“标签名称”的实体。
|
||
|
||
@e[tag=!标签名称]——选择所有没带有“标签名称”的实体。
|
||
|
||
@e[tag=]——选择所有没有标签的实体。
|
||
|
||
@e[tag=!]——选择所有带有标签的实体。
|
||
```
|
||
|
||
允许目标选择器参数同时筛选多个标签的情况，被筛选出的目标个体必须满足所有标签参数的条件：
|
||
|
||
```
|
||
@e[tag=abc,tag=def]——选择所有同时带有“abc”和“def”标签的实体
|
||
|
||
@e[tag=abc,tag=!def]——选择所有同时带有"abc"，但不带有"def"标签的实体
|
||
```
|
||
|
||
|
||
|
||
#### 数量参数
|
||
|
||
数量参数用于所选的目标数量不超过给定数值，在基岩版中，默认下使用目标选择器变量“@p”和“@r”会限制获取的目标数量为“1”，那么冒险家就可以用数量参数来增加获取的数量。而在“@e”和“@a”中，数量参数传入正值会获取离冒险家最近的、满足筛选要求的目标实体，传入负值则相反，会获取满足筛选条件且离使用者最远的目标实体。
|
||
|
||
```
|
||
@p[c=3]——获取离使用者最近的3名玩家
|
||
|
||
@a[c=-4]——选择离使用者最远的4名玩家
|
||
|
||
@r[c=2]——随机选择正在世界中的2名玩家
|
||
```
|
||
|
||
|
||
|
||
#### 等级参数
|
||
|
||
等级参数用于筛选满足给定等级范围的目标实体。在基岩版中，有两个相关参数：
|
||
lm——等级超过给定值
|
||
|
||
l——等级小于给定值
|
||
|
||
|
||
|
||
例如：
|
||
|
||
```
|
||
@e[lm=1]——获取等级大于1的实体，由于只有玩家有等级概念，因此相当于获取等级大于1的玩家
|
||
|
||
@p[l=16]——获取离使用者最近，等级在16以内的玩家
|
||
|
||
@a[lm=8,l=16]——获取等级在8~16范围内的玩家
|
||
```
|
||
|
||
|
||
|
||
#### 游戏模式参数
|
||
|
||
游戏模式参数用于筛选满足给定游戏模式的目标实体，在基岩版中，使用“m”来标识：
|
||
|
||
“m”的值可以用0、s代表生存，1、c代表创造，2、a代表冒险模式。
|
||
|
||
|
||
|
||
例如：
|
||
|
||
```
|
||
@e[m=0]——获取生存模式的玩家实体
|
||
|
||
@a[m=c]——获取创造模式的玩家实体
|
||
|
||
@a[m=!2]——获取不为冒险模式的玩家实体
|
||
```
|
||
|
||
|
||
|
||
#### 名称参数
|
||
|
||
名称参数用于筛选满足给定名字的目标实体，在基岩版中，使用name来标识：
|
||
|
||
```
|
||
@a[name=Steve]——获得世界中名为Steve的玩家实体
|
||
|
||
@a[name=!Steve]——获得世界中名称不为Steve的玩家群体
|
||
```
|
||
|
||
|
||
|
||
#### 角度参数
|
||
|
||
通过垂直旋转角度参数，开发者可以筛选出给到角度范围内的目标实体，在基岩版中，使用两种参数来表示：
|
||
|
||
rxm——角度超过给定值
|
||
|
||
rx——角度小于给定值
|
||
|
||
|
||
|
||
例如：
|
||
|
||
```
|
||
@e[rxm=30,rx=60]——获取所有视线角度在30~60垂直角度内的实体目标
|
||
|
||
@e[rx=0]——获取所有视线角度与水平线持平的实体目标
|
||
|
||
@e[rxm=45]——获取所有视线角度大于45度的实体目标
|
||
```
|
||
|
||
|
||
|
||
通过水平旋转角度参数，开发者可以筛选出给定角度范围内的目标实体，在基岩版中，使用两种参数来表示：
|
||
|
||
rym——角度超过给定值
|
||
|
||
ry——角度小于给定值
|
||
|
||
|
||
|
||
例如：
|
||
|
||
```
|
||
@e[rym=30,ry=60]——获取所有视线角度在30~60水平角度内的实体目标
|
||
|
||
@e[ry=0]——获取所有视线角度在0水平角度内的实体目标
|
||
|
||
@e[rym=45]——获取所有水平角度大于45度的实体目标
|
||
```
|
||
|
||
|
||
|
||
#### 类型参数
|
||
|
||
类型参数可以帮助开发者筛选满足给定生物类型的目标实体，在基岩版中，使用type来表示：
|
||
|
||
例如：
|
||
|
||
```
|
||
@e[type=cow]——获取世界中所有的牛实体
|
||
|
||
@e[type=!cow]——获取世界中不为牛类型的实体
|
||
|
||
@e[type=cow,type=chicken]——获取世界中牛类型和鸡类型的目标实体
|
||
```
|
||
|
||
|
||
|
||
#### 什么是原始JSON文本
|
||
|
||
|
||
|
||
在基岩版中，/tellraw指令使用原始json文本来显示文本信息结果。
|
||
|
||
|
||
|
||
```
|
||
<raw json message: json>内的格式为{"rawtext":[{"text":""}]}，其中<"text":> 后的双引号内，可以填写包含任意字符的文本信息。
|
||
```
|
||
|