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 16, 2013@GioboiMC
That's correct. It also even works for custom world types as long as Bukkit/CraftBukkit is set to use the proper custom world generator.
-
View User Profile
-
Send Message
Posted Mar 16, 2013Correct me if I'm wrong, but the force generation fill command just forces minecraft to generate terrain no matter what version it's running. So if I use the current version on the nether, it'll still generate the new quartz ore, correct?
-
View User Profile
-
Send Message
Posted Mar 15, 2013@Brettflan
Oh I think that might be the problem, thanks for the info I'm going to try this solution. :D
-
View User Profile
-
Send Message
Posted Mar 14, 2013@ziryuk
So run a Fill with the same 100 padding amount to see what changes. I'm guessing it will fill in around those "fingers".
You can then trim it back further again if you want, though you should note that the view distance you have set on your server will of course generate chunks outside the border. So with the default view distance of 10 that's 10 chunks / 160 blocks away that can be seen by players normally. It's good to have a bit more extra buffer in place for anyone who gets further out during a lag spike or similar, thus the default padding value for the Fill and Trim commands of 13 chunks / 208 blocks.
-
View User Profile
-
Send Message
Posted Mar 14, 2013@Brettflan
I used " /worldborder world trim 500 100", should be fine though, no? 100 being the padding I believe.
-
View User Profile
-
Send Message
Posted Mar 14, 2013@TheMalazan
WorldBorder handles deletion of the region files which are completely outside the border (+padding range). If it fails to delete any particular file due to the file being locked, it will notify you of the filename so you can restart and run the trim again or just delete the file manually.
-
View User Profile
-
Send Message
Posted Mar 14, 2013@Brettflan
Sounds good.
One more thing, if I may. Once we downsize and trim, how will I be able to determine which region files to toss, or will I be able to do that?
Thanks!
-
View User Profile
-
Send Message
Posted Mar 14, 2013@TheMalazan
That should all work, yes.
-
View User Profile
-
Send Message
Posted Mar 14, 2013Greetings. Recently we set up an FTB/Ultimate server and did a 10k radius (round) pre-load with a program that was supposed to establish borders, etc. Although it appears the world was generated appropriately, no borders were established. Plus, in retrospect, 10k radius was too large.
So, I was thinking we'd install MCPC+ which would allow us to use WorldEdit and WorldBorder. If I did, would it be possible to retroactively use WorldBorder to establish borders (eg, 8k radius)? And would the trim function work appropriately on a world generated with another app? (Reducing the radius would also help keep our Dynmap folders a reasonable size.)
Thanks
-
View User Profile
-
Send Message
Posted Mar 14, 2013@ziryuk
Another thought, what padding distance do you have specified on the Trim command? It's probably out to the edge of those "fingers".
-
View User Profile
-
Send Message
Posted Mar 14, 2013@Brettflan
I've done exactly that. Trimmed, waited till it was completed, there was no error. In fact I trimmed twice in one of my redo's just to make sure. And each time I installed a completely fresh copy of Dynmap and did a fullrender.
Thats why I'm confused why I'm getting this... maybe its worth mentioning this was a pre-made map but everything that was customized is far inside the border.
-
View User Profile
-
Send Message
Posted Mar 14, 2013@ziryuk
If there were no errors reported by WorldBorder during the Trim, and if you have restarted your server and done a fullrender in Dynmap as indicated in the documentation for the Trim command, there's no reason it would look like that.
-
View User Profile
-
Send Message
Posted Mar 14, 2013Hey, I trimmed my borders and it looks fine for the most part but here is what one of my corner look like : http://oi50.tinypic.com/14dq78x.jpg
I trimmed it using /worldborder world trim 500 100, and I've done it a few times before installing a fresh copy of dynmap, but I keep getting this same result. Out of ideas... Help please.
-
View User Profile
-
Send Message
Posted Mar 13, 2013@Yoshinat0r
Easy to do using WorldGuard however :3
-
View User Profile
-
Send Message
Posted Mar 13, 2013What's a reasonable border limit for a server with 100 players?
-
View User Profile
-
Send Message
Posted Mar 13, 2013@Brettflan
(sorry for my english)
This was what I dide to fix it:
Me and the players quited the server, then I thid a reload and I typed the trim command from the console, and it worked!
Thanks for answer me so fast, and thanks again for this great plugin!
-
View User Profile
-
Send Message
Posted Mar 13, 2013@Yoshinat0r
This plugin doesn't do anything related to block placement or breaking, sorry.
-
View User Profile
-
Send Message
Posted Mar 13, 2013Is there a way with this plugin to allow players to travel past the border but prevent them from placing or breaking blocks when they are past it?
-
View User Profile
-
Send Message
Posted Mar 12, 2013@mll_
Rectangular / ellipsoid border shapes will likely be supported soon when I have time to review a pull request submitted by another dev which adds that. So after that what you want should be possible.
@Duning
So that region is locked by your OS, possibly by the server itself. You can try restarting the server and running the Trim again or you can try deleting that file in your world's region folder manually.
-
View User Profile
-
Send Message
Posted Mar 12, 2013I'm getting this error:
https://lh4.googleusercontent.com/-jeVzHVAohv8/UT94qe6n7UI/AAAAAAAAALA/w7AcqbGQ5SQ/s1920/asd.png
[Trim] Error! Region file wich is outside the border could not be deleted: r.-1.-1.mca
any help? D: