プレイヤーの経験値を増減させたり、値を取得したりする。
Java Editionではでは別種である/xpも共に使用できるが、Bedrock Editionでは、/xpのみが使用できる。
構文[]
- Java Edition
experience add <targets> <amount> [levels|points]xp add <targets> <amount> [levels|points]- 対象の経験値をレベル単位またはポイント単位で加算(減算)する。
experience set <targets> <amount> [levels|points]xp set <targets> <amount> [levels|points]- 対象の経験値をレベル単位またはポイント単位で設定する。
experience query <targets> (levels|points)xp query <targets> (levels|points)- 対象の経験値をレベル単位またはポイント単位で取得する。
- Bedrock Edition
xp <amount: int> [player: target]- 対象の経験値をポイント単位で加算(減算)する。
xp <amount: int>L [player: target]- 対象の経験値をレベル単位で加算(減算)する。
引数[]
- プレイヤーに与える経験値ポイントおよびレベルの量を指定する。負の値を指定すると経験値が減少する。
- 32ビットの整数値で指定する。また、値は-2,147,483,648以上2,147,483,647以下で指定する。
- 設定したい経験値量およびレベルの値を指定する。
- 32ビットの整数値で指定する。また、値は0以上2,147,483,647以下で指定する。
- プレイヤーに与える経験値ポイントの量を指定する。負の値を指定すると経験値が減少する。
Lを接尾すると、レベルの量を指定したものとして見なされる。- 32ビットの整数値で指定する。
- 経験値ポイントを指定した場合、0以上21億4748万3647以下である必要がある。
- レベルを指定した場合、-21億4748万3648以上21億4748万3647以下である必要がある。
JE: <targets>:エンティティ
BE: player: target:CommandSelector<Player>
- 経験値を加減・設定・取得する対象を指定する。Bedrock Editionでは、何も指定しなかった場合コマンドの実行者が対象となる。
- プレイヤー名、ターゲットセレクターまたはUUID[Java Edition限定]で指定する。また、ターゲットセレクターはプレイヤーを指すものである必要がある。
結果[]
| コマンド | トリガー | Java Edition | Bedrock Edition |
|---|---|---|---|
| 任意 | 引数が正しく指定されていない | 構文解析不能 | 構文解析不能 |
/... add ... | <targets>に該当するプレイヤーが1人も見つからない | 失敗 | N/A |
/... query ... | <targets>に該当するプレイヤーが1人も見つからない | ||
/... set ... | <amount>が経験値バーの上限より大きい。 | ||
| 任意 | player: targetがプレイヤーの種類でない。 | N/A | 失敗 |
player: targetに該当するプレイヤーが1人も見つからない | |||
実行者がプレイヤーでなく、且つplayer: targetが指定されていない | |||
経験値ポイントを指定した場合且つ、amount: intが0未満 | |||
| 任意 | 成功時 | ||
出力[]
| コマンド | エディション | 状況 | 成功回数 | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| 任意 | Java Edition | 失敗時 | 0 | 0 | 0 |
/... query ... | 成功時 | 1 | 1 | 対象となったプレイヤーの経験値またはレベルの値 | |
/... add ... | 成功時 | 1 | 1 | 対象となったプレイヤーの数 | |
| 任意 | Bedrock Edition | 失敗時 | 0 | N/A | N/A |
| 成功時 | 経験値の増減があったプレイヤーの数 | N/A | N/A |
使用例[]
- Steveの現在のレベルを表示する:
experience query Steve levels[Java Edition限定] - 自分に7ポイントの経験値を与える:
xp 7[Bedrock Edition限定]・experience add @s 7[Java Edition限定] - Aliceに3レベル分の経験値を与える:
xp 3L Alice[Bedrock Edition限定]・xp add Alice 3 levels[Java Edition限定] - 全てのプレイヤーから経験値をすべて削除する:
xp -2147483648L @a[Bedrock Edition限定]またはxp set @a 0[Java Edition限定]またはxp set @a 0 levels[Java Edition限定]