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.

Element	Description
<world-borders> </world-borders>	Node containing all the defined world borders.

Sub-elements		Value/Children
<world-border>	A single world border.	World Border Sub-elements

World Borders Attributes

Attribute	Description	Value	Default
center	RequiredThe center of this world border.	X,Z
size	RequiredThe diameter of the world border, borders are always square.	Number
when	PropertyFilter when this world border is in effect.	Filter
after	Time after which this border takes effect. Not compatible with the when property.	Time Period
duration	The time it takes to transition from the previous state to this state.	Time Period
damage	The amount of damage per second inflicted to players for each meter they are outside the border.	Number	0.2
buffer	Distance to the edge of the border where damage to the player begins.	Number	5
warning-distance	Specify the block distance to the border before showing a red vignette to players.	Number	5
warning-time	Show red vignette to players when the border is moving and will reach them within the specified time.	Time Period	15s

World Border Sub-elements

Element	Description	Value/Children
<when>	PropertyFilter when this world border is in effect.	Filters

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>