Minecraft Wiki
Don't have an account?
Register
Register
Minecraft Wiki
Minecraft Wiki
7,425
pages
in: Java Edition, Commands
English

Changes: Commands/worldborder

< Commands
Back to page
Sign in to edit
(History)
(→‎Result: 1.17)
(35 intermediate revisions by 22 users not shown)
Line 1: Line 1:
 
{{exclusive|java}}
  
{{exclusive|java}}
  +
{{Infobox command
−
{{:commands/infobox
  
−
|worldborder
 +
|name=worldborder
  +
|oplevel=2
−
|op
  
−
|Java Edition 1.8|Java Edition 14w17a
  
 
}}
  
}}
   
 
These commands control the [[world border]].
  
These commands control the [[world border]].
   
−
;Syntax
 +
==Syntax==
   
  +
<code>worldborder add <distance> [&lt;time&gt;]</code>
−
: The command has eight variations, each with different arguments:
  
−
: <code>worldborder add <''distance''> [''time'']</code> (increases the world border diameter)
 +
: Increases or decreases the world border diameter.
−
: <code>worldborder center <''x''> <''z''></code> (recenters the world boundary)
 +
<code>worldborder center <pos></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 damage amount <damagePerBlock></code>
  ⚫
: 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.
⚫
: <code>worldborder get</code> (returns the world border diameter)
  
−
: <code>worldborder set <''distance''> [''time'']</code> (sets the world border diameter)
 +
