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,, polaris_iv (Forge port).
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 Aug 02, 2015 at 18:26 UTC - 0 likes

    @Cha0sPudd1ng: Go

    What's indicated in the log from when you ran the Trim? Also, you have stopped the server and started it back up after running the Trim, correct?

  • Avatar of Cha0sPudd1ng Cha0sPudd1ng Aug 02, 2015 at 16:18 UTC - 0 likes


    I have Trim my world, but not all Chunks are deleted.

    On Dynmap you can see this:


    And in MCEdit I see this:


    What are these for chunks, and how i can fix that?

  • Avatar of Brettflan Brettflan Jul 30, 2015 at 14:19 UTC - 0 likes

    @Jawfy: Go

    If you're talking about setting a time, that implies you're talking about the vanilla world border feature added into native Minecraft rather than this plugin.

    If that's not the case, please specify the exact command you are running.

  • Avatar of Jawfy Jawfy Jul 30, 2015 at 14:15 UTC - 0 likes

    I'm starting up a factions server and would like this plugin within it... But when ever I set it up do the center then the full size I want it doesn't go there? I don't set any time for it to get there just 0 but i've also tried 10 but still doesn't work please help!!!

  • Avatar of Brettflan Brettflan Jul 27, 2015 at 22:32 UTC - 0 likes

    @H8llfire: Go

    It actually fetches all of the names based on UUIDs in a single call, not individually. And of course normally the bypass list is only viewable by server admins.

    However, it could indeed be improved to use cached names and only do a lookup if there are any uncached names, and potentially be changed to run the name lookup in an async thread (though afterwards it would of course need to return the list of names to the CommandSender in a sync thread). I don't really have time to work on that right now, though.

    Last edited Jul 27, 2015 by Brettflan
  • Avatar of H8llfire H8llfire Jul 26, 2015 at 20:18 UTC - 0 likes

    Is there any way you can fix the bypasslist? Currently it hogs the main server thread until it manually fetched all the UUID's. Could you make this to use the UUID cache where applicable and also async some way?


  • Avatar of joshwenke joshwenke Jul 22, 2015 at 23:38 UTC - 0 likes

    @unclemark: Go

    Make sure the random light updates are enabled in your spigot.yml.

    Owner of the Cobalt network. Log on at,90576601,436fccee15835282e353044c00703a5604f912b0b06d29586c5d13649af1da0a

  • Avatar of Brettflan Brettflan Jul 20, 2015 at 20:27 UTC - 0 likes

    @unclemark: Go

    That's a longstanding issue with Minecraft world generation in general, where some areas don't have lighting initially rendered correctly. Having a player move near them (sometimes needing to move right into them or even placing a torch to force re-lighting) fixes them.

  • Avatar of unclemark unclemark Jul 20, 2015 at 17:16 UTC - 0 likes

    Lighting errors- I rendered out the map with only the worldborder plugin installed (spigot 1.8.7) and all overhangs and stuff under trees have weird shadows that don't seem to go away. Like total darkness.

    Should I use craftbukkit instead or is there a way to render a perfect map without lighting bugs ?


    Last edited Jul 20, 2015 by unclemark
  • Avatar of Kipklysmic Kipklysmic Jul 19, 2015 at 04:18 UTC - 0 likes

    @Breetflan It's working fine now, I'm assuming maybe it had something to do with Dynamic Map.


Date created
Aug 31, 2011
Last update
Jun 23, 2015
Development stage
  • enUS
BSD License
Curse link
Recent files
  • R: 1.8.4 for 1.8.1 Jun 23, 2015
  • 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