[world_blocks_commands]

How to Use the Worldborder Command Generator

  1. Pick a sub-command: set, center, add, damage amount, damage buffer, warning distance, warning time, or get.
  2. Fill in the fields that appear for that sub-command – for example, size in blocks and an optional transition time for set.
  3. Copy the generated /worldborder command into a command block or the console.

Command Syntax Reference

/worldborder set <size> [time]
/worldborder center <x> <z>
/worldborder add <size> [time]
/worldborder damage amount <damage>
/worldborder damage buffer <distance>
/worldborder warning distance <distance>
/worldborder warning time <seconds>
/worldborder get

The world border is a square boundary (measured as a diameter in blocks, default 60,000,000) centered on a configurable point. Each sub-command controls one aspect of it:

  • set <size> [time] – sets the border diameter directly. With an optional time in seconds, the border smoothly grows or shrinks to the new size over that duration instead of jumping instantly – this is the core mechanic behind battle-royale/shrinking-zone maps.
  • center <x> <z> – moves the border’s center point without changing its size.
  • add <size> [time] – changes the diameter by a relative amount (positive to grow, negative to shrink) instead of setting an absolute size.
  • damage amount <damage> – sets how much damage per block outside the border a player takes, per second, per block of distance past the buffer.
  • damage buffer <distance> – sets how far outside the border a player can stand before border damage starts applying.
  • warning distance <distance> – sets how close to the border (in blocks) the red warning overlay starts appearing on-screen.
  • warning time <seconds> – sets how many seconds before a scheduled shrink finishes the warning overlay starts appearing, for borders that are actively resizing.
  • get – reports the current border diameter with no changes.

Frequently Asked Questions

How do I make a border that shrinks gradually, like a battle-royale map?

Use /worldborder set <smaller size> <time in seconds> – the border animates from its current diameter to the target size over that many seconds, and players standing outside it take damage the whole time based on the damage amount and buffer settings. Chaining several set commands with delays (via command blocks or a datapack function) creates a multi-stage shrinking sequence.

What’s the difference between damage buffer and warning distance?

Damage buffer is about actual harm – it’s the safe zone width outside the border where a player takes no damage yet. Warning distance is purely visual – it controls when the red border overlay starts tinting the screen as a player approaches, independent of whether they’d actually be taking damage at that distance.

Can the world border be a shape other than a square?

No – the vanilla world border is always an axis-aligned square (or, briefly during a resize, expanding/shrinking between two square sizes). There is no built-in support for circular, rectangular, or custom-shaped borders.

Does /worldborder affect all dimensions at once?

Yes – the world border’s coordinates are shared across the Overworld, Nether, and End, though because the Nether is scaled 1:8 relative to the Overworld, the same X/Z border coordinates cover a proportionally smaller area in Nether blocks.

Related Tools