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 Apr 23, 2012@thedazs
By "tiles", do you mean in Dynmap or similar? If so, just give it some time to update. Regardless, if the Fill process completes then you can be assured that the world is indeed generated.
-
View User Profile
-
Send Message
Posted Apr 23, 2012World fill isn't working for me: the progress will reach 100% and complete, but most of the 'tiles' are blank. Help?
-
View User Profile
-
Send Message
Posted Apr 20, 2012@Namulator
Your stack trace indicates it's a problem with Register pointing to org.bukkit.util.config.Configuration, which IIRC was deprecated quite some time ago and was then removed back around CraftBukkit 1.1-R5 or so.
WorldBorder does not include or reference the Register plugin, so you obviously need to look elsewhere.
-
View User Profile
-
Send Message
Posted Apr 20, 2012I love this plugin, but I have run into a problem. When using this plugin I get an error with a plugin called Register which is part of Towny. The error is as follows...
Towny developer says that it's the fault of a third party plugin, and when testing, I found that it is worldborder causing the problem. Please fix this asap.
-
View User Profile
-
Send Message
Posted Apr 18, 2012@Brettflan
Thank you :)
-
View User Profile
-
Send Message
Posted Apr 16, 2012Aaah I appreciate a good plugin with it's source posted :)
-
View User Profile
-
Send Message
Posted Apr 16, 2012@ergaiophobiac
Yes, 1/8 is the correct scale for Nether worlds.
-
View User Profile
-
Send Message
Posted Apr 16, 2012@HavenOfKairos
Support for rectangular/ellipsoid border shapes is not planned, sorry.
-
View User Profile
-
Send Message
Posted Apr 15, 2012I'm sure this has been asked, but I don't really know how to look for it and be 100% sure I'll get the right answer. How big should my world's nether be limited to in reference to the overworld? 1/8 the size?
-
View User Profile
-
Send Message
Posted Apr 15, 2012@Brettflan
Thank you very much for your time, unfortunately i have found no logs whatsoever on what commands were actually entered, of course mistakes might have been made. Most important thing is that it was easy to correct. Thanks for this great plugin.
Cheers, PaTr0N
-
View User Profile
-
Send Message
Posted Apr 15, 2012Is it not possible just to pick 2 corners? I have more of a rectangle made world. >.<
-
View User Profile
-
Send Message
Posted Apr 15, 2012@PaTr0N
I've just double-checked the source for the Fill command to be sure, and there are no flaws in regard to specifying frequency and padding. If you don't specify a padding value, it will use the default value unless you've previously run the Fill command and specified a different padding amount (regardless of whether you confirmed it). In that case, it remembers the padding you last specified and uses it. It doesn't come up with a padding value other than the default on its own. So, either you or somebody else on your server with access to it definitely ran the Fill command and specified a padding amount either that time or earlier.
Also, it will of course indicate the amount of padding it will use when it asks you to confirm the process, which is a large part of why it makes you confirm the process.
If the Trim process isn't able to remove certain regions, it's because the files are locked by your OS. Such region files can either be deleted manually like you did, or usually restarting the server to free the files up and then running the Trim process again will also work.
-
View User Profile
-
Send Message
Posted Apr 15, 2012@Brettflan:
I wasn't actually able to measure the surplus padding precisely i got, however i'm pretty sure that i have suppiled the frequency as 1000 and omitted the padding value, then i got the confirmation message about what the fill is actually going to do. I was going up from a world with a R of 2500 to a R of 5000 with the center moved just so that the new area was covering the old one. This then gave me a world that had a far bigger padding then i expected. 1500 was an approximation, however when i finally removed the surplus by trimming with a specified padding size i got rid of 1 gigs of world data. Which brings us to the next issue i've encountered:
There were around 60 regions the trimming process wasn't able to remove, but thanks to the very sepcific error messsages i managed to remove them manually. (I think it said that it was too far out from the border)
TLDR i never supplied a second value, this should be looked into,
Thanks!
-
View User Profile
-
Send Message
Posted Apr 14, 2012@PaTr0N
Where did you get this 1500 figure from? Shouldn't be possible without you specifying it, and the default padding is actually 208. Maybe you tried to specify a 1500 frequency and got the values mixed up?
-
View User Profile
-
Send Message
Posted Apr 14, 2012Hello,
I've just filled an 1.2.5 world with a border radius of 5000 but i haven't supplied a padding parameter as i was happy with the default of 192, however it seems that i got a padding of 1500 instead :S
-
View User Profile
-
Send Message
Posted Apr 12, 2012@LmnDK
I don't fully understand the problem you're having based on your description. Can you provide a more detailed description?
-
View User Profile
-
Send Message
Posted Apr 11, 2012I can't make a fill command after i deleted the dynmap files for that specific world to retry. It only loaded the edges on my 6000x6000 round map.. What can i do? I tried to reinstall, no changes..
Regards.
-
View User Profile
-
Send Message
Posted Apr 10, 2012@CVRipley
Just for reference, WorldBorder doesn't monitor player movement. For lower server impact, it instead runs a server-synced thread which checks the location of all players every few ticks and moves any back inside the border as needed. I ran some pretty extensive testing quite a while back which proved that running as a separate task used up less processing time than monitoring player movement events, even considering players who aren't moving.
About adding that setting, I'll be looking into it soon along with other settings related to dynmap borders.
-
View User Profile
-
Send Message
Posted Apr 9, 2012I reenabled WB and i will test again Its hard to troubleshoot something thats intermitant but i will keep an eye on it
I did have some serious problems with a plugin which was breaking other plugins ReferGift which I removed If it caused the problems... i dont know.
Also i use nocheatplus which also checks player movement. At first i was thinking this might conflict. When or If it breaks again i will check logs.
This is our setup. Its extensive.
Recommended Build for CraftBukkit: 1.2.5-R1.0 build 2149
Plugins
WB config.yml
As a side note could you add a setting in the config to change whether or not the dynmap layer is shown by default? I would perfer if it was hidden and have people check the box to show it. Perhaps this can be done in dynmap itself?
-
View User Profile
-
Send Message
Posted Apr 9, 2012@CVRipley
Same problem on my server.. sometimes border doesn't work :( ill try with debug also