指令/experience

xp

別名	/experience[僅Java版]
需要的權限等級	Java版：2 基岩版：1
限制條件	啟用作弊[僅基岩版]

給予玩家經驗。

語法

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>

指定指令作用的目標。

必須為玩家名、目標選擇器或UUID^[僅Java版]。且目標選擇器只允許玩家。

JE: <targets>：entity（於query模式下）

指定指令作用的目標。

必須為玩家名、目標選擇器或UUID。且目標選擇器只允許1個玩家。

JE: levels|points

指定指令將影響/取得經驗的等級數還是點數。levels表示等級數，points表示點數。

效果

指令	觸發條件	Java版	基岩版
任意	參數未正確指定	無法解析	無法解析
/... add ... /... set ...	<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 ... /... set ...		成功	1	1	目標玩家的個數
任意	基岩版	失敗	0	N/A	N/A
		成功	給予或移除經驗的玩家數量	N/A	N/A

示例

• 顯示Steve目前的經驗等級：experience query Steve levels^[僅Java版]

• 為自己增加7點經驗值：experience add @s 7^[僅Java版]或xp 7^{[僅基岩版]}

• 將Alice的等級提升3級：experience add Alice 3 levels^[僅Java版]或xp 3L Alice^{[僅基岩版]}

• 將所有玩家的等級歸零：experience set @a 0^[僅Java版]或experience set @a 0 levels^[僅Java版]或xp -2147483648L @a^{[僅基岩版]}

歷史

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。

指令

參見：Template:Commands/content [編輯]

語言

• Deutsch
• English
• русский
• українська