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 Jun 22, 2012strange...my server shuts down when i use the trim command...fill works fine without performance problems...
i used /wb [world] trim 5000 208 and /wb world trim 20 208 but the server restarts....
edit: i also removed all plugins except worldedit, worldguard, authme and mutliverse and worldborder...but the server crashed/restarted
-
View User Profile
-
Send Message
Posted Jun 21, 2012Hey, I know you can just trim extra chunks, but what if someone creates a nether portal way out some place outside the border? This will continually be outside the border and is hard to stop. Is it possible to somehow reroute the location of the resulting portal itself to be a little ways inside the border? Or to not generate the chunk if they teleport outside the border since they are instantly teleporting to inside the border?
Thanks!
-
View User Profile
-
Send Message
Posted Jun 19, 2012hey are you able to make it to have like a tool support because I have no idea how many blocks the place is
-
View User Profile
-
Send Message
Posted Jun 19, 2012@nhoclesnar
WorldBorder uses Bukkit's built-in generation methods. IIRC others have had complete success by defining the world generator in bukkit.yml or similar.
-
View User Profile
-
Send Message
Posted Jun 18, 2012Hey Brettflan, I have a small question I'm concerning about. If I use a world generating plugin, CityWorld, for a certain world, and I use '/wb fill' command to fill up all the chunks inside the border, will all the chunks be fully generated? I want it so that even if I remove CityWorld, players will see all city buildings and not normal minecraft world inside that world. Thank you in advance :)
-
View User Profile
-
Send Message
Posted Jun 17, 2012@Brettflan
Ok problem is solved, dunno what the problem was, restart in server and its fixed... Weird...
-
View User Profile
-
Send Message
Posted Jun 17, 2012@Brettflan
apparantley not lol thanks
-
View User Profile
-
Send Message
Posted Jun 17, 2012@BBFChaser
Have you read the note above on the Trim command? Copied:
NOTE: If you are using the DynMap plugin and use our "trim" command, you will need to restart your server afterwards and then run a "fullrender" in DynMap to properly update their map display.
-
View User Profile
-
Send Message
Posted Jun 17, 2012The only issue i seem to be having is that the trim command isnt working properly or dynmap isnt updating properly.
Here is our map
World HungerGames needs to be trimmed i ran the command a few times and its still not trimmed.
-
View User Profile
-
Send Message
Posted Jun 17, 2012Just tested WorldBorder 1.5.4 in CraftBukkit 1.2.5-R4.0 and it's working fine for me. I set a small border and tried crossing it, and was knocked back inside as expected.
Anyone else having this problem of border crossings not being prevented with CraftBukkit 1.2.5-R4.0?
Please post the startup log for your server.
-
View User Profile
-
Send Message
Posted Jun 16, 2012@Brettflan @Lukethenuke
Yes I ment 1.2.5-R4.0
-
View User Profile
-
Send Message
Posted Jun 16, 2012@Brettflan
I think he means that your plugin isn't working on 1.2.5-R4.0
-
View User Profile
-
Send Message
Posted Jun 15, 2012@rodeyseijkens
What do you mean by "CB 4.0"? That's not a version number which I recognize. Are you using a modified version of CraftBukkit like Tekkit or MCPC or
CraftBukkit++or something?Also, WorldBorder doesn't monitor player movement, it simply runs a server-synced thread which checks all player locations every few server ticks.
-
View User Profile
-
Send Message
Posted Jun 15, 2012@Brettflan
It isn't working anymore on CB 4.0... Quick Fix Please!!!
It looks like the Player Move Isn't working anymore. It does however push you back when I use /jumpto.
No errors in console.
-
View User Profile
-
Send Message
Posted Jun 6, 2012@BBFChaser
So have you tried doing a fullrender with DynMap? WorldBorder skips chunks that already exist with all 4 adjacent chunks also already existing; in other words, it skips chunks that don't need to be generated because they're already there.
@juodas
Shouldn't be necessary, as I doubt they've changed anything that would break the plugin.
-
View User Profile
-
Send Message
Posted Jun 6, 2012Are you going to update to 1.2.5 R 3.0?
-
View User Profile
-
Send Message
Posted Jun 3, 2012@Brettflan
This is our servers Dynmap.
http://www.clanbbf.com/minecraftmap.html
World and BBF_City should be full but as you can see they are not.
Every time I run the fill command it will say
03.06 10:23:03 [Server] INFO [WorldBorder] [Fill] task successfully completed! (free mem: 1831 MB)
03.06 10:23:03 [Server] INFO [WorldBorder] [Fill] 1731 more chunks processed (58807 total with 55932 skipped, 100.0%) (free mem: 1832 MB)
As you can see it skipped a lot of chunks the border is set at 1700. Also its not like I ran out of memory.
The Dynmap has been like this for days now. I started flying around to try and clear it but even that is a slow process.
-
View User Profile
-
Send Message
Posted Jun 3, 2012@vidplace7
The vertical limit is normally 256, so I don't know how your players are able to go higher. They shouldn't be able to AFAIK.
@BBFChaser
As I always ask related to the fill and trim tasks, WHERE are you seeing that the map isn't being filled/trimmed properly? A very important detail. Presumably it would be through a mapping plugin or tool, which I'm guessing just isn't updating quickly enough.
-
View User Profile
-
Send Message
Posted Jun 2, 2012I am having an issue with the fill command not filling the map properly.
It seems like every time I run the command half of the chunks get skipped.
-
View User Profile
-
Send Message
Posted May 31, 2012Would there be any possible way of having a height border? I have mods on my server and people have been flying above y=256 where they can't take damage. If you could incorporate height borders or point me in the direction of a plugin that can do so?