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 29, 2013@N1T3SLAY3R
As long as the other plugin registers their world generator through Bukkit, it will work.
-
View User Profile
-
Send Message
Posted Mar 29, 2013@N1T3SLAY3R
It SHOULD get the files for the world you're filling from the disk.. *should*
-
View User Profile
-
Send Message
Posted Mar 29, 2013It shoudlnt be laggy mac, the only time it will be is if u fill the world in.
-
View User Profile
-
Send Message
Posted Mar 28, 2013my server will be more laggy using this? or the opposite?
-
View User Profile
-
Send Message
Posted Mar 28, 2013update to 1.5.1?
-
View User Profile
-
Send Message
Posted Mar 28, 2013If i have a plugin like terrain control or hoth generator, when i trim/fill the borders and stuff, will it apply their generation? Or will it use vanilla world generations to fill?
-
View User Profile
-
Send Message
Posted Mar 28, 2013How long would wb fill take if i have a 13000 border?
-
View User Profile
-
Send Message
Posted Mar 27, 2013when ppl should be teleported to lava they instead get teleported at middle of world border (spawn) erm but i want even if there's lava there, still teleport them to lava
-
View User Profile
-
Send Message
Posted Mar 27, 2013@GamersSynergy
Depends on your machine's specs, start out with 5000 and then increase it later on if you need to :)
-
View User Profile
-
Send Message
Posted Mar 26, 2013Is there a maximum width? Or is it pretty much unlimited? Is 7000 too much?
-
View User Profile
-
Send Message
Posted Mar 25, 2013@Brettflan
Ok, I figured it was a simple function call to get the ticks and didn't realize it would require a lot of additional code to implement. Thanks for conversing with me regarding it.
-
View User Profile
-
Send Message
Posted Mar 25, 2013@dalphi
Essentials runs a once-per-tick task which they use to monitor timing and determine a "ticks per second" value among other things. It's their own custom thing, not info provided by Bukkit. I don't really have time to develop my own custom implementation of something similar; I have little enough free time as it is, and many other more important things to work on.
I do however accept reasonable pull requests to the source on GitHub, so another dev is welcome to work on something like that.
-
View User Profile
-
Send Message
Posted Mar 24, 2013@Brettflan
The server ticks per second. The default is 20. Essentials has a command, /gc to see the current ticks of the server. Once it gets too low, gameplay gets laggy.
When I fill at the default frequency, the server ticks drops below 1. This is partially due to my server using dynmap, since not only is the server working on creating new chunks, it has to render the map for the new chunks.
So, it would be nice if the ticks dropped below 10 or some threshold I set, that it pauses. This may cause a problem with it constantly stopping and starting as it goes below and then above the threshold. Maybe a dynamic option where it tries to do the default 20 chunk/sec when the server ticks are at 20, and then it drops down as the server ticks drop. So if the server has a tick rate of 14, then it tries for 14 chunks per second.
-
View User Profile
-
Send Message
Posted Mar 24, 2013@Aerodog
CraftBukkit bug which they seem unwilling to fix, but see here regardless:
http://dev.bukkit.org/server-mods/worldborder/tickets/55-can-ride-a-pig-past-world-border/#c4
-
View User Profile
-
Send Message
Posted Mar 24, 2013If you are riding a pig with a saddle and you have a carrot on a stick in your hand, you can bypass the border by guiding the pig out of the border. This plugin is effectively useless because of this bug.
-
View User Profile
-
Send Message
Posted Mar 24, 2013@dalphi
What do you mean by ticks getting below a certain threshold? It currently pauses if memory gets too low.
-
View User Profile
-
Send Message
Posted Mar 23, 2013Feature request: have border fill pause if ticks get below a certain threshold. Threshold would optimally be set on the command line for '/wb <world> fill'.
-
View User Profile
-
Send Message
Posted Mar 23, 2013@wiloh95
That's apparently Essentials. You can use /wborder or /worldborder instead.
-
View User Profile
-
Send Message
Posted Mar 23, 2013every time i type /wb my inventory just opens. Is this supposed to happen or is some other plugin interfering?
-
View User Profile
-
Send Message
Posted Mar 22, 2013It works for me on latest dev. build 1.5.1.