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 Aug 6, 2015@MasterMithrandir
I don't have the time to add a feature like that, but the source is available for anyone else who might want to give it a shot.
-
View User Profile
-
Send Message
Posted Aug 6, 2015@Brettflan
Could you please consider this?: http://dev.bukkit.org/bukkit-plugins/worldborder/tickets/116-suggestion-option-to-respect-claimed-lands-when-trimming/
-
View User Profile
-
Send Message
Posted Aug 4, 2015@Jakenus2018
The default border shape is round/elliptic. That means it's only the full width directly out in cardinal directions from the center (straight north, south, east, and west). If you go out at an angle, obviously you won't reach such a coordinate before hitting the border.
-
View User Profile
-
Send Message
Posted Aug 4, 2015I am at x 0 z 0 and i do /wb set 10000 but the world border is 7k. Help?
-
View User Profile
-
Send Message
Posted Aug 2, 2015@Cha0sPudd1ng
What's indicated in the log from when you ran the Trim? Also, you have stopped the server and started it back up after running the Trim, correct?
-
View User Profile
-
Send Message
Posted Aug 2, 2015HI,
I have Trim my world, but not all Chunks are deleted.
On Dynmap you can see this:
Dynmap-Picture
And in MCEdit I see this:
MCEdit-Picture
What are these for chunks, and how i can fix that?
-
View User Profile
-
Send Message
Posted Jul 30, 2015@Jawfy
If you're talking about setting a time, that implies you're talking about the vanilla world border feature added into native Minecraft rather than this plugin.
If that's not the case, please specify the exact command you are running.
-
View User Profile
-
Send Message
Posted Jul 30, 2015I'm starting up a factions server and would like this plugin within it... But when ever I set it up do the center then the full size I want it doesn't go there? I don't set any time for it to get there just 0 but i've also tried 10 but still doesn't work please help!!!
-
View User Profile
-
Send Message
Posted Jul 27, 2015@H8llfire
It actually fetches all of the names based on UUIDs in a single call, not individually. And of course normally the bypass list is only viewable by server admins.
However, it could indeed be improved to use cached names and only do a lookup if there are any uncached names, and potentially be changed to run the name lookup in an async thread (though afterwards it would of course need to return the list of names to the CommandSender in a sync thread). I don't really have time to work on that right now, though.
-
View User Profile
-
Send Message
Posted Jul 26, 2015Is there any way you can fix the bypasslist? Currently it hogs the main server thread until it manually fetched all the UUID's. Could you make this to use the UUID cache where applicable and also async some way?
-
View User Profile
-
Send Message
Posted Jul 22, 2015@unclemark
Make sure the random light updates are enabled in your spigot.yml.
-
View User Profile
-
Send Message
Posted Jul 20, 2015@unclemark
That's a longstanding issue with Minecraft world generation in general, where some areas don't have lighting initially rendered correctly. Having a player move near them (sometimes needing to move right into them or even placing a torch to force re-lighting) fixes them.
-
View User Profile
-
Send Message
Posted Jul 20, 2015Lighting errors- I rendered out the map with only the worldborder plugin installed (spigot 1.8.7) and all overhangs and stuff under trees have weird shadows that don't seem to go away. Like total darkness.
Should I use craftbukkit instead or is there a way to render a perfect map without lighting bugs ?
Thanks
-
View User Profile
-
Send Message
Posted Jul 18, 2015@Breetflan It's working fine now, I'm assuming maybe it had something to do with Dynamic Map.
-
View User Profile
-
Send Message
Posted Jul 18, 2015@CroAtTheTop
If you're convinced everything is running smoothly and still find that to be a problem, feel free to lower the border check delay value.
From the command and permission list linked on this page:
/wb delay <amount> - the number of server ticks it will wait between border checks, the default is 5 ticks (250ms); each server tick is roughly 50ms.
-
View User Profile
-
Send Message
Posted Jul 18, 2015@Brettflan
Well my server runs smooth 20TPS all time, I have my own dedi machine for it, and WB is able to function properly, I am telling you its a glitch, I can show it if you want, can be done easely.
-
View User Profile
-
Send Message
Posted Jul 17, 2015@CroAtTheTop
Bases probably shouldn't be built right on the border, for one thing. Also, that sort of base exploit shouldn't generally be possible except when your server is under stress to the point that the border check isn't able to run at its normal frequency.
-
View User Profile
-
Send Message
Posted Jul 17, 2015Well the problem I have is abusing WorldBorder to glitch into bases. If you sprint fast enough, and get yourself into the world border (Infront of something thats on the edge of border) you will get knocked back inside of that structure...
-
View User Profile
-
Send Message
Posted Jul 16, 2015@CroAtTheTop
This plugin doesn't provide a physical border, sorry.
@Kipklysmic
I can't think of anything that might cause that. Please post your server startup log with the Spigot build info and WorldBorder startup info.
-
View User Profile
-
Send Message
Posted Jul 16, 2015@brettflan Yeah, It's still showing the integer error even if I just do /wb World trim (world name is World with a cap) Also tried multiple reloads and restarts but it didn't solve anything.