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 Jul 12, 2015Hey, how could I make world border have that red line shining and blocking instead of knocking back players?
-
View User Profile
-
Send Message
Posted Jul 12, 2015@unclemark
He could try running it at a lower frequency (specified in the command), but it's still likely to occasionally pause due to low memory. When it does so, it will try to initiate garbage collection to free up memory, and will automatically continue the Fill once enough free memory (500 MB +) is available.
I'd also recommend with only 1 GB memory to temporarily remove any other mods from the server while running the Fill. Especially if you're running something like Dynmap.
-
View User Profile
-
Send Message
Posted Jul 12, 2015Brett, hi - it's 151baccardi. A friend of mine is getting ready to cry - he's trying to fill his world with the fill command and it always stops on him. He has like a tiny 1gb server for now - his border is 5000x5000 ~ is there any way (syntax wise) he can fill his world without if pausing because of low on memory ?
Thanks buddy.
-
View User Profile
-
Send Message
Posted Jul 12, 2015@BSidiocy
Assuming you don't want people to be kept within the border, you can remove the border for the world in question with the clear command.
-
View User Profile
-
Send Message
Posted Jul 12, 2015How to remove Fill border? Im using dynmap and it shows the fill border ..
It looks ugly :/ pls help?
-
View User Profile
-
Send Message
Posted Jul 10, 2015@Kipklysmic
First, a couple of things to note:
Remember that capitalization matters in the world name. Normally the first created world is "world" with no capitalization.
The default values for freq and pad are 5000 and 208 respectively, so there's no need to specify them at all in the command if you're fine with the defaults.
I just tested in Spigot 1.8.7-R0.1-SNAPSHOT to be sure, and a slightly modified version of what you posted worked fine for me from server console:
wb world trim 5000 208
The error you received is triggered when it tries to read what you specified in the command (if anything) for freq and pad as integers (whole numbers, no decimal place, no letters or anything else but numbers). If trying to read either of those values as an integer fails, it gives you that error.
There's no reason you should get that error unless you messed the command up.
-
View User Profile
-
Send Message
Posted Jul 10, 2015Hi, I'm having some issues with the /wb trim command. No matter what [freq] and [pad] values I try to use I keep getting the same error each time: 'The frequency and the padding values must be integers'. /wb World trim 5000 208 is the command I'm trying to use and i keep getting that error, changed the numbers and tried again but it didn't work. Using Spigot and World border 1.8.4. Fill seems to be working fine its just the trim command. Help would be greatly appreciated!
-
View User Profile
-
Send Message
Posted Jul 9, 2015@Brettflan
I don't want ANYONE stuck in the border. I'll try the knockback 0. Thanks.
-
View User Profile
-
Send Message
Posted Jul 8, 2015@dutchrastacraft
Sorry, there isn't. If you just want to disable the border, there are a few ways to do that, just off the top of my head setting knockback to 0 will make it disable the border check.
You wouldn't want to set bypass for most of the server anyway, as that is stored in a list and having the plugin check through a long list of most or all people ever on the server for each border check would be very inefficient and prone to causing lag.
If you're just wanting a few people to be stuck inside the border, I can't think of an efficient way to do that with how the plugin is designed; it was never really intended to work that way.
-
View User Profile
-
Send Message
Posted Jul 8, 2015Hi,
Is there an option to have bypass on by default? Maybe by permission or something? I tried fixing this with my own plugin but it's lagging the server when too many people join the server (PlayerJoinEvent).
Thanks in advance.
-
View User Profile
-
Send Message
Posted Jul 4, 2015@ServerElementals
There are no options to automatically create a border, sorry. You'd need to manually determine how far away from the desired border center the furthest building or whatever is and set the border based on that, or alternately find the furthest spots in two opposite directions and set the border based on those corner locations.
-
View User Profile
-
Send Message
Posted Jul 4, 2015Hi would it be able to set the current worlds borders automatically, Meaning I already have a world that has buildings, factions, players, etc though the explored area is big enough so I want it to automatically border it.
Do you know what I mean? Is it possible :p?
-
View User Profile
-
Send Message
Posted Jul 3, 2015@ItIsMeMyself
For reference, WorldBorder uses "TeleportCause.PLUGIN".
-
View User Profile
-
Send Message
Posted Jul 3, 2015@Brettflan
Ah, yeah, that would be PvPManager. Guess I'll have to ask it's author to add support for WorldBorder.
-
View User Profile
-
Send Message
Posted Jul 3, 2015@ItIsMeMyself
The only way that should be able to happen which would leave a player outside the border is if another plugin is preventing a player from being teleported (assuming the player hasn't been granted permission to be outside the border).
@Z3dd7
This has always been possible since Minecraft generates terrain out to a certain distance from any player, and is why the Fill command has a configurable padding value.
If players are now being able to get further beyond the border before being knocked back, that indicates that your server is overloaded and not keeping up. This could be due to more needy plugins, or more players than you've had before, or anything else that might lead to a more stressed server.
-
View User Profile
-
Send Message
Posted Jul 3, 2015Hi !
I have an issue since 1.8 (I think) : players that reach the border generate a few chunks before being knocked back, which cause the minimap to be ugly :/
For example, the following link is a screenshot of a 5000x5000 map generated in 1.6.2 with the command /wb fill : http://nsa37.casimages.com/img/2015/07/03/150703110430348401.jpg
Until 1.8 players were stopped before being able to generate more chunks than the fill command did.
But now, each time a player reach the border, some chunks are generated.
Is there a way to prevent that ? Maybe a config option to prevent player from approaching the border from more than x meters ?
I am using Spigot 1.8.7 + WB 1.8.4.
Thanks for help, Z3.
-
View User Profile
-
Send Message
Posted Jul 2, 2015@Brettflan
Just noticed that during PvP, if you get knocked back you can go through the border.
-
View User Profile
-
Send Message
Posted Jul 2, 2015@doomlordking
Yes, the Fill command fully generates everything (snow, trees, dungeons, etc.).
-
View User Profile
-
Send Message
Posted Jul 2, 2015I use the premade map of the of earth, the chunks are there but not populated so when u run there snow/tree/building appear. If i used the /wb fill command will it populate all the chunks so i don't have to run from X0,Z0 to X13000,Z36000?
-
View User Profile
-
Send Message
Posted Jun 27, 2015@sebas0987
I'm not sure I understand the question; nobody is allowed beyond the border unless they've been specifically granted the ability to do so.