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 Oct 27, 2012@godgodgodgo
Are you getting any error? If not, are you just looking at Dynmap or similar and not following the directions in the info above regarding the Trim command and Dynmap?
-
View User Profile
-
Send Message
Posted Oct 27, 2012@Brettflan Hey, I'm using the wb trim command to get rid of all the areas outside of my border s but they're not deleting, any advice?
-
View User Profile
-
Send Message
Posted Oct 24, 2012@D3C0D3R
It will likely work for 1.4 without an update being necessary. The WorldBorder Fill process uses the world chunk generation methods provided by CraftBukkit (version independent), so any changes to world generation in new versions of CraftBukkit will carry through.
-
View User Profile
-
Send Message
Posted Oct 24, 2012Question.. Will this be updated in time for the 1.4 release? It'd be nice to be able to regen the map while keeping the spawn to get my server back up and running as soon as possible...
-
View User Profile
-
Send Message
Posted Oct 23, 2012@b4rtj4h
Someone else had that problem and it ended up being a compatibility problem with IE8 being unable to display the shape DynMap draws.
-
View User Profile
-
Send Message
Posted Oct 22, 2012I got a strange thing:
The red line on Dynmap does not show anymore.
-
View User Profile
-
Send Message
Posted Oct 21, 2012@Brettflan
on both of my server i have this bug and i cant fix it
-
View User Profile
-
Send Message
Posted Oct 18, 2012@Brettflan
Darn, I was hoping for some hidden flag to put in zoom-zoom mode :)
I'll try some different numbers for freq and see what happens.
-
View User Profile
-
Send Message
Posted Oct 18, 2012what is a good world size to use?
-
View User Profile
-
Send Message
Posted Oct 17, 2012@nick2253
The warning is still in effect, but as it is less of an issue on more powerful and less loaded servers, feel free to experiment. Might want to back up the world first based on the odd CraftBukkit "phantom chunks" problem some people have reported, though.
It's primarily a limitation of CraftBukkit and the Minecraft server core underneath it, and to a lesser degree Java (same for most other multithreading implementations for that matter). Most things in CraftBukkit need to be synchronized with the main thread if they're modifying any data (entities, world chunks, whatever).
-
View User Profile
-
Send Message
Posted Oct 17, 2012Does the warning about no more than 20 for freq still apply?
Also, is there a way to get World Border to use more CPU when filling the game world? Given that generation is a one-off event, I wouldn't mind having to shut everything down and give World Border all 8 cores to do world generation, but it barely uses 10% of one core as it is. Is there something I'm missing in order to make this happen, or is this a limitation of java + bukkit?
-
View User Profile
-
Send Message
Posted Oct 14, 2012@Tealk123
Well, the error occurs where WorldBorder is writing to a region file to wipe a chunk based on that stacktrace. That is when it is hanging, so it is something going on with your filesystem.
-
View User Profile
-
Send Message
Posted Oct 14, 2012@Brettflan
if i restart it i get the same error, the server can not be overlodet it have 10gb ram and if i fill the world (free mem: 8540 MB)
i get no ather errors
-
View User Profile
-
Send Message
Posted Oct 14, 2012@Tealk123
Looks like a Java filesystem problem. Are there no other errors indicated? Is your server overloaded? What happens if you restart your server and run the Trim again?
-
View User Profile
-
Send Message
Posted Oct 14, 2012a bug if i trim the map
23:01:38 [INFO] WorldBorder map trimming task started.
23:01:57 [WARNING] [Server] The main thread failed to respond after 10 seconds
23:01:57 [WARNING] [Server] Probable Plugin cause: 'WorldBorder'
23:01:57 [WARNING] [Server] What follows is the stack trace of the main thread
23:01:57 [WARNING] [Server] at java.io.RandomAccessFile.write(Native Method)
23:01:57 [WARNING] [Server] at java.io.RandomAccessFile.writeInt(Unknown Source)
23:01:57 [WARNING] [Server] at com.wimbli.WorldBorder.WorldTrimTask.wipeChunks(WorldTrimTask.java:286)
23:01:57 [WARNING] [Server] at com.wimbli.WorldBorder.WorldTrimTask.run(WorldTrimTask.java:149)
23:01:57 [WARNING] [Server] at org.bukkit.craftbukkit.scheduler.CraftTask.run(CraftTask.java:52)
-
View User Profile
-
Send Message
Posted Oct 14, 2012Idea that can be really great : Improve the border and teleport the player to the opposite border when he touch it. Like if the world was a sphere : If you travel to the South Border, you will be teleported to the North one. Of course, let the admin to choose that in the config.
-
View User Profile
-
Send Message
Posted Oct 13, 2012@RogerMaxson
/wb dynmap off
Might also need to do something to refresh Dynmap to clear out old cached border info, not sure what offhand though.
-
View User Profile
-
Send Message
Posted Oct 13, 2012how to hide the edge on DYNMAP?
-
View User Profile
-
Send Message
Posted Oct 12, 2012The new update of Bukkit seems like it broke some parts of this plugins. Mainly the /wb fill. It isn't filling in all of the chunks
-
View User Profile
-
Send Message
Posted Oct 11, 2012Just use world guard if u want that..