给予玩家经验。
语法[]
- Java版
experience add <targets> <amount> [levels|points]experience set <targets> <amount> [levels|points]experience query <targets> (levels|points)- 基岩版
xp <amount: int> [player: target]xp <amount: int>L [player: target]
参数[]
JE:<amount>:integer
BE:amount: int:int
- 指定给予玩家的经验值数量。必须在-2147483648和2147483647之间(含)。负数值会移除指定级别的经验。
- 在基岩版中,如果在后面加上
L,则会给予或移除玩家指定等级的经验。
JE: <targets>:entity(于add或set模式下)
BE: player: target:CommandSelector<Player>
JE: <targets>:entity(于query模式下)
- 指定命令作用的目标。
- 必须为玩家名、目标选择器或UUID。且目标选择器只允许1个玩家。
JE: levels|points
- 指定命令将影响/获取经验的等级数还是点数。
levels表示等级数,points表示点数。
效果[]
| 命令 | 触发条件 | Java版 | 基岩版 |
|---|---|---|---|
| 任意 | 参数未正确指定 | 无法解析 | 无法解析 |
/... add ... | <targets>未能解析出至少一个在线玩家 | 执行失败 | N/A |
/... query ... | <targets>未能解析出一个在线玩家 | ||
/... set ... | <amount>大于任意玩家的经验条容量 | ||
| 任意 | player: target未能解析出至少一个在线玩家 | N/A | 执行失败 |
未指定player: target且命令执行者不是玩家 | |||
player: target非玩家目标选择器 | |||
<amount: int>后无L且小于0 | |||
| 任意 | 执行成功时 | 添加、移除或查询经验值 | |
输出[]
| 命令 | 版本 | 条件 | 成功次数 | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| 任意 | Java版 | 失败 | 0 | 0 | 0 |
/... query ... | 成功 | 1 | 1 | 玩家拥有的经验值或经验等级 | |
/... add ... | 成功 | 1 | 1 | 目标玩家的个数 | |
| 任意 | 基岩版 | 失败 | 0 | N/A | N/A |
| 成功 | 给予或移除经验的玩家数量 | N/A | N/A |
示例[]
- 显示Steve当前的经验等级:
experience query Steve levels[仅Java版]
历史[]
| Java版 | |||||
|---|---|---|---|---|---|
| 1.0.0 | Beta 1.9-pre5 | 加入了/xp。 | |||
| 1.3.1 | 12w16a | /xp命令现在能在单人游戏中使用。 | |||
| 更改了语法,现在是等级参数在前,玩家参数在后,并且玩家参数是可选的。 | |||||
| 1.4.2 | 12w39a | 加入了L符号。等级可以减少,但经验值不可以且会报错“不能给予玩家负数值的经验”。 | |||
/xp的上限现在为2,147,483,647(231−1)而不是5000。 | |||||
| 1.13 | 17w45a | 加入了/experience并且/xp变成了简称。 | |||
语法被重构为/experience add、/experience set和/experience query。 | |||||
| 现在支持负数值。 | |||||
| 携带版Alpha | |||||
| 0.16.0 | build 1 | 加入了/xp。 | |||