給予玩家經驗。
語法
- 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 。 |
語言