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 Nov 28, 2013@mcrbradbury
Check your capitalization in the world names. It must match up exactly.
-
View User Profile
-
Send Message
Posted Nov 28, 2013I have a question,
I've been using this for a while and it's great, but i've got bit of a recent problem i hope you can help with.
I'm running a server with several worlds (Overworld, Twilight forest, Nether, End).
I need different borders for each. I also use Dynmap.
For the Overworld, everything works as intended. For every other world, i set the world border and get "The world you specified ("*world*") could not be found on the server, but data for it will be stored anyway. "
The strange thing is the border shows up on dynmap, and the world name is correct. But the border doesn't actually work.
Any idea? thanks
-
View User Profile
-
Send Message
Posted Nov 27, 2013@wumpyc
Offhand I don't know, especially with the major new world features coming up in Minecraft 1.7. The file sizes may end up increasing. You can figure it out roughly yourself by looking at your current world region files, though. Each world region file (*.mca) covers a 512x512 block area. Find the largest one of these files for an existing well-used world you have and you can use that as a guideline for the most space likely needed for a 512x512 block area. Extrapolate from there, being sure to account for about 208 blocks visible beyond the edge of the border.
-
View User Profile
-
Send Message
Posted Nov 27, 2013@Brettflan
Could you answer my question, please?
-
View User Profile
-
Send Message
Posted Nov 26, 2013@Maximvdw
There isn't, and there generally should be no need. Only the changed / newly generated chunks are supposed to be saved, so based on that if you delayed it then it would just take that much longer to save. Not to mention, CraftBukkit/Minecraft's world generation code still has the rare fatal bug or two that can crash the process entirely, which are further supplemented by bugs in world generation plugins. These could cause newly generated parts of the world which aren't already saved to be lost.
Seeing as you seem to be able to find that in the source, yes, you could modify that value to change the interval. Just multiply the number there by 5 to equate to the number of seconds between forced saving of the world.
Just be prepared for potential problems.
-
View User Profile
-
Send Message
Posted Nov 26, 2013Is there a way (or could it be added) to change the interval of "Saving the world to disk" when doing a /wb fill? I have a big map and it takes 5-10 secconds to save. It doesn't need to be precise changing the:
if (reportCounter >= X) where I could chage X to 12 or something would be nice (instead of 6)
gr, Maxim
-
View User Profile
-
Send Message
Posted Nov 24, 2013@xCyanide
Sorry, there isn't.
-
View User Profile
-
Send Message
Posted Nov 24, 2013Is there a way to block players from claiming land at the world border?
-
View User Profile
-
Send Message
Posted Nov 23, 2013How much should the radius be if I want to limit my world to 10GB?
-
View User Profile
-
Send Message
Posted Nov 23, 2013@cokkan The most relevant bits:
The world generation error there looks like it was caused by a world generator plugin you're using based on the stack trace, though there's a slim chance it might actually be the fault of the CraftBukkit/Minecraft world generation code. Either way not WorldBorder's fault and there's nothing I can do about it.
-
View User Profile
-
Send Message
Posted Nov 22, 2013Hello Brett, I could use help with this error. World boarder craps out about 50-75% of generations.
http://pastebin.com/wDr6Du7m
Thanks
-
View User Profile
-
Send Message
Posted Nov 19, 2013@Redstoner_Pro
The command is /wb bypass [player] [on/off], covered on the Full list of Commands and Permissions page above and the ingame command list from just using /wb.
-
View User Profile
-
Send Message
Posted Nov 18, 2013So, Your first line in the description states - "This plugin is intended to efficiently provide a border for each of your worlds, which nobody is allowed beyond except for people temporarily granted bypass access. "
How do i grant this temporary bypass? I cant seem to find information on this anywhere on your page.
@15987632
You could always try to use worldguard with entry/exit flags set to deny.
-
View User Profile
-
Send Message
Posted Nov 17, 2013@15987632
I already know what adding support for multiple borders per world would entail, including a rework of many current plugin commands that are designed assuming only one border per world. It would be more work than I feel like putting into it, as well as making it a bit more difficult for users of the plugin to set/clear specific borders.
-
View User Profile
-
Send Message
Posted Nov 17, 2013@Brettflan
I understand this 100% after using your plugin for a while. however because i needed multiple borders i am currently using http://dev.bukkit.org/bukkit-plugins/voxelborder/ if you want you could look at there code but its your choice.
-
View User Profile
-
Send Message
Posted Nov 17, 2013@SentinelCraft
As 15987632 said, the plugin will almost certainly work fine in 1.7.2 without needing an update. If not, I should be able to put out an update within a few days of hearing about a valid problem.
@15987632
Sorry, for various reasons only one border per world can be set.
-
View User Profile
-
Send Message
Posted Nov 16, 2013@SentinelCraft
With the bukkit api plugins shouldn't stop working even if they are outdated
-
View User Profile
-
Send Message
Posted Nov 16, 2013@Brettflan is there a way to have 2 borders in a world?
-
View User Profile
-
Send Message
Posted Nov 16, 2013Thanks for your hard work on this. Very helpful. I am preparing to upgrade my server to 1.7.2 and to stop people from just exploring in a straight line I am going to add this plugin.
My question is do you have a rough ETA for when you would have updated to 1.7.2? I am trying to take stock of all the plugins and which ones Have/Need to be updated.
-
View User Profile
-
Send Message
Posted Nov 16, 2013@Jacold
https://www.google.com/search?q=RegionFile.java%3A76+ArrayIndexOutOfBoundsException
Looks like you probably have corrupt chunk data in one of your region files based on a couple of results above. You can ask for help in one of the threads linked above, as again this is not due to WorldBorder.