Commands/gamerule

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

• 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

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 () 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

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

• 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

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

Java Edition
1.4.2		12w32a			Added /gamerule.
1.6.1		13w23a			Added gamerule naturalRegeneration.
		13w24a			Added gamerule doDaylightCycle.
1.8		14w03a			Added gamerule logAdminCommands.
		14w10a			Added gamerule showDeathMessages.
		14w17a			Added gamerule randomTickSpeed.
		14w26a			Added gamerule sendCommandFeedback.
		14w29a			Added the ability to create dummy gamerules.
1.9		15w51a			Added gamerule spawnRadius.
		16w07a			Added gamerule disableElytraMovementCheck.
1.11		16w38a			Added gamerule doWeatherCycle.
					Added gamerule maxEntityCramming.
1.12		17w13a			Added gamerule doLimitedCrafting.
		17w16b			Added gamerule maxCommandChainLength.
		17w18a			Added gamerule announceAdvancements.
		pre1			Added gamerule gameLoopFunction.
1.13		17w45a			No longer accepts unknown values (custom gamerules).
					Values are now type-checked.
		17w49b			Removed the gameLoopFunction gamerule.
1.14.3		pre3			Added /gamerule disableRaids.
Pocket Edition
1.0.5		alpha 1.0.5.0			Added /gamerule.
1.1.0		alpha 1.1.0.0			Added the dodaylightcycle, doentitydrops, dofiretick, domobspawning, domobloot, dotiledrops, doweathercycle, keepinventory and mobgriefing gamerules.
Bedrock Edition
1.6.0		beta 1.6.0.6			Added the doinsomnia gamerule.
1.7.0		beta 1.7.0.2			Added the commandblocksenabled gamerule.
1.8.0		beta 1.8.0.8			Added the randomTickSpeed gamerule.
1.9.0		beta 1.9.0.0			Added the showdeathmessages gamerule.
					Added the immediaterespawn gamerule.
Upcoming Bedrock Edition
1.12.0		beta 1.12.0.2			Added the spawnradius gamerule.
					Added the sendcommandblockfeedback gamerule.