/trigger
Changes the executor player's score in a scoreboard objective with a "trigger" criterion, and un-enables the objective for this player. Allows non-operator players to modify their own scoreboard objectives under tightly controlled conditions. Often used to let players activate systems controlled by data packs or command blocks.
This article is about the command. For triggers in advancement definitions, see Advancement definition § List of triggers.
/trigger| Permission level required |
0 |
|---|---|
| Restrictions | None |
Changes the executor player's score in a scoreboard objective with a "trigger" criterion, and un-enables the objective for this player. Allows non-operator players to modify their own scoreboard objectives under tightly controlled conditions. Often used to let players activate systems controlled by data packs or command blocks.
Syntax
trigger <objective>
- Adds
1to the current value of<objective>.
trigger <objective> add <value>
- Adds
<value>to the current value of<objective>.
trigger <objective> set <value>
- Sets the value of
<objective>to<value>.
Arguments
<objective>: objective
- An enabled scoreboard objective with the "trigger" criterion.
- It must be a single word. (Allowed characters include:
-,+,.,_,A-Z,a-z, and0-9) It resolves into a scoreboard objective during command execution.
<value>: integer
- Specifies the value to be set to or added to the objective.
- Must be a [Int]32-bit integer number (from -2147483648 (-231) to 2147483647 (231-1) ).
Result
| Command | Trigger | Java Edition |
|---|---|---|
| Any | the arguments are not specified correctly | Unparseable |
| the objective does not exist | Failed | |
| the objective isn't the "trigger" type | ||
| the executor is not a player | ||
| the executor isn't on the scoreboard objective. | ||
| the objective has not been "enabled" for the player | ||
| Otherwise | Successful |
Output
| Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| Any | Java Edition | On fail | 0 | 0 | 0 |
| On success | 1 | 1 | The objective's score of the player after the command is executed. |
History
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.8 | 14w06a | Added /trigger. | |||||
| 1.13 | 17w45a | Added /trigger <objective> as a new syntax as a shortcut for /trigger <objective> add 1. | |||||