/gamerule
< Commands
/gamerule| Permission level required |
|
|---|---|
| Restrictions |
Cheat only for some rules |
{
"title": "<code>/gamerule</code>",
"rows": [
{
"field": "\n* 2 <sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Java Edition\">(link to Java Edition article, displayed as JE) only</span></i>]</sup>\n* 1 <sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE) only</span></i>]</sup>",
"label": "(link to Permission level article, displayed as Permission level<br>required)"
},
{
"field": "(link to Options article, displayed as Cheat) only for some rules<sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i><span title=\"This statement only applies to Bedrock Edition\">(link to Bedrock Edition article, displayed as BE) only</span></i>]</sup>",
"label": "(link to Commands#Restrictions article, displayed as Restrictions)"
}
],
"invimages": [],
"images": []
}
Sets or queries a game rule value.
Syntax
- Java Edition
gamerule <rule name> [<value>]
- Bedrock Edition
gamerule <rule: BoolGameRule> [value: Boolean]gamerule <rule: IntGameRule> [value: int]
Arguments
Arguments in Java Edition are case sensitive. Arguments in Bedrock Edition are shown for tab autocompletion as lowercase, but when typed are case-insensitive.
JE: <rule name>
BE: rule: BoolGameRule: enum and rule: IntGameRule: enum
- Specifies the game rule to set or query.
- Must be one of the predefined game rules; see Game rule.
JE: <value>
BE: value: Boolean: enum and value: int: int
- Specifies the value to set the game rule to. If not specified, queries the value of the game rule instead of setting it.
- Only
trueorfalsespecified for predefined game rules can affect gameplay, except in the case ofmaxEntityCramming,randomTickSpeed,spawnRadius,playersSleepingPercentage,functionCommandLimitandmaxCommandChainLengthwhere any integer affects (-2147483648~2147483647) gameplay; see Game rule.
Result
| Command | Trigger | Java Edition | Bedrock Edition |
|---|---|---|---|
| Any | The command is incomplete, or any argument is not specified correctly. | Unparseable | Unparseable |
| Otherwise | Successful | ||
Output
| Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| Any | Java Edition | On success | 1 | 1 | the current value of the game rule |
| Bedrock Edition | On success | 1 | N/A | N/A |
Examples
- To stop the day-night cycle:
gamerule doDaylightCycle false - To stop natural healing:
gamerule naturalRegeneration false - To stop creepers, ghasts and other mobs from modifying blocks:
gamerule mobGriefing false - To stop the natural cycle of weather:
gamerule doWeatherCycle false - To make players keep all of their valuables when they die:
gamerule keepInventory true - To stop TNT from exploding:
gamerule tntExplodes false - To stop command blocks from showing what they do:
gamerule commandBlockOutput false - To stop phantoms spawning:
gamerule doInsomnia false
History
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.4.2 | 12w32a | Added /gamerule. | |||||
| 1.8 | 14w29a | Added the ability to create custom dummy gamerules. | |||||
| 1.13 | 17w45a | /gamerule no longer accepts unknown values (dummy gamerules).
| |||||
Values to /gamerule are now type-checked. | |||||||
| Pocket Edition | |||||||
| 1.0.5 | alpha 1.0.5.0 | Added /gamerule. | |||||
| Bedrock Edition | |||||||
| ? | Command segments rule: BoolGameRule or rule: IntGameRule no longer accept dummy gamerules. | ||||||
See also
/mobevent– a command in Bedrock Edition for controlling the spawning of raids, patrols, and wandering traders