This feature is exclusive to Java Edition.
These commands control the world border.
Syntax[]
worldborder add <distance> [<time>]
Increases or decreases the world border diameter.worldborder center <pos>
Recenters the world boundary.worldborder damage amount <damagePerBlock>
Sets the world border damage amount to the specified value. Any player outside the world border buffer takes this amount of damage per second per block past the world border buffer distance.worldborder damage buffer <distance>
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.worldborder get
Returns the current world border diameter.worldborder set <distance> [<time>]
Sets the world border diameter.worldborder warning distance <distance>
Sets the world border warning distance to the specified value.worldborder warning time <time>
Sets the world border warning time to the specified value.Arguments[]
<distance>: double (in add mode)
Specifies the number of blocks to add to the world border diameter. Must be a Double-precision floating-point format number. And it must be between -59,999,968 and 59,999,968 (inclusive).<time>: integer (in add and set mode)
Specifies the number of seconds it should take for the world border to move from its current diameter to the new diameter. If not specified, defaults to 0. Must be a 32-bit integer number. And it must be between 0 and 2147483647 (inclusive).<pos>: vec2
Specifies the horizontal coordinates of the world border's center. Must be a two-dimensional coordinates with floating-point number elements. Accepts tilde and caret notations.<damagePerBlock>: float
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 takes 0.5 damage per second (damage less than half a heart might not change the visual health display, but still accumulates). Initially set to 0.2. Must be a Single-precision floating-point format number. And it must be greater than or equal to 0.0.<distance>: float (in damage buffer mode)
Specifies the distance outside the world buffer a player must be before they start taking damage. Initially set to 5.0. Must be a Single-precision floating-point format number. And it must be greater than or equal to 0.0.<distance>: double (in set mode)
Specifies the new diameter for the world border. Must be a Double-precision floating-point format number. And it must be between -59,999,968 and 59,999,968 (inclusive).<distance>: integer (in warning distance mode)
Specifies the distance from the world border at which players begins to see a visual warning of the world border's proximity. Initially set to 5. Must be a 32-bit integer number. And it must be between 0 and 2147483647 (inclusive).<time>: integer (in warning time mode)
Specifies the number of seconds that a player begins to see a visual warning before a moving world border passes their position. Initially set to 15. Must be a 32-bit integer number. And it must be between 0 and 2147483647 (inclusive).Result[]
| any | the arguments are not specified correctly | Unparseable |
| /worldborder add ... /worldborder set ... | the size is unchanged | Failed |
| the new size is less than 1.0 or greater than 59,999,968 | ||
| /worldborder center ... | the center is unchanged | |
| /worldborder damage amount ... | the damage amount is unchanged | |
| /worldborder damage buffer ... | the damage buffer is unchanged | |
| /worldborder warning distance ... | the warning distance is unchanged | |
| /worldborder warning time ... | the warning time is unchanged | |
| any | On success | Manages the world border. |
Output[]
| any | Java Edition | On fail | 0 | 0 | 0 |
| /worldborder add ... | On success | 1 | 1 | the specified <distance> | |
| /worldborder center ... | On success | 1 | 1 | 0 | |
| /worldborder damage amount ... | On success | 1 | 1 | the specified <damagePerBlock> | |
| /worldborder damage buffer ... | On success | 1 | 1 | the specified <distance> | |
| /worldborder get | On success | 1 | 1 | the size of the world border after rounding to the nearest integer | |
| /worldborder set ... | On success | 1 | 1 | the amount of change in the width of the world border (a positive number means an increase, a negative number means a decrease). | |
| /worldborder warning distance ... | On success | 1 | 1 | the specified <distance> | |
| /worldborder warning time ... | On success | 1 | 1 | the specified <time> |
Notes[]
In add or set mode, if successful, the world border begins changing its diameter by the specified amount. If diameter is increasing, the world border turns green; if decreasing, the world border turns red. If <time> is 0 or unspecified, the change occurs immediately; otherwise the change proceeds at a rate of (Distance difference/2)/time blocks per second.
In center mode, if successful, the center of the world border immediately moves to the specified coordinates.
History[]
This section is missing information about the upcoming update for the world border's radius that controlled by float replaced by double.
Please expand the section to include this information. Further details may exist on the talk page.
| Added /worldborder. |
| Added /worldborder damage <distance>. |
| Added /worldborder warning (distance|time). |
| Added /worldborder add <distance>. |
| Added /worldborder get. |
Commands
This article is about the customizable border. For the physical edge of the playable world, see World boundary. For the phenomenon that existed before Beta 1.8, see Far Lands. For the command, see Commands/worldborder.
Not to be confused with Border.
This feature is exclusive to Java Edition.
The world border is the current edge of a Minecraft dimension.
Appearance[]
The world border from the outside using the /tp command.
The world border appears as a series of animated, diagonal, narrow stripes.
The world border is tinted depending on how how size changes. When the border is not moving, the stripes are a translucent aqua color. If the border is expanding, the stripes appear green (the translucency of this green is unknown); if the border is shrinking, the lines appear red (the translucency of this red is also unknown). If the world border is moving but its size is not changing, what color it appears as is unknown.[more information needed]
The world border appears different depending on the current graphics setting, which is very likely not intended;[1] on Fast and Fancy it appears as light and translucent, but on Fabulous! it appears considerably darker.
Size[]
The world border is essentially a giant bounding box; by default, its center lies at coordinates above Y: 255.
With commands, the size and position of the border can be modified. The world border always behaves in full block increments, even if it is set to a partial block. Its default size and location remain the same across all three default dimensions. Custom dimensions can have individual sizes. If it is in the Nether, it appears red, regardless of whether the border is expanding, shrinking or not moving.
Effects[]
On entities[]
Most entities, with exception to some projectiles, are unable to move through the world border.
If a dispenser or dropper is placed so that it directly faces the edge of the border, then items, projectiles, TNT, etc. can be fired outside of the edge of the border. Any items fired out of a dispenser float in midair; if an item is dropped from the player inventory, the item falls normally.
If a mob is spawned from a dispenser via a spawn egg, the mob behaves normally. Spiders can climb the world border, and endermen can teleport outside of it.
Any players on the outside of the world border (with exception to those in Creative or Spectator mode) take constant damage as long as they are outside the border. The amount of damage depends on the distance to the border.
While players themselves cannot move through the world border, even if they manage to go ahead of chunk loading, they can reach the other side of the world border through other means, including:
- Letting the world border pass them as it is shrinking
- Throwing an ender pearl through the world border
- Mounting a minecart, boat, horse, or pig
- Using commands such as /teleport.
- Sleeping next to the world border
- Consuming Chorus Fruit near the world border and being teleported beyond it.
- Dying and respawning, if the spawn point is outside the world border
Entities cannot spawn naturally outside the world border. They persist without taking damage if they spawned before the world border gets shrunk by a command.
On blocks[]
Players cannot normally place and destroy blocks, nor interact with objects outside of the world border, as there are no hitboxes. It is possible to place blocks outside of the world border, either by placing the block against one that is inside the world border or by using commands.
Most blocks still function outside the world border, and most redstone contraptions still function as well. Exceptions include falling blocks (such as sand and gravel), which drop as an item, and pistons or hoppers, which simply don't function. Explosions from TNT and other sources also work normally, destroying terrain outside of the border. Light from torches and other sources also remain unaffected.
Liquids flow through the world border, so long as they are placed inside the border.
Liquids can flow through the border and continue flowing until reaching their flow limit. Liquids cannot be placed on the outside of the border.[2] Liquids placed via a dispenser flow as normal. Mixing water and lava with a dispenser results in the flow of each liquid abruptly ending, presumably because the stone, cobblestone, or obsidian that would normally generate does not.
When set to invalid values[]
The world border size can be changed by manually editing the level.dat file. In any case, there remains a world boundary at 30 million blocks on both the X and Z axes.
- When set to a negative number, the entire world is treated as outside the world border, and the border warning overlay appears throughout the world. No blocks can be mined and entities take damage unless they are within the border safe zone.
- When set to NaN, the entire world is treated as outside the world border, but no border warning appears. No blocks can be mined, even in Creative mode, although entities do not take damage.
- When set to infinity, the border occurs normally.
Commands[]
Main article: Commands/worldborder
Set /worldborder set <sizeInBlocks> [timeInSeconds] Sets the border to a square region with the specified size in blocks as the width and length. Optionally, a timeInSeconds may be specified such that the border grows or shrinks from the previous width to that being set over the specified time in seconds. If timeInSeconds is not specified, the world border changes immediately. To reset the world border size, set sizeInBlocks to 59,999,968. The border still grows or shrinks and the animation displays even if the game is paused. Center /worldborder center <x> <z> Sets the center of the area inside the world border to the specified <x> and <z> coordinates. Tilde (~) can be used as a relative coordinate. To reset the world border center, set both <x> and <z> to 0 (zero). Add /worldborder add <sizeInBlocks> [timeInSeconds] Adds or subtracts sizeInBlocks to/from the current world border width and length. sizeInBlocks may be a positive or negative number. Optionally, a timeInSeconds may be specified such that the border grows or shrinks from the current width to that being set over the specified time in seconds. Damage /worldborder damage buffer <sizeInBlocks> Sets the number of blocks a player may safely be outside the world border before taking damage. The default is 5 blocks. /worldborder damage amount <damagePerBlock> Sets the amount of damage a player takes when outside the world border plus the world border buffer. The default is 0.2 damage per second per block. Warning /worldborder warning time <timeInSeconds> Causes the screen to be tinted red when a contracting world border reaches the player within the specified time. The default is 15 seconds. The tint does not display if the user is using fast graphics. /worldborder warning distance <sizeInBlocks> Causes the screen to be tinted red when the player is within the specified number of blocks from the world border. The default is 5 blocks. The tint does not display if the user is using fast graphics. Get /worldborder get Returns the current width of the world border.Data values[]
World data[]
Java Edition:
- level.dat
- Data
- BorderCenterX: center of the world border (X-axis)
- BorderCenterZ: center of the world border (Z-axis)
- BorderDamagePerBlock: damage taken per block moved outside the world border
- BorderSafeZone: distance in blocks of the buffer zone where damage is not taken when outside the world border
- BorderSize: world border diameter
- BorderSizeLerpTarget:[more information needed]
- BorderSizeLerpTime:[more information needed]
- BorderWarningBlocks: maximum distance away from the border where the border warning overlay appears on the player
- BorderWarningTime: time in seconds[verify] until the border warning overlay appears
- Data
History[]
| Dinnerbone tweets a previews of the "shimmery" world border textures, which were made by Ryan Holtz. |
| Added the customizable world border. |
| Players cannot interact with blocks outside the world border anymore. |
| "Warning" and "damage" commands added. |
| A red-colored warning aura is seen when within a certain distance of the world border. |
| The border in the Nether is now the same size as that of the Overworld. |
| Traveling to the Nether no longer creates new portals outside the boundary. |
| If you're stuck outside the world border, it is possible to freely fly/walk around, though you gradually lose hearts. Not possible to freely walk through the border from the inside. |
| "Add" command added. |
| "Get" command added, which shows the current size of the border. |
| Command blocks no longer work outside of the border. Unclear if this is a bug or intended. |
| Hoppers outside of the world border no longer function. |
| The time parameter of the world border size-changing can now be larger. |
| Only players take damage outside of the world border. |
| The world border can be set to 60 million, but is visually and functionally clamped to a value below that. |
| The world border now follows the player vertically.[3] |
| The world border no longer follows the player vertically, but is still correctly displayed outside of the world height bounds. |
| The world border's faces are now all identically oriented, resulting in no V or ^ shapes forming at two corners.[4] |
| The world border size is now stored as a double instead of a float.[5] |
| The max world border size has been shrunk to the value it would always maximally appear at, and cannot be set above that value with commands. |
Issues[]
Issues relating to "World border" are maintained on the bug tracker. Report issues there.
Trivia[]
- The reason the default world border is at X/Z ±29,999,984 is due to the fact that Dinnerbone put it 1 chunk (16 blocks) short of the edge to prevent falling through the world.[6]
- Despite this, it became impossible to fall through the world at high distances in early 1.7 development, over half a year before the world border's implementation.
- Were a Minecraft world wrapped around with the borders together, the resulting planet has a circumference of 60000 kilometres or 9549 kilometres in radius, twice as large as Earth.
Gallery[]
There are no hitboxes in the world border.
Due to a bug in coordinate system, liquids can be placed outside the border, but they do not flow.
Mobs and items float outside the border.
Dying from border damage results in the death message: "[Player] suffocated in a wall"
Blocks can be placed on both sides of the world border.
Eroded badlands biome, found at the edge of the world. Check the image for seed and cords.
References[]
See also[]
Environment