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 Feb 1, 2014Hi there!
Feature Request:
An option to stop chunks from generating beyond a world border.
Cheers!
-
View User Profile
-
Send Message
Posted Feb 1, 2014@Craft_Like_A_Pro
Your choices are square, rectangular, circular, or ellipsoid/ovoid.
-
View User Profile
-
Send Message
Posted Feb 1, 2014Well, Is there a way to do a custom shaped worldborder?
Like this for example:
___________________________
| ____________|
|_____. |
| |
|_________|
-
View User Profile
-
Send Message
Posted Feb 1, 2014@Stevensaurus
The teleport should be redirected just inside the border.
@Craft_Like_A_Pro
There isn't, sorry.
@woolfie99MC
It can prevent the lag associated with new world chunks being generated by the server, particularly if you use the Fill command to generate everything inside your border.
-
View User Profile
-
Send Message
Posted Jan 31, 2014Am I right in saying that this plugin would help reduce lag on my server?
-
View User Profile
-
Send Message
Posted Jan 31, 2014Is it possible to have multiple borders in a world?
-
View User Profile
-
Send Message
Posted Jan 31, 2014Let me start by saying I love the plugin and it works quite well. Thanks for making it.
If a player had a home set in the world before it was reset and the border was added, what will happen if they try to use /home? Will it teleport them outside the border?
-
View User Profile
-
Send Message
Posted Jan 29, 2014@ShwiggityShwag
wb world fill comfirm
Might want to recheck that. For one thing you don't necessarily need to specify the world there, but more importantly it's spelled "confirm" rather than "comfirm".
-
View User Profile
-
Send Message
Posted Jan 29, 2014@Brettflan
I know I shouldn't use decimals..
This is literally what I'm doing and it's still not working.
wb world set 5000 33 257
[21:06:39 INFO]: [WorldBorder] Border set. World "world" has border radius 5000 at X: 33.0 Z: 257.0
[21:06:39 INFO]: [WorldBorder] [CONFIG] Configuration saved.
wb world fill
[21:06:46 INFO]: World generation task is ready for world "world", padding the map out to 208 blocks beyond the border (default 208), and the task will try to generate up to 20 chunks per second (default 20). Parts of the world which are already fully generated will be skipped.
[21:06:46 INFO]: This process can take a very long time depending on the world's border size. Also, depending on the chunk processing rate, players will likely experience severe lag for the duration.
[21:06:46 INFO]: You should now use wb fill confirm to start the process.
[21:06:46 INFO]: You can cancel at any time with wb fill cancel, or pause/unpause with wb fill pause.
wb world fill comfirm
[21:06:56 INFO]: The frequency and padding values must be integers.
-
View User Profile
-
Send Message
Posted Jan 29, 2014@ShwiggityShwag
That means you're not entering valid whole numbers for the frequency or padding values when using the Fill or Trim command. Please refer to the command info for proper usage.
-
View User Profile
-
Send Message
Posted Jan 28, 2014@Brettflan
I am constantly getting this error message saying "The frequency and Padding values must be integers" How do I fix this error? I got it to work like once, I repeated that and it gave me the message again. please help :/
-
View User Profile
-
Send Message
Posted Jan 27, 2014@ken890728
You have my blessing, though most of the language strings are hardcoded in the source. A few of course can be set using a command, like the border crossing message.
I'd been meaning to eventually see about separating all messages out to an editable file to allow for message localization and customization, but honestly I'll probably never have the time and inclination to do it based on my limited free time and other more important things to work on.
-
View User Profile
-
Send Message
Posted Jan 26, 2014Hello!!Could I translate your WorldBorder to Chinese? 請問我能將您的插件翻譯成中文嗎?
-
View User Profile
-
Send Message
Posted Jan 26, 2014@dotapurex1
Interesting, it does look to be specifically caused by CombatTag preventing teleportation.
Having just checked the teleport method WorldBorder uses, I see that I could add an indicator that the TeleportCause is a plugin rather than player command, ender pearl, portal entry, or so forth. Other plugins could then potentially not interfere based on that info.
I'll add that in the next release of WorldBorder.
It looks like that should then hopefully have CombatTag not interfere as long as the knockback is less than 8 blocks, based on what I'm reading in their source:
https://github.com/trc202/Combat-Tag/blob/master/CombatTag/com/trc202/CombatTagListeners/NoPvpPlayerListener.java#L129
-
View User Profile
-
Send Message
Posted Jan 26, 2014Heres the exact video on how to do it:
http://www.youtube.com/watch?v=oX-qI2IxwA8#t=23
Apparently, plugin: Combattag is affecting the worldborder?
If i have the option disable Teleport while in combat in plugin "Combattag" it bypasses the worldborder until the Combat timer is off.
-
View User Profile
-
Send Message
Posted Jan 25, 2014@dotapurex1
They should then be knocked back from the border afterwards. If not, please indicate what happens in more detail.
-
View User Profile
-
Send Message
Posted Jan 25, 2014Players are able to knock someone through the border using a knockback:2 sword?
-
View User Profile
-
Send Message
Posted Jan 25, 2014@Nightreaber
See here: http://dev.bukkit.org/bukkit-plugins/worldborder/?comment=1421
-
View User Profile
-
Send Message
Posted Jan 25, 2014Can i set a default border for every new world?
-
View User Profile
-
Send Message
Posted Jan 24, 2014@Mortalsinn
Check your PM.