<code>worldborder damage buffer <distance></code>
−
: <code>worldborder warning distance <''distance''></code> (specifies the world border warning 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.
−
: <code>worldborder warning time <''time''></code> (specifies the world border warning time)
 +
<code>worldborder get</code>
  ⚫
: Returns the current world border diameter.
  +
<code>worldborder set <distance> [&lt;time&gt;]</code>
  ⚫
: Sets the world border diameter.
  +
<code>worldborder warning distance <distance></code>
  ⚫
: Sets the world border warning distance to the specified value.
  +
<code>worldborder warning time &lt;time&gt;</code>
  +
: Sets the world border warning time to the specified value.
   
−
;Arguments
 +
==Arguments==
   
  +
{{argument|distance|double}} (in <code>add</code> mode)
−
: ''distance'' (<code>add</code>, <code>damage buffer</code>, <code>set</code> and <code>warning distance</code> modes only)
  
−
:: Specifies a distance in blocks:
 +
: Specifies the number of blocks to add to the world border diameter.
  +
: {{arg desc|je=double|min=-59,999,968|max=59,999,968}}
−
::* <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)
 +
{{argument|time|integer}} (in <code>add</code> and <code>set</code> 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.
−
:: Specifies a time in seconds:
  
  +
: {{arg desc|je=integer|min=0}}
⚫
::* <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.
  
   
  +
{{argument|pos|vec2}}
−
: ''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.
 +
: Specifies the horizontal coordinates of the world border's center.
  +
: {{arg desc|je=vec2}}
   
−
: ''damagePerBlock'' (<code>damage amount</code> mode only)
 +
{{argument|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 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.
 +
: Specifies the damage a player takes per second per block past the world border buffer. For example, if <code><damagePerBlock></code> 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.
  +
: {{arg desc|je=float|min=0.0}}
   
  +
{{argument|distance|double}} (in <code>damage buffer</code> mode)
⚫
;Result
  
  ⚫
: Specifies the distance outside the world buffer a player must be before they start taking damage. Initially set to 5.0.
  +
: {{arg desc|je=double|min=0.0}}
   
  +
{{argument|distance|double}} (in <code>set</code> mode)
−
: 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.
  
  +
: Specifies the new diameter for the world border.
  +
: {{arg desc|je=double|min=-29,999,984|max=29,999,984}}
   
  +
{{argument|distance|integer}} (in <code>warning distance</code> mode)
−
: On success:
  
  ⚫
: 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.
  +
: {{arg desc|je=integer|min=0}}
   
  +
{{argument|time|integer}} (in <code>warning time</code> mode)
⚫
:* <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.
  
  ⚫
: 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.
  +
: {{arg desc|je=integer|min=0}}
   
  ⚫
==Result==
−
:* <code>center</code> – The center of the world border immediately moves to the specified coordinates.
  
   
  +
{{Result table|onlyje=1}}
⚫
:* <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.
  
  +
{{Result table|the arguments are not specified correctly|unparseable}}
  +
{{Result table|cmd=/worldborder add ...<br>/worldborder set ...|the size is unchanged|fail}}
  +
{{Result table|the new size is less than 1.0 or greater than 59,999,968}}
  +
{{Result table|cmd=/worldborder center ...|the center is unchanged}}
  +
{{Result table|cmd=/worldborder damage amount ...|the damage amount is unchanged}}
  +
{{Result table|cmd=/worldborder damage buffer ...|the damage buffer is unchanged}}
  +
{{Result table|cmd=/worldborder warning distance ...|the warning distance is unchanged}}
  +
{{Result table|cmd=/worldborder warning time ...|the warning time is unchanged}}
  +
{{Result table|cmd=|succeed|Manages the world border.}}
  +
{{Result table}}
   
  +
== Output ==
−
:* <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.
  
   
  +
{{Output table}}
⚫
:* <code>get</code> – Shows the current world border diameter in the chat.
  
  +
{{Output table|edition=je|On fail|0|0|0}}
  +
{{Output table|cmd=/worldborder add ...|On success|1|1|the specified {{cd|<distance>}}}}
  +
{{Output table|cmd=/worldborder center ...|On success|1|1|0}}
  +
{{Output table|cmd=/worldborder damage amount ...|On success|1|1|the specified {{cd|<damagePerBlock>}}}}
  +
{{Output table|cmd=/worldborder damage buffer ...|On success|1|1|the specified {{cd|<distance>}}}}
  +
{{Output table|cmd=/worldborder get|On success|1|1|the size of the world border after rounding to the nearest integer}}
  +
{{Output table|cmd=/worldborder set ...|On success|1|1|the amount of change in the width of the world border<br>(a positive number means an increase, a negative number means a decrease).}}
  +
{{Output table|cmd=/worldborder warning distance ...|On success|1|1|the specified {{cd|<distance>}}}}
  +
{{Output table|cmd=/worldborder warning time ...|On success|1|1|the specified {{cd|<<nowiki/>time>}}}}
  +
{{Output table}}
   
  +
==Notes==
−
:* <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.
  
   
  ⚫
In <code>add</code> or <code>set</code> 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 <code>&lt;time&gt;</code> is 0 or unspecified, the change occurs immediately; otherwise the change proceeds at a rate of (Distance difference/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.
 +
In <code>center</code> mode, if successful, the center of the world border immediately moves to the specified coordinates.
   
 
== History ==
  
== History ==
  +
{{info needed section|the upcoming update for the world border's radius that [[Java Edition distance effects|controlled by float replaced by double]] }}
−  
 
{{History|java}}
  
{{History|java}}
−  
 
{{History||1.8|snap=14w17a|Added {{cmd|worldborder|link=none}}.}}
  
{{History||1.8|snap=14w17a|Added {{cmd|worldborder|link=none}}.}}
 
{{History|||snap=14w19a|Added {{cmd|worldborder|damage|link=none}}.
  
{{History|||snap=14w19a|Added {{cmd|worldborder|damage|link=none}}.
Line 74: Line 104:
 
{{History|foot}}
  
{{History|foot}}
   
  +
{{Commands}}
   
  +
[[de:Befehl/worldborder]]
−
<!-- please retain double newline above for section differentiation -->
  
  +
[[ja:コマンド/worldborder]]
−
[[Category:Commands]]
  
  +
[[zh:命令/worldborder]]

Revision as of 07:41, 27 June 2021

Information icon
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. 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>: double (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 Double-precision floating-point format number. 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. It must be between -29,999,984 and 29,999,984 (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

CommandTriggerJava Edition
anythe 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
anyOtherwiseManages the world border.

Output

CommandEditionSituationSuccess Count/execute store success .../execute store result ...
anyJava EditionOn fail000
/worldborder add ...On success11the specified <distance>
/worldborder center ...On success110
/worldborder damage amount ...On success11the specified <damagePerBlock>
/worldborder damage buffer ...On success11the specified <distance>
/worldborder getOn success11the size of the world border after rounding to the nearest integer
/worldborder set ...On success11the 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 success11the specified <distance>
/worldborder warning time ...On success11the 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.
Java Edition
1.8
{{Extension DPL}}<ul><li>[[Beetroot Soup|Beetroot Soup]]<br/>{{for|other uses|Soup}}
{{Item
| title = Beetroot Soup
| image = Beetroot Soup.png
| renewable = Yes
| heals = {{hunger|6}}
| stackable = No
}}

'''Beetroot soup''' is an unstackable [[food]] item.

== Obtaining ==

=== Crafting ===
{{Crafting
|Beetroot
|Beetroot
|Beetroot
|Beetroot
|Beetroot
|Beetroot
|Bowl
|Output=Beetroot Soup
|type=Foodstuff
}}

=== Natural generation ===

{{LootChestItem|beetroot-soup}}

== Usage ==

Beetroot soup can be eaten to restore {{hunger|6}} [[hunger]] points and 7.2 [[Hunger#Mechanics|saturation]], the same as [[cooked chicken]] and [[mushroom stew]]. After eating, the empty [[bowl]] remains, similarly to mushroom stew and [[rabbit stew]].

== Sounds ==
{{Sound table/Entity/Food}}

== Data values ==

=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Beetroot Soup
|spritetype=item
|nameid=beetroot_soup
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Beetroot Soup
|spritetype=item
|nameid=beetroot_soup
|id=286
|form=item
|foot=1}}

== Advancements ==
{{load advancements|Husbandry;A Balanced Diet}}

== History ==
{{History|java}}
{{History||1.9|snap=15w31a|[[File:Beetroot Soup JE1 BE1.png|32px]] Added beetroot soup.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 436.}}
{{History||1.14|snap=18w43a|[[File:Beetroot Soup JE2 BE2.png|32px]] The texture of beetroot soup has been changed.
|The recipe for beetroot soup is now shapeless.}}
{{History|||snap=18w49a|Beetroot soup can now be found in [[chest]]s in [[snowy tundra]] [[village]] houses.}}

{{History|pocket alpha}}
{{History||November 14, 2013|link={{tweet|jbernhardsson|400902957782147072}}|[[Johan Bernhardsson]] posts an image of beetroot soup.}}
{{History||v0.8.0|snap=build 2|[[File:Beetroot Soup JE1 BE1.png|32px]] Added beetroot soup. It is not obtainable in the Creative inventory.}}
{{History||v0.9.0|snap=build 1|Beetroot soup now requires 6 [[beetroot]]s instead of 4.}}
{{History||v0.12.1|snap=build 12|Beetroot soup now restores {{hunger|6}} instead of {{health|8}}.}}
{{History||v0.13.0|snap=build 3|Beetroot soup can now be stacked.}}
{{history|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Beetroot soup has been added to the Creative inventory.<ref name="missing beetroot soup">{{Bug|MCPE-13804}}</ref>}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Beetroot Soup JE2 BE2.png|32px]] The texture of beetroot soup has been changed.
|The recipe for beetroot soup is now shapeless.}}
{{History||1.11.0|snap=beta 1.11.0.1|Beetroot soup can now be found in [[snowy tundra]] [[village]] house [[chest]]s.}}

{{History|console}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|switch=1.0.1|wiiu=Patch 13|[[File:Beetroot Soup JE1 BE1.png|32px]] Added beetroot soup.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Beetroot Soup JE2 BE2.png|32px]] The texture of beetroot soup has been changed.
|The recipe for beetroot soup is now shapeless.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Beetroot Soup JE1 BE1.png|32px]] Added beetroot soup.
|Beetroot soup is not available within the [[Creative inventory]].}}
{{History||?|Added beetroot soup to the Creative inventory.{{info needed|Which update did this occur?}}}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==

{{reflist}}

{{Items}}

[[Category:Food]]
[[Category:Renewable resources]]

[[de:Borschtsch]]
[[es:Estofado de remolacha]]
[[fr:Soupe de betteraves]]
[[it:Zuppa di barbabietole]]
[[ja:ビートルートスープ]]
[[ko:비트 수프]]
[[nl:Bietensoep]]
[[pl:Barszcz]]
[[pt:Ensopado de beterraba]]
[[ru:Свекольный суп]]
[[th:ซุปบีทรูท]]
[[uk:Борщ]]
[[zh:甜菜汤]]</li><li>[[Drinks|Drinks]]<br/>[[File:Drinking Steve.png|150px|right]] [[File:Drinking Alex.png|150px|right]]

'''Drinks''' are a narrow class of consumable [[item]]s that can be ingested by the [[player]] in an extremely similar manner to [[food]]. However, drinks are not encountered quite as commonly as food is, and they are not nearly as integral to Survival gameplay. Drinks can generally be distinguished from food by the sounds they make upon consumption, the lack of [[particles]] they emit, and the fact that they leave an empty container item in the [[inventory]] after consumption. Drinks do not affect [[hunger]] or saturation values upon use (with the exception of [[honey bottle]]s), and do not need those values to be depleted in order to be consumed.

Drinks are drunk by holding {{control|use item}} while having the drink item selected in the hotbar or in the off hand.

== Drinks ==

{{/table}}

== History ==
{{main|Milk#History|Potion#History|Honey Bottle#History}}
{{History|java alpha}}
{{History||v1.0.11|[[File:Milk Bucket JE1 BE1.png|32px]] Added milk.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Added water bottles and potions.}}
{{History||1.15|snap=19w34a|[[File:Honey Bottle JE1.png|32px]] Added honey bottles.}}

{{History|pocket alpha}}
{{History||v0.7.0|[[File:Milk Bucket JE1 BE1.png|32px]] Added milk buckets.}} 
{{History||v0.12.1|snap=build 1|Added water bottles and potions.}}
{{History|bedrock}}
{{History||1.14.0|snap=beta 1.14.0.1|[[File:Honey Bottle BE1.png|32px]] Added honey bottles.}} 
{{History|foot}}
{{Items}}

[[ja:飲み物]]
[[pt:Bebidas]]
[[Category:Food]]</li></ul>
14w17aAdded /worldborder.
14w19aAdded /worldborder damage <distance>.
Added /worldborder warning (distance|time).
14w26aAdded /worldborder add <distance>.
14w29aAdded /worldborder get.

Commands 

View at: Template:Commands/content [edit]
Deutsch 日本語 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms