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 Sep 13, 2014With Bukkit apparently defunct, no more releases are planned.
I will be looking into possibly porting over some of the functionality to a plugin for the upcoming Sponge platform. No promises, though.
-
View User Profile
-
Send Message
Posted Sep 12, 2014please can you add x,z versions for /wb fill. Example /wb fill world [freq] 1000 <x> <z> I want to use your plugin for random teleport that no lag
-
View User Profile
-
Send Message
Posted Aug 31, 2014Recommend adding a command for setting a default for new worlds(mystcraft ages) "/wb setdefault <radiusX> [radiusZ]" and the option to set wb by chunk as well.
-
View User Profile
-
Send Message
Posted Aug 27, 2014@watteffer
There isn't a way to do that, sorry. The simplest way I can think of to accomplish something like that would be to use a separate world for staged events and so forth, rather that trying to do them outside the border in your main world.
-
View User Profile
-
Send Message
Posted Aug 26, 2014A great plugin we use on our server along with dynmap and several dynmap plugins. Makes for a nice looking map and helps control chunk data size. We can expand the border over time to allow controlled growth of our worlds map. Can be seen here in action http://hypedphoto.com:8123/#
-
View User Profile
-
Send Message
Posted Aug 26, 2014Hey, I'm glad to see the author still helps out!(unlike many other bukkit plugins).
Is there a way to have a one time only 'ticket' to go beyond the border? not a literal item of course. Inside my border is all open greif pvp etc. but I want players to be able to be teleported passed the border but not walk over the border line. I know off /wb bypass but the teleportation is via events or gamemodes that are set up in a safe area outside the world border.
Thanks!
-
View User Profile
-
Send Message
Posted Aug 22, 2014@bothari
So to be sure I understand, you're saying that when you change the border (radius, or shape, or whatever), the border displayed in dynmap isn't being updated? Or are you talking about the results of a Fill not being shown?
Either way, try checking the map in a different browser or on a different computer/tablet/device than you're currently using to make sure it isn't a problem with your browser not updating the data correctly. If that's not possible, you could also try just clearing your browser cache to see if that fixes it.
-
View User Profile
-
Send Message
Posted Aug 21, 2014I'm using WorldBorder and Dynmap on bukkit 1.7.9-R0.2. The worldborder currently shows correctly on my DynMap, but if I change the border then the map doesn't update. I've tried doing a fullrender of dynmap, but that doesn't fix anything.
Any suggestions? I'm using dymap 1.9.4, and wb 1.8.0.
Thanks!
-
View User Profile
-
Send Message
Posted Aug 19, 2014@Legundo
The Fill task reports to the server log / console when it completes. Also, if you're using another plugin which runs the Fill, you could potentially just extend the WorldFillTask class from WorldBorder and override the finish() method to do whatever you're wanting to do there.
I suppose I could set up a handful of Bukkit Events for things like border creation, Fill, Trim, and so forth, but I don't really have a lot of free time lately.
-
View User Profile
-
Send Message
Posted Aug 19, 2014Hey there,
We are using the WB fill command to fully generate worlds for our UHC implementation on our server, and I was wondering if you ever thought of adding some API to detect when a fill event is complete, maybe by just throwing some sort of generic event.
I know we could fork off and do this, but I think it would be useful for a lot of people, so I wanted to propose it for the main branch first.
Thanks, Legundo
-
View User Profile
-
Send Message
Posted Aug 11, 2014@Brettflan
Updating fixed the horse bug. Thanks alot!
-
View User Profile
-
Send Message
Posted Aug 11, 2014@Noumpas13
Support for multiple borders per world still isn't planned, sorry.
-
View User Profile
-
Send Message
Posted Aug 11, 2014Hey Brettflan i would like to request an extra feature for the world border.
(You can also put many world borders in circles shape concentric one to each other with different radius eash, so you can use the bypass feature for certain player groups. So a member can walk inside the border of a small world border of 1k block radius, and a VIP will be able to bypass the small one and be able to walk freely at the second larger world border at a radius bigger than the smaller one)
-
View User Profile
-
Send Message
Posted Aug 9, 2014@Skylord_1023
Yeah, that's the idea.
-
View User Profile
-
Send Message
Posted Aug 8, 2014Brettflan so basically we could fix that problem with a Multi-World plugin?
Seems like a good idea.
-
View User Profile
-
Send Message
Posted Aug 5, 2014@Argagaes
Support for multiple borders in a single world still isn't planned, sorry. You can of course set up a different border for every individual world, so you could potentially use separate worlds for your purposes.
-
View User Profile
-
Send Message
Posted Aug 5, 2014Is it possible that we would be able to create allowed zones outside the border? like maybe with world guard or something like that, becouse I've got some stuff outside after taking this into use (mob arenas, rent shops, some tut areas and what not...) also maybe so that you would name the area and then ppl need permission to enter it? (would be really easy to create small vip areas in the same world or something!) and also you could do the 5k in each direction from different coords, so u got the 1 from 0.0 and another from 10k.10k :P I think this would be super useful after that. (even tho it allready is ;))
-
View User Profile
-
Send Message
Posted Aug 3, 2014@Fighter88
Nope. Their new built-in border is currently limited to square shape only, and of course this plugin has many other features available. Read this post further down this same page for more info:
http://dev.bukkit.org/bukkit-plugins/worldborder/#c1694
-
View User Profile
-
Send Message
Posted Aug 3, 20141.8 The end of worldborder? Mojang brings its own border to !?
-
View User Profile
-
Send Message
Posted Aug 2, 2014@Pixiio
The player should be dismounted from the horse, and both the player and horse should be moved back inside the border to the same spot. Is that not what you're seeing? If that's not working correctly, and assuming you haven't changed anything in regards to /wb remount (in other words, assuming it's still set to the default of 0 / disabled), please post your full server startup log so I can see the versions of CraftBukkit and WorldBorder you're running, along with the other plugin startup info.