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 Mar 7, 2013Is there a way to cancel the fill command after you've started it?
-
View User Profile
-
Send Message
Posted Mar 6, 2013How about a </tp center> command for teleporting to the very center of your world?
-
View User Profile
-
Send Message
Posted Mar 4, 2013@anotherfahlman
Do you mean visually disappear in-game? No, that's not what the Trim function does. It does remove chunks which are outside your border, but at a specific distance outside by default (as covered in the documentation linked on the page above) to account for people being able to see several chunks out beyond the border.
EDIT: the Dynmap example image above gives a good example of the default buffer zone value for the Fill and Trim commands.
It's mainly intended to clean up a world where people have wandered a long distance away from the starting point, outside the area where you now want to now keep them within using a border.
You may be after a "physical border" as most people seem to describe it, with air blocks outside the border. WorldBorder doesn't currently provide anything like that. I would want to provide a way to revert/remove the physical border change, and that would take a lot of work to pull off properly. I don't really have time to work on something like that now.
You can potentially use another tool like WorldEdit to do that.
-
View User Profile
-
Send Message
Posted Mar 4, 2013I'm having a problem with the trim feature or I misunderstand the function. I set up a round border and then trim, but the chunks outside the border don't disappear. I can walk to the border and I bounce back so I know I've reached the border.
config.yml
server log
-
View User Profile
-
Send Message
Posted Mar 4, 2013@slimpyman
Also you can be sure of the border info using /wb list, which will account for possible individual border shapes and give you the precise info on border center and radius.
-
View User Profile
-
Send Message
Posted Mar 4, 2013@Brettflan
thanks for the reply dude. i just checked my config. it says round borders false... so, im just gonna recheck to see if im actually where i think i am. :)
-
View User Profile
-
Send Message
Posted Mar 3, 2013This is amazing, But please, Don't give up on this plugin! My server now depends on it!
Thank you for creating!
-
View User Profile
-
Send Message
Posted Mar 2, 2013@slimpyman
Sounds like you have the default round border shape and are going towards where the "corners" of a square border would be.
-
View User Profile
-
Send Message
Posted Mar 2, 20130_0 thank you so much for making a trim feature.
-
View User Profile
-
Send Message
Posted Mar 2, 2013i cant figure out whats messing up... i stand at x0 z0 and do /world set 2000 0 0 and one side goes to -1600 one goes to 1400. i dont get it :)
-
View User Profile
-
Send Message
Posted Feb 28, 2013@Dalek5961
worldborder.bypass permissions grants use of the /wb bypass command.
-
View User Profile
-
Send Message
Posted Feb 28, 2013Is there a permission for certain players to bypass the world border, maybe ops? Reason being is I thought outside the WB would be a nice sand box with easy /trim cleanup
-
View User Profile
-
Send Message
Posted Feb 28, 2013@ChrisvA
I hadn't planned to, but another cool dev (Mathe172) has submitted a pull request which adds support for rectangular/ellipsoid border shapes. I'll probably be adding that in the next couple of weeks when I have time to review it.
-
View User Profile
-
Send Message
Posted Feb 28, 2013Is it possible to add rectangle borders? it would be 4 config-Values maxX, maxZ, minX, minZ and the performance shouldn't be any problem, there is much more to do every tick than checking these 4 Values for every Player.
-
View User Profile
-
Send Message
Posted Feb 27, 2013Brettflan - Just wanted to say; thank you so much for your amazing plugin. It's intuitive, it's easy to use, it's efficient. I can't think of a more well made plugin that does it's job so well. I've been running on my server forever and I've taken it for granted because it just sits happily in the background and does what it's supposed to do.
You know a plugin is amazing when you don't ever have to think about it running but it's still doing it's job.
My server is years old and well aged, and I suspect that your plugin will stay with us for the long-haul. Thanks again.
-
View User Profile
-
Send Message
Posted Feb 24, 2013@RandomQuark
Use a mapping tool to see, such as DynMap.
-
View User Profile
-
Send Message
Posted Feb 23, 2013I own a survival server, and I've been thinking about downloading this plugin to make sure the world file doesn't get to large. But when we set the borders, how do we know that players haven't traveled beyond that border before hand and established tons of buildings already?
-
View User Profile
-
Send Message
Posted Feb 23, 2013@Eelviny
Yeah, IIRC there's no way to effectively prevent the chunks from being loaded / generated. You could technically do so, but the client would just keep asking for it and not deal well with the fact that the server isn't sending it.
As for filling those chunks with air, that's possible, but with various drawbacks. First, it would look screwy to just fill entire chunks with air, it would need to also modify chunks which are partway outside the border to add air blocks at the actual border. Then you have the issue of problems restoring those partially modified chunks later if the person needs to increase their border size. Easy on solid air chunks, trickier on the partial ones.
-
View User Profile
-
Send Message
Posted Feb 23, 2013Love the plugin, almost an essential for a nice-looking dynmap :) Would be really awesome if you could add in a way for the world to just stop at the border, although I do realize it would be quite hard and mean a complete code redesign :P Just an idea, making the chunks generate air at the border would also alleviate the need for checking players at the border.
-
View User Profile
-
Send Message
Posted Feb 23, 2013@capobase
wat?
You realise this plugin is designed to LIMIT the world size, right?
What would be the point of making it unlimited? You can do that by not installing the plugin.