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 26, 2012@JoneKone
Should work fine on 1.2.4, though I haven't tested it yet. If you have any problems, please file a ticket with the details.
-
View User Profile
-
Send Message
Posted Mar 25, 2012Any news on 1.2.4 or 3 ?
-
View User Profile
-
Send Message
Posted Mar 23, 2012@n3rdyguy
DynMap? You'll need to shut down and start the server back up and then run a fullrender in DynMap to get it to properly detect that the trimmed chunks are gone.
The trim process has to go in and manually edit the region files, and DynMap doesn't know to rescan the files.
-
View User Profile
-
Send Message
Posted Mar 23, 2012Hi there Thanks for a great plugin. I am having some issues using the trim with a round border. Please see here: http://img820.imageshack.us/img820/1037/wbtrim.png
-
View User Profile
-
Send Message
Posted Mar 21, 2012@webname
No, it will generate the same stuff. Anything you've changed in regards to destroyed or placed blocks will be wiped clean, back to the original state.
-
View User Profile
-
Send Message
Posted Mar 21, 2012So i could use the trim command , say setting a small border enclosing our buildings, remove it and we would then get an updated map with new stuff ?as we re-explore . Im not clued up about the generation aspect of the game really :).
-
View User Profile
-
Send Message
Posted Mar 19, 2012@micdoodle8
It uses Bukkit's built-in chunk generation methods. You'd probably do best for now to make sure you're running the latest dev build of CraftBukkit 1.2.3, as I know there were some world generation bugs in earlier 1.2.3 builds.
-
View User Profile
-
Send Message
Posted Mar 19, 2012If I use the fill command while running the latest version of WB and the Beta-1.2.3 version of bukkit, will it fill with the rainforest biome, or will it generate 1.1 chunks?
-
View User Profile
-
Send Message
Posted Mar 19, 2012Hello Brettflan,
Your plugin is awesome, thank you a thousand times!
-The swift mole
-
View User Profile
-
Send Message
Posted Mar 18, 2012@wuselrob
Sorry, multiple borders per world is not planned. A single permission will probably be eventually added that allows that person to go beyond all borders.
-
View User Profile
-
Send Message
Posted Mar 18, 2012Hi, is there a way to define borders for groups? I'd like to have a world where Users only can move inside a defined border but VIPs can move over this border, but maybe are limited by an outer border. Do you know what i mean?
would be great if this could be integrated :)
-
View User Profile
-
Send Message
Posted Mar 17, 2012@dockter
I've just been playing around with it since I'm just now starting to use DynMap and it's working fine for me. It does seem that DynMap doesn't update much while WorldBorder is in the middle of the Fill process, presumably since the server is under stress. I found it beneficial however to use dynmap pause all while running Fill and then dynmap pause none after it finished, so that the two plugins weren't at odds.
As for the Trim process, like the note up above regarding the Trim process indicates, DynMap can't detect the chunks being removed. That's understandable; it would normally never need to re-check the files to see if anything has changed, since normally the only chunk changes would be happening within CraftBukkit. WorldBorder has to directly modify the region files for the trim process, there's no way to remove chunks through CraftBukkit. As the note up there says, you'll need to stop and start your server back up and then do a fullrender in DynMap to get it to clear up the trimmed chunks. There may be a quicker and simpler way, but if so, I don't know it and would love to hear it.
-
View User Profile
-
Send Message
Posted Mar 17, 2012The /fill and /trim commands are no longer triggering Dynmap to re-render the chunks affected by World Border.
-
View User Profile
-
Send Message
Posted Mar 16, 2012@xKoKSii
Multiple borders: no, sorry. A permission which allows certain players beyond the border: probably eventually, as I've already said below.
-
View User Profile
-
Send Message
Posted Mar 16, 2012@Brettflan
Can u add an option to set an more than one Border with Permissions so someone w/o the Permission cant get out of a Border?
I hope u understand what i mean :P
-
View User Profile
-
Send Message
Posted Mar 15, 2012I felt like going ahead and playing around with getting borders to be shown in DynMap, so with the gracious help of mikeprimm adding some requested functionality to DynMap, I'm happy to announce it will be added in the next WorldBorder release.
EDIT:

An example of a round border set to 512 radius. The world has been generated using Fill out to the default padding beyond the border.
-
View User Profile
-
Send Message
Posted Mar 15, 2012@thappy001
Probably will add that eventually.
@TrevorLaneRay
Why are you waiting? The current release works fine in 1.2.3.
-
View User Profile
-
Send Message
Posted Mar 15, 2012I keep checking back on this plugin, waiting for a 1.2.3-compatible update...
Pregenerating with /wb fill to get all the work done before world use.
Either this or WorldGenerationControl.
RLYRLYRLY want a 1.2.3-compatible release. ^_^
-
View User Profile
-
Send Message
Posted Mar 14, 2012Would it be possible to add permission nodes to leave the border?
-
View User Profile
-
Send Message
Posted Mar 14, 2012That's probably it, then.
EDIT: in other words, a problem in CraftBukkit which should be fixed soon, if not already fixed in the latest beta release.