Commands/experience

Adds, removes or queries player experience.

Syntax[]

• Java Edition

experience add <targets> <amount> [levels|points]

experience set <targets> <amount> [levels|points]

experience query <targets> (levels|points)

xp add <targets> <amount> [levels|points]

xp set <targets> <amount> [levels|points]

xp query <targets> (levels|points)

• Bedrock Edition

xp <amount: int> [player: target]

xp <amount: int>L [player: target]

Arguments[]

JE: <amount>: integer (in add mode)

Specifies the amount of experience points or levels to give to the player. Negative values remove experience instead of adding them.

Must be a 32-bit integer number.

JE: <amount>: integer (in set mode)

Specifies the amount of experience points or levels to be set to the player.

Must be a 32-bit integer number. And it must be between 0 and 2147483647 (inclusive).

BE: amount: int: int

Specifies the amount of experience points or levels to be added to the player. This amount may represent either an amount of points or an amount of levels.

If an L is added to the end, adds levels. Negative values remove experience instead of adding them.

Must be a 32-bit integer number.

If the amount is expressed in points, it must be between 0 and 2,147,483,647 (inclusive, without the commas).

If the amount is expressed in levels, it must be between -2,147,483,648 and 2,147,483,647 (inclusive, without the commas).

JE: <targets>: entity (in add and set mode)
BE: player: target: CommandSelector<Player>

Specifies the target of the command. In Bedrock Edition, if not specified, defaults to the command's executor.

Must be a player name, a target selector or a UUID‌^{[Java Edition only]}. And the target selector must‌^{[JE only]}/should‌^{[BE only]} be of player type.

JE: <targets>: entity (in query mode)

Specifies the target of the command.

Must be a player name, a target selector or a UUID. And the target selector must be of single-player type.

Result[]

Output[]

Examples[]

• To display Steve's current level: experience query Steve levels‌^{[Java Edition only]}
• To give 7 experience to yourself: xp 7‌^{[Bedrock Edition only]} or experience add @s 7‌^{[Java Edition only]}
• To give 3 levels to Alice: xp 3L Alice‌^{[Bedrock Edition only]} or xp add Alice 3 levels‌^{[Java Edition only]}
• To remove all levels from all players: xp -2147483648L @a‌^{[Bedrock Edition only]} or xp set @a 0‌^{[Java Edition only]} or xp set @a 0 levels‌^{[Java Edition only]}

History[]