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 2, 2014@Brettflan
Any way to fix people with a horse going trough the worldborder?
Thanks for the great plugin.
-
View User Profile
-
Send Message
Posted Aug 1, 2014@MCTylerPVP
This page should pretty much cover setting everything up:
http://wiki.bukkit.org/Setting_Up_Your_Workspace#Using_Maven
If you've had trouble with Eclipse, give Netbeans a try. Most people in this community seem to like Eclipse, but I personally use Netbeans for Java development. I find it simpler and more straightforward to use.
-
View User Profile
-
Send Message
Posted Aug 1, 2014This plugin will continue to work as always, and you'll have the new entirely separate option of using Minecraft's built-in square physical borders they're adding in 1.8.0.
Once a reasonably stable 1.8.0 build of CraftBukkit is out, I'm going to try to set aside some time to look into how I might interface this plugin with their new border feature. I don't feel like speculating on exactly how that might work, or really have time to do so. I'll see when it's available.
-
View User Profile
-
Send Message
Posted Aug 1, 2014I Went downstairs to think about how to solve a certain issue... What to do with my world when 1.8.0 comes out? I stood still for a moment and came up with What if Worldborder added the command "AddBorder" and So I find myself here with this awesome suggestion.
What if the command AddBorder is implented? Well, we would never need to worry about MC updates again!
The idea is as following:
l = a border l
-Teleport>l Is a region wich will not be generated to trim the landscape in between updates.This is the Idea:
l<
Teleport-l MC 1.8.0 l<Teleport-l Spawn MC1.7.9 l-Teleport>l MC 1.8.0 l-Teleport>lSo instead of teleport to other side you will have the feature Teleport to next border. Ofcourse you could choose to not activate this feature and have a normal border.
Anyway, I hope you'll take this idea into reconsideration :)
-
View User Profile
-
Send Message
Posted Aug 1, 2014@Brettflan
What programs do you need to make a build? I'd like to start doing this on some plugins. I've trie before in Eclipse and can't figure it out. Thanks Adv----
-
View User Profile
-
Send Message
Posted Jul 30, 2014@stuffer999
That's actually already available in the source on GitHub due to a code contribution by Maximvdw, so it will be in the next release. It works using the radius command, such that you can specify a + or - to indicate the radius should be increased or decreased by the specified value rather than just setting the radius to equal that value.
So, for example:
/wb worldName set 100 spawn - for world "worldName", border of radius 100 set at spawn /wb worldName radius +10 - border radius is increased by 10 (100 + 10 = 110)
I'm not sure when I'll be making the next official release, as the command update above is the single change made since 1.8.0 was released. If you're unable to build from my source on GitHub for whatever reason (should be pretty simple since it's Mavenized), send me a PM and I'll make a quick build for you.
-
View User Profile
-
Send Message
Posted Jul 30, 2014Hey, I have a suggestion for the plugin. It is a /wb add command that takes the following format: /wb add <no. of extra blocks to add to border radius x> <no. of extra blocks to add to border radius x>
So that I can integrate WorldBorder with my donation store.
-
View User Profile
-
Send Message
Posted Jul 29, 2014@Pixiyo
The vehicle should be teleported back inside the border to the same spot as the player and have its velocity set to 0. That's what is done for all vehicle entities. If that's not what you're seeing, please provide more info.
As for leaving the player inside the vehicle, due to a very very longstanding bug/issue with CraftBukkit/Minecraft which causes horrible things to happen when trying to teleport an entity that has a passenger or is a passenger of another entity, they have to be dismounted before being moved back inside the border. Remounting them immediately afterwards can also cause problems if it's done before the client is informed of the movement. I tried having that done after a few ticks, but for a player with a high ping or if the server is under stress, it could still go wrong, which is why that's not enabled by default.
-
View User Profile
-
Send Message
Posted Jul 29, 2014Could you please add vehile support? It's possible to fly over a border with uPlanes. Author of uPlanes says that's it will be fixed if you add vehicle support...
Thanks
-
View User Profile
-
Send Message
Posted Jul 23, 2014@RustyDagger
I'd planned to try implementing a pseudo-physical border (sent to client as "real" and blocking movement, but not really present in the world files on the server), but with the upcoming square physical border option (via /worldborder command, amusingly enough) in the dev builds of Minecraft itself, I'm going to wait on doing anything of the sort for now. It might be possible to co-opt their physical border method in some way, we'll see.
Without a visual indicator of the border, a text warning that the person is approaching the border is of limited use since they'll only know it's probably in the general direction they're moving. There would also be the matter of whether to keep spamming them with warnings while they're near the border and annoying anyone wanting to hang around near it, or just telling them one or twice and then leaving them without further warning.
It would also require an additional check (and further processing) to see whether a person is near the border or actually past it.
-
View User Profile
-
Send Message
Posted Jul 23, 2014Im having an issue On my modded server we have planes Quite a few times now players have been flying them and hit the border They are teleported back in and the plane continues out side the border. the result is quite unfair. and normally my self or a staff member has to bypass and go fetch it.
I was hoping to see an option for a glass border or something but Nope :( or maybe some kind or warning zone that lets them know they are getting close to the border.
-
View User Profile
-
Send Message
Posted Jul 19, 2014It is a little sad to see this plugin being pushed out in certain ways because of the new worldborder command in the snapshots.
-
View User Profile
-
Send Message
Posted Jul 18, 2014@boniomri
You can use Worldguard to do that.
-
View User Profile
-
Send Message
Posted Jul 17, 2014@boniomri
Anyone who spawned outside the border would immediately be moved back inside the border, so that wouldn't work.
-
View User Profile
-
Send Message
Posted Jul 17, 2014Is it possible to create the spawn outside the worldborder? I basically want to have an area you can't get in to, get out of will be done with buildings.
-
View User Profile
-
Send Message
Posted Jul 15, 2014@BAI1
There are no plans for WorldBorder to support multiple borders on a single world or anything of the sort, sorry. It would however of course be possible to add another world with whatever features you desire and set a border on it wherever you want.
-
View User Profile
-
Send Message
Posted Jul 11, 2014@Renevence
You can always use worldguard and make it so you cant go back inside! KInda easy! Have done that myself one time!! :)
-
View User Profile
-
Send Message
Posted Jul 10, 2014@Renevence
This plugin will only keep people inside a given area, not keep them out of a specific area once they leave it.
You might be able to do something like that with WorldGuard.
-
View User Profile
-
Send Message
Posted Jul 10, 2014I'm trying to setup a One-Way border in and out of spawn, how would I do this. I want people to be able to freely move about in spawn, but once they pass the border line, not be able to re-enter. The player also needs to be able to do /spawn from anywhere in the world. Any advice?
-
View User Profile
-
Send Message
Posted Jul 7, 2014@LegendaryAdmin
With a round/elliptic border, you'll only reach the full radius distance on either axis (X or Z, take your pick) if you go straight out from the center on that axis without deviating on the other axis. If you move out diagonally from the center, with both X and Z coordinates changing, you won't be able to get as far on either axis, of course.
If you want to be able to reach the "corners" of the area (5m X and 5m Z) you would need to use a square/rectangular border shape instead.