Commands/gamerule

From Minecraft Wiki
Jump to: navigation, search
gamerule
Restrictions

Operator

First introduced

Java 1.4.2 (Java 12w32a)
Pocket 1.0.5 (Pocket alpha 1.0.5.0)

Sets or queries a game rule value.

Syntax[edit]

  • Java Edition
gamerule <rule name> [value]
Arguments in Java Edition are case sensitive.
  • Bedrock Edition
gamerule <rule: BoolGameRule> [true|false]
gamerule maxcommandchainlength [value: int]

Arguments[edit]

Arguments in Bedrock Edition are shown for tab autocompletion as lowercase, but when typed are case-insensitive.
rule name (BE: rule: BoolGameRule)
Specifies the game rule to set or query. Only certain predefined game rules will affect gameplay (see Predefined Game Rules below).
value (BE: true|false or value: int) (optional)
Specifies the value to set the game rule to. Only true or false specified for predefined game rules will really affect gameplay, except in the case of maxEntityCramming, randomTickSpeed, spawnRadius, and maxCommandChainLength where any integer 0 or greater will affect gameplay (see Predefined Game Rules below).
Predefined Game Rules
Rule Name Description Default Value Type Java Edition Bedrock Edition
announceAdvancements Whether advancements should be announced in chat true Bool Yes No
commandBlocksEnabled Whether command blocks should be enabled in-game true Bool No Yes
commandBlockOutput Whether command blocks should notify admins when they perform commands true Bool Yes Yes
disableElytraMovementCheck Whether the server should skip checking player speed when the player is wearing elytra. Often helps with jittering due to lag in multiplayer, but may also be used to travel unfairly long distances in survival mode (cheating). false Bool Yes No
disableRaids Whether raids are disabled. false Bool Yes No
doDaylightCycle Whether the day-night cycle and moon phases progress true Bool Yes Yes
doEntityDrops Whether entities that are not mobs should have drops true Bool Yes Yes
doFireTick Whether fire should spread and naturally extinguish true Bool Yes Yes
doInsomnia Whether phantoms will spawn in the nighttime true Bool No Yes
doLimitedCrafting Whether players should only be able to craft recipes that they've unlocked first false Bool Yes No
doMobLoot Whether mobs should drop items true Bool Yes Yes
doMobSpawning Whether mobs should naturally spawn. Does not affect monster spawners. true Bool Yes Yes
doTileDrops Whether blocks should have drops true Bool Yes Yes
doWeatherCycle Whether the weather will change true Bool Yes Yes
drowningdamage Whether the player should take damage when drowning true Bool No Yes
falldamage Whether the player should take fall damage true Bool No Yes
firedamage Whether the player should take fire damage true Bool No Yes
keepInventory Whether the player should keep items in their inventory after death false Bool Yes Yes
logAdminCommands Whether to log admin commands to server log true Bool Yes No
maxCommandChainLength Determines the number at which the chain command block acts as a "chain". 65536 Int Yes Yes
maxEntityCramming The maximum number of other pushable entities a mob or player can push, before taking 3 (Heart.svgHalf Heart.svg) suffocation damage per half-second. Setting to 0 disables the rule. Damage affects survival-mode or adventure-mode players, and all mobs but bats. Pushable entities include non-spectator-mode players, any mob except bats, as well as boats and minecarts. 24 Int Yes No
mobGriefing Whether creepers, zombies, endermen, ghasts, withers, ender dragons, rabbits, sheep, villagers, and snow golems should be able to change blocks and whether mobs can pick up items true Bool Yes Yes
naturalRegeneration Whether the player can regenerate health naturally if their hunger is full enough (doesn't affect external healing, such as golden apples, the Regeneration effect, etc.) true Bool Yes Yes
pvp Whether the player can fight with other players true Bool No Yes
randomTickSpeed How often a random block tick occurs (such as plant growth, leaf decay, etc.) per chunk section per game tick. 0 will disable random ticks, higher numbers will increase random ticks. Setting to a high integer results in high speeds of decay and growth 3 Int Yes Yes
reducedDebugInfo Whether the debug screen shows all or reduced information; and whether the effects of F3+B (entity hitboxes) and F3+G (chunk boundaries) are shown. false Bool Yes No
sendCommandFeedback Whether the feedback from commands executed by a player should show up in chat. Also affects the default behavior of whether command blocks store their output text true Bool Yes Yes
showcoordinates Whether the player's coordinates are displayed true Bool No Yes
showDeathMessages Whether death messages are put into chat when a player dies. Also affects whether a message is sent to the pet's owner when the pet dies. true Bool Yes Yes
spawnRadius The number of blocks outward from the world spawn coordinates that a player will spawn in when first joining a server or when dying without a personal spawnpoint. 10 Int Yes No
spectatorsGenerateChunks Whether players in spectator mode can generate chunks true Bool Yes No
tntexplodes Whether TNT will explode true Bool No Yes

Result[edit]

Fails if rule name is not defined and value is not provided (i.e., attempting to query an undefined game rule), or if "rule name is not a predefined game rule ‌[Java Edition only].
On success, returns the value of the game rule (if value is not provided) or sets the game rule to the specified value (if value is provided).

Examples[edit]

  • 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 keep all of your valuables when you die: gamerule keepInventory true

Additional Behavior[edit]

This section is dedicated to explaining more complex behaviors of certain gamerules.[more information needed]

  • disableRaids[upcoming: JE 1.14.3]
    • When true, the Bad Omen will not be removed from a player when entering a village.
    • If set to true while a raid is in progress, the raid will stop, but the existing raid mobs will not despawn.
  • doTileDrops
    • When false, containers will still drop their contents, but not themselves.
      • Shulker boxes will not drop anything, causing the items in them to be lost.
  • mobGriefing
    • Prevents creepers from destroying blocks when they explode, though they will still damage entities.
    • Prevents blazes from creating fire.
    • Prevents ghast fireballs from exploding blocks and creating fire.
    • Prevents villagers from farming and picking up items. However, they can still open doors and throw items.
    • Prevents sheep from turning grass blocks into dirt, but does not prevent the regrowth of wool.[more information needed]
    • Prevents the ender dragon from destroying blocks, causing it to just fly through them instead.
    • Prevents the wither and its heads from destroying blocks with their explosions.
    • Prevents endermen from picking up or placing blocks.
    • Prevents zombies from breaking doors.
    • Prevents rabbits from eating carrot crops.
    • Prevents snow golems from creating snow trails.
    • Prevents ravagers from destroying crops and leaves.
    • Prevents all mobs from trampling crops.
    • Has no effect on the player.

History[edit]

Java Edition
1.4.212w32aAdded /gamerule.
1.6.113w23aAdded gamerule naturalRegeneration.
13w24aAdded gamerule doDaylightCycle.
1.814w03aAdded gamerule logAdminCommands.
14w10aAdded gamerule showDeathMessages.
14w17aAdded gamerule randomTickSpeed.
14w26aAdded gamerule sendCommandFeedback.
14w29aAdded the ability to create dummy gamerules.
1.915w51aAdded gamerule spawnRadius.
16w07aAdded gamerule disableElytraMovementCheck.
1.1116w38aAdded gamerule doWeatherCycle.
Added gamerule maxEntityCramming.
1.1217w13aAdded gamerule doLimitedCrafting.
17w16bAdded gamerule maxCommandChainLength.
17w18aAdded gamerule announceAdvancements.
pre1Added gamerule gameLoopFunction.
1.1317w45aNo longer accepts unknown values (custom gamerules).
Values are now type-checked.
17w49bRemoved the gameLoopFunction gamerule.
1.14.3pre3Added /gamerule disableRaids.
Pocket Edition
1.0.5alpha 1.0.5.0Added /gamerule.
1.1.0alpha 1.1.0.0Added the dodaylightcycle, doentitydrops, dofiretick, domobspawning, domobloot, dotiledrops, doweathercycle, keepinventory and mobgriefing gamerules.
Bedrock Edition
1.6.0beta 1.6.0.6Added the doinsomnia gamerule.
1.7.0beta 1.7.0.2Added the commandblocksenabled gamerule.
1.8.0beta 1.8.0.8Added the randomTickSpeed gamerule.
1.9.0beta 1.9.0.0Added the showdeathmessages gamerule.
Added the immediaterespawn gamerule.
Upcoming Bedrock Edition
1.12.0beta 1.12.0.2Added the spawnradius gamerule.
Added the sendcommandblockfeedback gamerule.