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 2, 2015hello :) when I hit the /wb fill command, it instantly finished without doing anything. im using 1.8.2 of WB and 2.1 dynmap.
any ideas why? If I don't remember wrongly, the fill is supposed to start rendering the map within the border to dynmap ey?
-
View User Profile
-
Send Message
Posted Mar 1, 2015@ShadowRanger24
It does. It's just basic interaction with the vanilla border, though. Specifically the size, location, warning distance, and damage buffer.
No way to make a custom (non-square) shape, or anything else particularly fancy.
-
View User Profile
-
Send Message
Posted Mar 1, 2015@Brettflan Based on my knowledge, the Spigot updated version of Bukkit/CraftBukkit has a WorldBorder API ready for developers to use. Would this not be a viable option?
-
View User Profile
-
Send Message
Posted Mar 1, 2015@Brettflan
Okay, I really like to pre-generate my world with your plugin o/
-
View User Profile
-
Send Message
Posted Mar 1, 2015@technowix
From what I saw a while back looking at the methods added to address the vanilla border in both Spigot and Sponge, don't get your hopes up for anything too elaborate. Properly integrating with the vanilla border looks to be all but impossible without trying to interface directly through NMS (Native Minecraft Server) code. That would be Bad (TM).
However, what you're asking for should be possible. Having the WB border reflect the vanilla border and having Fill work on the vanilla border area should definitely be possible. I'm just not sure when I might have the time to work on that sort of thing.
-
View User Profile
-
Send Message
Posted Mar 1, 2015@Brettflan
When we can have the "follow vanilla border" and "fill vanilla border" ? :p
-
View User Profile
-
Send Message
Posted Mar 1, 2015WorldBorder 1.8.2 release is now available in the file listings above, intended for Spigot builds based on Minecraft 1.8+.
Note that it probably won't work on any CraftBukkit builds based on Minecraft 1.7.x.
-
View User Profile
-
Send Message
Posted Mar 1, 2015@puckman1971
Are you running on Spigot for Minecraft 1.8.x? If so, that's probably it. In the Bukkit code for MC 1.8 they changed the Server.getOnlinePlayers() method which is used in WorldBorder's border knockback routine. Some Spigot builds apparently still have a deprecated version of the method which allows that method to still work for WorldBorder's knockback routine, while some have the deprecated method removed.
I have a workaround available which I haven't released an official build for yet. I was wanting to look into a very minor performance tweak for the workaround, but really I suppose it wouldn't make much difference.
I'll see about going ahead and making a release for MC 1.8 so that the border knockback works on all versions of Spigot.
EDIT:
I've gone ahead and pushed a 1.8.2 release for full Spigot compatibility. No idea when/if the file listing will be approved.
-
View User Profile
-
Send Message
Posted Mar 1, 2015Got a bit of a weird problem. Out of the blue knockback stopped working. People can simply walk past the world border. Tried restarting server, resetting worldborder, recreating the config file. Nothing works, the border shows ok on the dynmap, just does not seem to function.
Anyone got any suggestions?
-
View User Profile
-
Send Message
Posted Feb 26, 2015to 0dayrude
WorldGuard is your best bet. It's easy to overlap regions and set flags. As for efficiency and effectiveness, WG accomplishes both.
(k, I confess, I don't know how to tag people's name)
-
View User Profile
-
Send Message
Posted Feb 22, 2015working great on our spigot 1.8.1! thanks so much!!
-
View User Profile
-
Send Message
Posted Feb 15, 2015@rostik002
True, i'm just trying to limit the amount of plugins I need to use for the core of the server.
Well anyways if this cannot stop spawns outside of the border I would suggest that as a feature :s
-
View User Profile
-
Send Message
Posted Feb 13, 2015@0dayRUDE
I dont think you can, but you can create a worldguard region around the city and set mob spawning off
-
View User Profile
-
Send Message
Posted Feb 12, 2015@Brettflan
Ty very much BrettFlan, soo nice to see a plugin author who is attentive to his users
Much Respect!
Much Appreciation!
-
View User Profile
-
Send Message
Posted Feb 11, 2015Can this stop mob spawning outside of the border ? For example I am trying to set a border around a city and allow mobs to only spawn in that city so I'm trying to find a way to prevent mobs from spawning outside of said border.
-
View User Profile
-
Send Message
Posted Feb 11, 2015@H8llfire
Not likely possible from what little I've looked into it.
@killyouslow
It means the region was loaded by the server and couldn't be unloaded, or the region file was otherwise locked by some other process, so it couldn't be deleted. Generally, restarting your server and running the Trim again should take care of it.
-
View User Profile
-
Send Message
Posted Feb 11, 2015region file outside of the border couldnt be trimed, what does it mean (besides the obvious) and what can i do to fix it? should i even worry about it at all?
-
View User Profile
-
Send Message
Posted Jan 27, 2015@Brettflan
Nice! could you set it when it is a square worldborder to show the mojang one, while still allowing borderbypass? I'm not sure if this is technically possible though.
-
View User Profile
-
Send Message
Posted Jan 17, 2015@Brettflan
Please keep it updated for Spigot also.
-
View User Profile
-
Send Message
Posted Jan 12, 2015@Brettflan
YAY :D
If you do manage to switch to spigot, you should create a resource on there.