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.
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 Sep 17, 2014 at 16:56 UTC - 0 likes

    @Theepwner: Go

    It isn't.

    The problem they're describing is in storing a list of Player data objects in a format similar to Map<Player, Object>. Not only does WorldBorder not store any Player data in any Map/List/Collection/etc., the only remotely long-term storage of a Player object at all is during the Fill and Trim processes, where a single Player reference is stored for notifying the player who ran the command of progress. After the Fill/Trim is complete that single Player reference is cleared up.

  • Avatar of Theepwner Theepwner Sep 17, 2014 at 05:59 UTC - 0 likes

    @Brettflan: Go

    Do you think this plugin is possibly causing memory leaks? Many people in the spigot community have reported such things. I think this plugin might have something to do with it since the leaks only occur on my hub server, and on my Factions server which both share this common plugin. Take a look and view the bottom of the 2nd page where Aikar explains some things.

    Last edited Sep 17, 2014 by Theepwner
  • Avatar of Brettflan Brettflan Sep 13, 2014 at 21:42 UTC - 0 likes

    With Bukkit apparently defunct, no more releases are planned.

    I will be looking into possibly porting over some of the functionality to a plugin for the upcoming Sponge platform. No promises, though.

  • Avatar of brkdgl07 brkdgl07 Sep 12, 2014 at 09:41 UTC - 0 likes

    please can you add x,z versions for /wb fill. Example /wb fill world [freq] 1000 <x> <z> I want to use your plugin for random teleport that no lag

  • Avatar of Fuzed2Computer Fuzed2Computer Aug 31, 2014 at 16:08 UTC - 0 likes

    Recommend adding a command for setting a default for new worlds(mystcraft ages) "/wb setdefault <radiusX> [radiusZ]" and the option to set wb by chunk as well.

  • Avatar of Brettflan Brettflan Aug 27, 2014 at 14:01 UTC - 0 likes

    @watteffer: Go

    There isn't a way to do that, sorry. The simplest way I can think of to accomplish something like that would be to use a separate world for staged events and so forth, rather that trying to do them outside the border in your main world.

  • Avatar of gustofusion gustofusion Aug 26, 2014 at 22:32 UTC - 0 likes

    A great plugin we use on our server along with dynmap and several dynmap plugins. Makes for a nice looking map and helps control chunk data size. We can expand the border over time to allow controlled growth of our worlds map. Can be seen here in action

    Last edited Aug 26, 2014 by gustofusion

    BFAK:90883431,1d252ba553f2e60e646d6a0c5fa6626658dccb73b1d259a6820e623c306791cb Primecraft

  • Avatar of watteffer watteffer Aug 26, 2014 at 19:06 UTC - 0 likes

    Hey, I'm glad to see the author still helps out!(unlike many other bukkit plugins).

    Is there a way to have a one time only 'ticket' to go beyond the border? not a literal item of course. Inside my border is all open greif pvp etc. but I want players to be able to be teleported passed the border but not walk over the border line. I know off /wb bypass but the teleportation is via events or gamemodes that are set up in a safe area outside the world border.

  • Avatar of Brettflan Brettflan Aug 22, 2014 at 16:04 UTC - 0 likes

    @bothari: Go

    So to be sure I understand, you're saying that when you change the border (radius, or shape, or whatever), the border displayed in dynmap isn't being updated? Or are you talking about the results of a Fill not being shown?

    Either way, try checking the map in a different browser or on a different computer/tablet/device than you're currently using to make sure it isn't a problem with your browser not updating the data correctly. If that's not possible, you could also try just clearing your browser cache to see if that fixes it.

  • Avatar of bothari bothari Aug 22, 2014 at 03:35 UTC - 0 likes

    I'm using WorldBorder and Dynmap on bukkit 1.7.9-R0.2. The worldborder currently shows correctly on my DynMap, but if I change the border then the map doesn't update. I've tried doing a fullrender of dynmap, but that doesn't fix anything.

    Any suggestions? I'm using dymap 1.9.4, and wb 1.8.0.



Date created
Aug 31, 2011
Last update
May 31, 2014
Development stage
  • enUS
BSD License
Curse link
Recent files
  • 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
  • R: 1.7.8 for CB 1.7.2-R0.3 Feb 22, 2014
  • R: 1.7.7 for CB 1.7.2-R0.2 Dec 21, 2013
  • R: 1.7.6 for 1.7.2 Oct 20, 2013