WorldBorder
Further releases for Spigot 1.13+ are now being posted on the Spigot site. I do not plan to release any further updates here on BukkitDev.
- Full list of Commands and Permissions
- Changelog
- Further Miscellaneous Information
- Source available on GitHub
- Old discussion on main Bukkit forum
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
.
Thanks to the following people who have been kind enough to donate: jonDatz, xrobau, Gussi, Dizzy, R. Meijer, FoundationCraft, T. Bronner, R. Thompson, The Pokemon Server, legitplay.net, D. Senff, Vik1395, TagCraftMC, D. Strickner, M. Wilson, Rhythmatic, W. Downey, P. V. Gretener, MiniCraft Server, Cosmic Craft, ScarcityFree.com, polaris_iv (Forge port), matagin, T. Ahokas.
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.
Description
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.
Features
- 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:
Of special interest are the Fill command and the Trim command features:

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


-
View User Profile
-
Send Message
Posted Oct 20, 2014@robrobk
Chunks are 16x16 blocks, so you can calculate based on that.
-
View User Profile
-
Send Message
Posted Oct 20, 2014is it possible to specify the border using chunks instead of blocks, my server relies on chunk based claiming (factions)
-
View User Profile
-
Send Message
Posted Oct 20, 2014It works like a charm with spigot :) (spigot 1.7.9 r0.2)
-
View User Profile
-
Send Message
Posted Oct 5, 2014Running the latest version of Spigot with their new patcher. I can confirm that it works absolutely fine on my server :)
-
View User Profile
-
Send Message
Posted Oct 3, 2014@juiceb0xk26
From what I've heard, yes, it works with Spigot.
-
View User Profile
-
Send Message
Posted Oct 3, 2014Does this work with Spigot? I really need this plugin to work with the old mods I use!!!!
-
View User Profile
-
Send Message
Posted Sep 30, 2014@Brettflan
I just wanted to thank you for this great plugin and say that your work is far beyond that of Mojang's simplistic 1.8 border, though some servers might be content with a simple square border.
One feature you could expand on is the wrapper. We could have a world that behaves very similarly to an actual sphere planet if we get a slightly more advanced wrapper, and the wrapper is already halfway there. If you have a square world with the wrapper on, when going far enough east it will take you to the corresponding position in the west and vice versa which is exactly how it should be.
What's lacking is that it does the same thing for the northern and southern borders. An optional setting that solves this is to have the player be teleported to the opposite location of the same border. For example, consider a square world that has its center at x 0 z 0 and is 1000 blocks in every direction. With the new option, going to the northern border and entering it at x -550 z -1000 would take you to x 550 z 1000. I'm planning to use random warp zones to crudely simulate this but it could be done so much better with WorldBorders wrapper.
-
View User Profile
-
Send Message
Posted Sep 28, 2014@Brettflan
The answer to that is posted twice on this current page of comments already, but to repeat it again and extend on it a bit:
I may be adapting some functionality of this plugin for Sponge later, but no promises.
Minecraft 1.8 comes with built-in physical border support, which while limited to a square shape and I think currently having a single border definition shared between all worlds, does at least partly cover the core functionality of this plugin. I'd be most likely to adapt the Fill and Trim functionality, though possibly some of the border functionality as well, and possibly adapting/extending some of the new built-in physical border functionality.
-
View User Profile
-
Send Message
Posted Sep 28, 2014Will this plugin be ported to Sponge?
-
View User Profile
-
Send Message
Posted Sep 28, 2014This is way overdue, but many thanks for this well planned, fully-functioned plugin. I've been using WorldBorder for years, and it's been indispensable in the creation of many weird worlds, as well as constraining their size. Seeing new WB features develop has been like watching a rare succulent grow, it just keeps getting better.
RIP Bukkit. I hope that Sponge succeeds, and that you still have time and motivation to port WorldBorder when it happens.
-
View User Profile
-
Send Message
Posted Sep 27, 2014@Brettflan
Thank you for a very useful and adaptable plugin.
-
View User Profile
-
Send Message
Posted Sep 27, 2014Ok thank you so much for your neat work : pluging compact, simple to understand, does as expected, enough ... and no useless commands. great. Hope to hear from you back next with sponge ... buts that's another story
-
View User Profile
-
Send Message
Posted Sep 27, 2014@Brettflan
Thank you, that will be perfect. I hope to see you on the sponge side :)
-
View User Profile
-
Send Message
Posted Sep 27, 2014Released v1.8.1
This is the final planned release of WorldBorder for Bukkit. I may be adapting some functionality of this plugin for Sponge later, but no promises.
Examples:
/wb worldName radius +16 - increase existing border radius size by 16 blocks for world "worldName".
/wb radius -100 - decrease existing border radius size by 100 blocks for the world you're currently in.
-
View User Profile
-
Send Message
Posted Sep 27, 2014@sparts
You could of course just set it to a higher or lower number than it's currently set to, but actually there's an unreleased update on GitHub which allows the radius of a border to be increased or decreased by a specified amount.
I'd been waiting to make some further changes before releasing anything, but considering I have no further plans for this plugin on Bukkit, I suppose I might as well make one last release to add that feature. I'll do that probably later today. I suppose I'll probably have to add a direct link to it or something; I'm not sure if any moderators still approve files on BukkitDev.
-
View User Profile
-
Send Message
Posted Sep 27, 2014Is it possible to grow/shrink the world border with commands (or command blocks)?
-
View User Profile
-
Send Message
Posted Sep 23, 2014@brkdgl07
Sponge is planned to be released initially for Minecraft 1.8, but even if it were for 1.7 I wouldn't plan on porting anything over to that version since this plugin is available for Bukkit here and works on 1.7.x CraftBukkit releases if you can find them.
To repeat what I said below for anyone who might not read down the page:
I will be looking into possibly porting over some of the functionality to a plugin for the upcoming Sponge platform. No promises, though.
-
View User Profile
-
Send Message
Posted Sep 23, 2014will you update worldborder for 1.7.2 with sponge platform. I dont know sponge platform is what
-
View User Profile
-
Send Message
Posted Sep 17, 2014@Theepwner
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.
-
View User Profile
-
Send Message
Posted Sep 16, 2014@Brettflan
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.