Minecraft:Commands/random: Difference between revisions
From SAS Gaming Wiki
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{exclusive|java}} | ||
{{Infobox command | {{Infobox command | ||
|name=random | |name=random | ||
| Line 7: | Line 7: | ||
}} | }} | ||
Generates a random integer, or controls random | Generates a random integer, or controls [[Minecraft:random sequence]]s in the world. | ||
== Syntax == | == Syntax == | ||
| Line 26: | Line 26: | ||
: Removes and re-creates a random sequence with the settings of the world. If the sequence does not exist, it is just created. | : Removes and re-creates a random sequence with the settings of the world. If the sequence does not exist, it is just created. | ||
<code>random | <code>random reset <sequence> <seed> [<includeWorldSeed>] [<includeSequenceId>]</code> | ||
: Removes and re-creates a random sequence with the specified settings instead of the settings of the world. If the sequence does not exist, it is just created. | : Removes and re-creates a random sequence with the specified settings instead of the settings of the world. If the sequence does not exist, it is just created. | ||
{{ | {{see also|Random sequence format#Usage}} | ||
== Arguments == | == Arguments == | ||
| Line 37: | Line 37: | ||
: If it is <code>value</code>, the result is displayed in chat only to the player executing the command. If <code>roll</code>, the result is broadcasted to all players. | : If it is <code>value</code>, the result is displayed in chat only to the player executing the command. If <code>roll</code>, the result is broadcasted to all players. | ||
{{ | {{argument|range|int_range}} | ||
: Specifies the range to pick the random number from. The size of the range (calculated by <code>max - min + 1</code>) should be between 2 and 2147483646. | : Specifies the range to pick the random number from. The size of the range (calculated by <code>max - min + 1</code>) should be between 2 and 2147483646. | ||
: {{ | : {{arg desc|je=int_range}} | ||
{{ | {{argument|sequence|resource_location}} | ||
: Specifies the resource location of a random sequence to sample or reset. | : Specifies the [[Minecraft:resource location]] of a [[Minecraft:random sequence]] to sample or reset. | ||
: If there's no sequence with the specified resource location, it is created. | : If there's no sequence with the specified [[Minecraft:resource location]], it is created. | ||
: {{ | : {{arg desc|je=resource_location}} | ||
{{ | {{argument|seed|int}} | ||
: The salt value. | : The salt value. | ||
: {{ | : {{arg desc|je=integer}} | ||
{{ | {{argument|includeWorldSeed|bool}} | ||
: Whether to incorporate the world seed value with the specified <code><seed></code> when seeding a random sequence. If not specified, defaults to <code>true</code>. | : Whether to incorporate the world seed value with the specified <code><seed></code> when seeding a random sequence. If not specified, defaults to <code>true</code>. | ||
: {{ | : {{arg desc|je=bool}} | ||
{{ | {{argument|includeSequenceId|bool}} | ||
:Whether to incorporate the hash of the ID with the specified <code><seed></code> when seeding a random sequence. If not specified, defaults to <code>true</code>. | :Whether to incorporate the hash of the ID with the specified <code><seed></code> when seeding a random sequence. If not specified, defaults to <code>true</code>. | ||
: {{ | : {{arg desc|je=bool}} | ||
== Examples == | == Examples == | ||
{{ | {{code|/random roll 1..5}} | ||
Rolls a random number between 1 and 5 and writes it in chat | Rolls a random number between 1 and 5 and writes it in chat | ||
{{ | {{code|execute store result score @p random_number run random value 1..10}} | ||
Generates a random number between 1 and 10 and stores it in a scoreboard called {{ | Generates a random number between 1 and 10 and stores it in a scoreboard called {{code|random_number}} for the nearest player | ||
{{ | {{code|/execute store result score player random_number run random value 1..3}} | ||
{{code|/tellraw @a [{text:"Rolled number "},{"score": {"name": "player", "objective": "random_number"} }]}} | {{code|/tellraw @a [{text:"Rolled number "},{"score": {"name": "player", "objective": "random_number"} }]}} | ||
| Line 76: | Line 76: | ||
{{Result table|onlyje=1}} | {{Result table|onlyje=1}} | ||
{{Result table|the arguments are not specified correctly|unparseable}} | {{Result table|the arguments are not specified correctly|unparseable}} | ||
{{Result table|cmd=/random (value{{!}}roll) ...|{{ | {{Result table|cmd=/random (value{{!}}roll) ...|{{Cd|<range>}}range is less than 2 or greater than 2147483646|fail}} | ||
{{Result table|cmd=|success}} | {{Result table|cmd=|success}} | ||
{{Result table}} | {{Result table}} | ||
| Line 82: | Line 82: | ||
== Output == | == Output == | ||
{{ | {{Output table}} | ||
{{ | {{Output table|edition=je|On fail|0|0|0}} | ||
{{Output table|cmd=/random (value{{!}}roll) ... |On success|1|1|the obtained random value}} | {{Output table|cmd=/random (value{{!}}roll) ... |On success|1|1|the obtained random value}} | ||
{{ | {{Output table|cmd=/random reset <sequence> ... |On success|1|1|1}} | ||
{{ | {{Output table|cmd=/random reset * ... |On success|1|1|the number of random sequences currently in the world}} | ||
{{ | {{Output table}} | ||
== History == | == History == | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|Java}} | ||
|{{HistoryLine||1.20.2|dev=23w31a|Added {{ | |{{HistoryLine||1.20.2|dev=23w31a|Added {{cd|/random}}.}} | ||
}} | }} | ||
== Navigation == | == Navigation == | ||
{{ | {{Navbox commands}} | ||
de:Befehl/random | [[Minecraft:de:Befehl/random]] | ||
ja:コマンド/random | [[Minecraft:fr:Commandes/random]] | ||
pt:Comandos/random | [[Minecraft:ja:コマンド/random]] | ||
ru:Команды консоли/random | [[Minecraft:pt:Comandos/random]] | ||
zh:命令/random | [[Minecraft:ru:Команды консоли/random]] | ||
[[Minecraft:zh:命令/random]] | |||
Latest revision as of 11:04, 26 July 2026
Template:Exclusive Template:Infobox command
Generates a random integer, or controls Minecraft:random sequences in the world.
Syntax
random (value|roll) <range>
- Outputs a random integer.
- Range is given by two integers separated by two periods where the first given number must always be smaller than the second given number.
random (value|roll) <range> <sequence>
- Samples a random integer from the specified random sequence. If the sequence does not exist, it is created with the random sequence settings of the world.
random reset *
- Removes all the random sequences in the world. A random sequence is created with the settings of the world when called by a loot table.
random reset * <seed> [<includeWorldSeed>] [<includeSequenceId>]
- Removes all the random sequences in the world, and sets the random sequence settings of the world. The setting of the world is
0,true,true, if having not executed/random reset * ...command in the world.
random reset <sequence>
- Removes and re-creates a random sequence with the settings of the world. If the sequence does not exist, it is just created.
random reset <sequence> <seed> [<includeWorldSeed>] [<includeSequenceId>]
- Removes and re-creates a random sequence with the specified settings instead of the settings of the world. If the sequence does not exist, it is just created.
Arguments
- Whether or not to notify other players of the results when extracting random numbers.
- If it is
value, the result is displayed in chat only to the player executing the command. Ifroll, the result is broadcasted to all players.
- Specifies the range to pick the random number from. The size of the range (calculated by
max - min + 1) should be between 2 and 2147483646. - Template:Arg desc
- Specifies the Minecraft:resource location of a Minecraft:random sequence to sample or reset.
- If there's no sequence with the specified Minecraft:resource location, it is created.
- Template:Arg desc
- The salt value.
- Template:Arg desc
- Whether to incorporate the world seed value with the specified
<seed>when seeding a random sequence. If not specified, defaults totrue. - Template:Arg desc
- Whether to incorporate the hash of the ID with the specified
<seed>when seeding a random sequence. If not specified, defaults totrue. - Template:Arg desc
Examples
Rolls a random number between 1 and 5 and writes it in chat
Generates a random number between 1 and 10 and stores it in a scoreboard called Template:Code for the nearest player
Generates a number between 1 and 3 and displays it with message "Rolled number <rolled number>"
Result
Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table
Output
Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table
History
Minecraft:de:Befehl/random Minecraft:fr:Commandes/random Minecraft:ja:コマンド/random Minecraft:pt:Comandos/random Minecraft:ru:Команды консоли/random Minecraft:zh:命令/random