WorldBorder logo r3

If you appreciate this plugin and actually want to see it developed further by me rather than only receiving compatibility updates, you are welcome to Donate.
Thanks to the following people who have appreciated the plugin enough to donate: jonDatz, xrobau, Gussi, Dizzy, R. Meijer, FoundationCraft, T. Bronner, R. Thompson, The Pokemon Server,, D. Senff, Vik1395, TagCraftMC, D. Strickner, M. Wilson, Rhythmatic, W. Downey, P. V. Gretener, MiniCraft Server, Cosmic Craft.
Also thanks to IMathe172I (Lang Lukas) for contributing code to support elliptic and rectangular border shapes, and Indiv0 for contributing code to support border wrapping.


This plugin is intended to efficiently provide a border for each of your worlds, which only people granted special bypass access are allowed beyond. These borders can be round/elliptic or square/rectangular. As the plugin has been written with performance as the most important goal, it should have no performance impact on your server. Additional world trimming and filling commands are available as well.
Older plugins which originally inspired the creation of this one: rBorder and BorderGuard.


  • You can set up a separate border for each world, but only one border per world.
  • You can have either round/elliptic or square/rectangular borders. Square/rectangular borders are slightly higher performance, round/elliptic borders make for nicer display maps. Different worlds can have different border shapes if you so choose.
  • Configuration and border setup is done completely using commands in-game or through the server console. No need to ever edit the config file directly.
  • Support for all permission plugins which interface with Bukkit's built-in "superperms" permission system.
  • You can fully generate (fill) your world all the way to the border, filling in any missing chunks, including a configurable buffer zone just outside your border.
  • You can trim off any world chunks beyond the border, getting rid of extraneous parts, with a configurable buffer zone left just outside your border.
  • You can use a bypass command to allow specific players to go beyond all borders.
  • Borders can be automatically displayed in DynMap if you use that plugin.
  • All plugin data is automatically saved whenever any borders or settings are changed.
  • If a player crosses a border while in a vehicle, the momentum of the vehicle is stopped and it is moved back inside the border with the player.
  • When a player is moved back inside a border, they will be moved to a safe vertical location if needed.
  • Borders for specific worlds can be set to wrap around instead of just knocking back players who cross the border, instead sending them to the opposite edge of the border.

English Tutorial:

Spanish Tutorial:

Screenshot 2

Of special interest are the Fill command and the Trim command features:
Before and After Fill Before and After Trim

Borders are also displayed automatically by default in DynMap if you have it:
DynMap Border Example

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Brettflan Brettflan Apr 08, 2015 at 20:46 UTC - 1 like

    Example code for getting the Border data for a specific world:

    import com.wimbli.WorldBorder.BorderData;
    import com.wimbli.WorldBorder.Config;
    // example code with example world name
    String worldName = "world";
    BorderData border = Config.Border(worldName);
    // if border isn't set for world, it returns null; need to check for that
    if (border != null)
        // can use border.getX() and border.getZ() to get the center position,
        // border.getRadiusX() and border.getRadiusZ() to get the radius values,
        // border.insideBorder(...) for checking if a location is inside the border,
        // along with everything else that's available through BorderData
  • Avatar of Sycholic Sycholic Apr 07, 2015 at 20:06 UTC - 0 likes

    Do you have some kind of API or method to do a simple check to see if a chunk or location is outside the world border. Looking into coding a custom method to block 'factions claim' so people cant claim land a chunk ouside/beyond/overlapping the world border.


  • Avatar of Brettflan Brettflan Apr 05, 2015 at 03:21 UTC - 0 likes

    @mrchasez: Go

    Yeah, as always seems to be the case in such crashes, the fault is not with WorldBorder. Based on the stack trace, it looks most likely to me to be a bug in Spigot's world generation code (quite possibly passed on from the vanilla Minecraft server code, as is often the case), but TerrainControl is also indicated in there as a possible cultprit as well.

    Last edited Apr 05, 2015 by Brettflan
  • Avatar of mrchasez mrchasez Apr 04, 2015 at 22:10 UTC - 0 likes

    @Brettflan: Go

    The fill command keeps crashing WorldBorder every few %'s it goes and requires a server restart. It will get to about 2% and crash, then 4% and crash etc. Using any version of Spigot 1.8 + Terraincontrol =

    Looks like it's originating from TC, but I'm not certain.

    Last edited Apr 04, 2015 by mrchasez
  • Avatar of Brettflan Brettflan Apr 04, 2015 at 05:02 UTC - 0 likes

    @andrewkm: Go

    The root command is still /wborder, so you can use that. /wb is actually added as an alias since it's more likely to conflict with another plugin.

  • Avatar of andrewkm andrewkm Apr 04, 2015 at 02:42 UTC - 0 likes

    I used to use the command /worldborder and /wb is taken up by a workbench plugin. Can you give us a new alias now that you removed /worldborder. Perhaps /worldb

    Or perhaps config option to have /worldborder override the vanilla one.

    Or perhaps let worldborder work in console.

    PS: For now just added worldborder2 as an alias to plugin.yml

    Last edited Apr 04, 2015 by andrewkm
  • Avatar of Brettflan Brettflan Mar 21, 2015 at 18:01 UTC - 0 likes

    @Max633: Go

    Doesn't look like it, no.

  • Avatar of Max633 Max633 Mar 21, 2015 at 11:11 UTC - 0 likes


    Is it possible to put the effects of vanilla border in the plugin?


    Server french

  • Avatar of Brettflan Brettflan Mar 08, 2015 at 15:47 UTC - 0 likes

    @Daunay: Go

    Wrong version of WorldBorder, then. In the file list for this project, look to the "Game version" column for the list of Bukkit/CraftBukkit versions officially supported by each version of WorldBorder:

    As you can see there, WorldBorder 1.7.2b is what you'd want for version 1.5.2 of Bukkit.

  • Avatar of Daunay Daunay Mar 08, 2015 at 14:54 UTC - 0 likes

    Is it : The region folder contain .mca files.

    Last edited Mar 08, 2015 by Daunay


Date created
Aug 31, 2011
Last update
Mar 07, 2015
Development stage
  • enUS
BSD License
Curse link
Recent files
  • R: 1.8.3 for 1.8 Mar 07, 2015
  • R: 1.8.2 for 1.8 Mar 01, 2015
  • R: 1.8.1 for CB 1.7.9-R0.2 Sep 27, 2014
  • R: 1.8.0 for CB 1.7.9-R0.1 May 31, 2014
  • R: 1.7.9 for CB 1.7.2-R0.3 Mar 19, 2014