Editing MinecraftCommands (section)

=== worldborder ===

{{/infobox
|worldborder
|op
|1.8|14w17a
}}

These commands control the [[world border]].

;Syntax

: The command has eight variations, each with different arguments:
: <code>worldborder add <''distance''> [''time'']</code> (increases the world border diameter)
: <code>worldborder center <''x''> <''z''></code> (recenters the world boundary)
: <code>worldborder damage amount <''damagePerBlock''></code> (specifies the world border damage rate)
: <code>worldborder damage buffer <''distance''></code> (specifies the world border damage buffer distance)
: <code>worldborder get</code> (returns the world border diameter)
: <code>worldborder set <''distance''> [''time'']</code> (sets the world border diameter)
: <code>worldborder warning distance <''distance''></code> (specifies the world border warning distance)
: <code>worldborder warning time <''time''></code> (specifies the world border warning time)

;Arguments

: ''distance'' (<code>add</code>, <code>damage buffer</code>, <code>set</code> and <code>warning distance</code> modes only)
:: Specifies a distance in blocks:
::* <code>add</code> – Specifies the number of blocks to add to the world border diameter.
::* <code>damage buffer</code> – Specifies the distance outside the world buffer a player must be before they start taking damage. Must be at least 0.0. Initially set to 5.0.
::* <code>set</code> – Specifies the new diameter for the world border. Must be between 1.0 and 60,000,000 (inclusive, without the commas).
::* <code>warning distance</code> – Specifies the distance from the world border at which players will begin to see a visual warning of the world border's proximity. Must be at least 0. Initially set to 5.

: ''time'' (<code>add</code>, <code>set</code> and <code>warning time</code> modes only)
:: Specifies a time in seconds:
::* <code>add</code> – Specifies the number of seconds it should take for the world border to move from its current diameter to the new diameter. Must be at least 0. If not specified, defaults to 0.
::* <code>set</code> – Specifies the number of seconds it should take for the world border to move from its current diameter to the new diameter. Must be at least 0. If not specified, defaults to 0.
::* <code>warning time</code> – Specifies the number of seconds that a player will begin to see a visual warning before a moving world border passes their position. Must be at least 0. Initially set to 15.

: ''x z'' (<code>center</code> mode only)
:: Specifies the horizontal coordinates of the world border's center. Must be between [[World border|-30,000,000 and 30,000,000]] (inclusive, without the commas). May use [[#Tilde notation|tilde notation]] to specify coordinates relative to the command's execution.

: ''damagePerBlock'' (<code>damage amount</code> mode only)
:: Specifies the damage a player takes per second per block past the world border buffer. For example, if ''damagePerBlock'' is 0.1, a player 5 blocks outside the world border buffer will take 0.5 damage per second (damage less than half a heart might not change the visual health display, but will still accumulate). Must be at least 0.0. Initially set to 0.2.

;Result

: Fails if the arguments are not specified correctly, or if the new world diameter will be less than 1.0 or greater than 60,000,000.

: On success:

:* <code>add</code> – The world border begins changing its diameter by the specified amount. If ''distance'' is positive, the world border will turn green and start increasing; if negative, the world border will turn red and start decreasing. If ''time'' is 0 or unspecified, the change occurs immediately; otherwise the change proceeds at a rate of (''distance''/2)/''time'' blocks per second.

:* <code>center</code> – The center of the world border immediately moves to the specified coordinates.

:* <code>damage amount</code> –  Sets the world border damage amount to the specified value. Any player outside the world border buffer will take this amount of damage per second per block past the world border buffer distance.

:* <code>damage buffer</code> – Sets the world border buffer distance to the specified value. Players won't take damage until they move past this distance from the world border.

:* <code>get</code> – Shows the current world border diameter in the chat.

:* <code>set</code> – The world border begins changing its diameter to the specified value. If ''distance'' is bigger than the current diameter, the world border will turn green and start increasing; if smaller, the world border will turn red and start decreasing. If ''time'' is 0 or unspecified, the change occurs immediately; otherwise the change proceeds at a rate of ((''distance''-<current diameter>)/2)/''time'' blocks per second.

:* <code>warning distance</code> – Sets the world border warning distance to the specified value.

:* <code>warning time</code> – Sets the world border warning time to the specified value.


<!-- please retain double newline above for section differentiation -->