This feature is exclusive to Java Edition.
The /random command can be used to draw a random value.
Syntax[]
/random (value|roll) <range> [<sequence>]
- Extract random numbers.
/random reset (*|<sequence>) [<seed>] [<includeWorldSeed>] [<includeSequenceId>]
- Reset the random number sequence.
Arguments[]
value|roll
- Whether or not to notify other players of the results when extracting random numbers. If this is
value, then the results are displayed only to the player using the command. If this isroll, then the results are revealed to all players.
<range>: range
- Specifies the range of random numbers to generate. The size of the range must be between 2 and 2147483646. If the upper and lower limits are not specified, 2147483647 and -2147483648 are assumed respectively.
- Specified as an integer within the value range (e.g.
0: exactly 0,..0: 0 or less,0..: 0 or more,0..1: between 0 and 1 inclusive).
<sequence>: resource_location
- Specify the namespace ID of the random number string to be used/reset .
random value|roll...Optional in syntax. The syntax can also specifyrandom reset...instead *, in which case all random numbers will be reset. If you specify a random number string that does not exist, the random number string is created on the spot and the command is executed.
<seed>: long
- The seed value used to reset the random number sequence.
<includeWorldSeed>: bool
- Whether to incorporate the world seed value when seeding the random number sequence. If set to
false(default), the random number sequence will be reset in the same way regardless of the world.
<includeSequenceId>: bool
- Whether to include the ID of the random number column when seeding the random number column. If set to
false(default), the result of resetting the random number sequence will be the same regardless of the random number sequence ID.
Result[]
| Command | Trigger | Java Edition |
|---|---|---|
| any | Incorrectly specified arguments | Unparseable |
random (value|roll) ... | <range>range is less than 2 or greater than 2147483646 | Failed |
| any | Otherwise | Successful |
Output[]
| Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| any | Java Edition | when failed | 0 | 0 | 0 |
/random (value|roll) ... | when successful | 1 | 1 | sampled random value | |
/random reset ... | when successful | 1 | 1 | number of random number sequences reset |
History[]
| Java Edition | |||||
|---|---|---|---|---|---|
| 1.20.2 | 23w31a | Added random. | |||