World Border

The world border module uses the default minecraft world border and allows customization of its size, position and behavior. Only one world border definition can be active at a time.

Attributes for multiple world borders can be applied for all borders by specifying them in the root <world-borders> element.

ElementDescriptionValue/Children
Node containing all the defined world borders.
Sub-elements
A single world border.World Border Sub-elements
World Borders Attributes
AttributeDescriptionValueDefault
RequiredThe center of this world border.X,Z
RequiredThe diameter of the world border, borders are always square.Number
PropertyFilter when this world border is in effect.Filter
Time after which this border takes effect.
Not compatible with the property.
Time Period
The time it takes to transition from the previous state to this state.Time Period
Amount of damage per second inflicted to players for each meter they are outside the border.Number0.2
Distance to the edge of the border where damage to the player begins.Number5
Show red vignette to players closer than this to border.Number5
Show red vignette to players when the border is moving and will reach them within this time.Time Period15s
World Border Sub-elements
ElementDescriptionValue/Children
PropertyFilter when this world border is in effect.Filter

Examples

<world-borders center="6.5, -36.5">
<!-- Typical time-based shrinking border. Starts at 200 meters when the match loads. -->
<!-- After 5 minutes, it starts shrinking, until it is 20 meters wide at 15 minutes. -->
<world-border size="200"/>
<world-border size="20" after="5m" duration="10m"/>
</world-borders>
<!-- Borders can be controlled with filters (and will update dynamically). This is -->
<!-- roughly how you would move a deadly border depending on which team controls a hill -->
<world-borders size="50" damage="20">
<world-border center="30, 0">
<when>
<objective team="red-team">control-point</objective>
</when>
</world-border>
<world-border center="-30, 0">
<when>
<objective team="blue-team">control-point</objective>
</when>
</world-border>
</world-borders>