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 Feb 2, 2013Trim seams to be broken. When started it causes extream lags - and we have a powerfull machine. and only a few players were online
-
View User Profile
-
Send Message
Posted Jan 31, 2013@andrewkm
Strange. I know that problem doesn't happen for instance in the default Nether world. I've never actually used Multiverse myself though, so I'm not sure whether it handles worlds exactly the same as the default normal/nether/end worlds.
@andrewkm
As I said right below, no, I just have the source on GitHub.
-
View User Profile
-
Send Message
Posted Jan 31, 2013Also out of curiosity do you currently have a jenkins for this project for testing dev builds etc?
-
View User Profile
-
Send Message
Posted Jan 31, 2013@Brettflan
I seem to have found the issue with my previous problem. It was due to the fact I was filling a world that was empty and had no one inside. This is when it derps and doesn't go through properly. It only seems to work if I'm in the actual world that im filling. Or there is atleast one player in that world. (I was trying to fill a world that was loaded but had no players inside)
-
View User Profile
-
Send Message
Posted Jan 30, 2013@Melekaiah
No dev links, other than the one to my source on GitHub. This plugin generally remains compatible though many versions of CraftBukkit before needing to be updated.
-
View User Profile
-
Send Message
Posted Jan 30, 2013again this plugin has helped me a ton in doing mapping for my server. and testing seeds and stuff,
im a bit tire dnow so ill check back in the morning. but you do have dev links on here?. trying to move over to latest beta atm.
actually im just gonna try to sleep and wake up in the mroning
-
View User Profile
-
Send Message
Posted Jan 29, 2013@TomShar
It won't do anything to the nether portal. It will simply make sure the player is moved inside the border when they go through it.
-
View User Profile
-
Send Message
Posted Jan 29, 2013Will this force netherportals inside the boarder?
If the user creates a portal at say x:3000 z:3000 and the worldboarder in the nether is at a 1000 radius from x:0 z:0 would it move the portal inside the boarder?
-
View User Profile
-
Send Message
Posted Jan 28, 2013@3ptO
No.
-
View User Profile
-
Send Message
Posted Jan 28, 2013Does stopping and restarting "/wb fill" mess up chunk generation?
-
View User Profile
-
Send Message
Posted Jan 27, 2013OK, just started up with dev build 2615 of CraftBukkit 1.4.7-R0.1. I let it create a fresh new Nether world. I then ran the fill process with a border size of 256. It completed without any problems. I then reduced the border size to 64 and ran the trim process. Again no problem.
Anyone still having problems with the fill or trim process which I haven't addressed below this should report with as much detail as possible.
@andrewkm
If the world already has 90% of the area inside the border already generated, the fill process percentage will jump up to somewhere around 90% at the start. It skips past already generated chunks except for those right at the very edges. It will then of course finish quickly since there's not much to generate and the file size correspondingly won't grow much.
@zSwayz
You should always be able to see the progress in your server console / log.
@mrchasez
EDIT: I originally stated this was a problem in CraftBukkit rather than WorldBorder based on the stacktrace, but on closer inspection it looks to be "terraincontrol" at fault. I assume that's a plugin you're running?
-
View User Profile
-
Send Message
Posted Jan 27, 2013All right, I'll investigate the fill and trim problems soonish when I have time.
-
View User Profile
-
Send Message
Posted Jan 27, 2013@Brettflan
Fill command isn't working right. Everyone below me is getting issues too.
http://pastie.org/5891587
-
View User Profile
-
Send Message
Posted Jan 27, 2013After leaving my server and re joining i cannot seem to see a status of the world filling. Would it be possible to check the fill status? Not sure if there is already a command to do so.
-
View User Profile
-
Send Message
Posted Jan 27, 2013@NemesiS_ITA
Indeed we are also having serious issues with our fill command :(
-
View User Profile
-
Send Message
Posted Jan 27, 2013Im extremely unsure as to why this is happening but... whenever I try to worldborder fill a new nether generated by multiverse ... it shoots up to 99.6% INSTANTLY and then.. finishes up in 4-5 minutes on a radius of 2000 - and says complete. Yet the folder only goes up to 2MB
Doing this on a normal terrain world however fill correctly ... from 0% to 100% and the folder grows to 400MB on the same radius of 2000.
Something is definately up with the very latest CB / MV builds and this plugin regarding the nether. :(
-
View User Profile
-
Send Message
Posted Jan 27, 2013Please update to 1.4.6 or 1.4.7, the trim and fill functions aren't working.. :( Bu the the border is still working :)
-
View User Profile
-
Send Message
Posted Jan 27, 2013@wumpyc
Extremely unlikely considering WorldBorder does practically nothing through Bukkit Listeners, primarily just running its timed task to check the location of each player online to make sure nobody is outside the border.
Is there anything in particular you're talking about? Fill or Trim maybe? That could be understandable.
-
View User Profile
-
Send Message
Posted Jan 27, 2013Causes Major Lag in 1.4.7
-
View User Profile
-
Send Message
Posted Jan 23, 2013Needs some coolio updates :)