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:
Comments
-
Brettflan Owner
-
View User Profile
-
Send Message
Posted Apr 1, 2013@Nemirisu
I don't see the WorldBorder border displayed on that DynMap map. You disabled that display?
As per the command notes though, if you're using DynMap, you might need to do a fullrender in DynMap for the world after running Fill, and you'll definitely without question need to restart your server completely and do a fullrender in DynMap after running a Trim in WorldBorder in order to make DynMap properly clear its cache.
-
View User Profile
-
Send Message
Posted Apr 1, 2013http://ubc.nitrado.net:8123/#
master ^^
Well as u readed the problem is still there
The Fill dont work and well the map looks a bit horrible
-
View User Profile
-
Send Message
Posted Apr 1, 2013@Nemirisu
Sorry, but don't post adfly links. I've deleted your post due to that. Feel free to repost with a normal link.
-
View User Profile
-
Send Message
Posted Apr 1, 2013@XeonG8
When you get that done, if it's showing parts of the map as still existing when they shouldn't, post the link for it.
EDIT: also post a list of the files in your world's region folder.
-
View User Profile
-
Send Message
Posted Apr 1, 2013"Do you not have a map of the world so you can visually see whether the world is properly trimmed"
I did, recently though the 800k tiles got deleted, and I want to get all the mca regions wiped that are outside that worlds new border radius.
I'm just going to render again with dynmap, however I know that worldborder trim has failed because its fairly obvious to see just from the file count in the regions folder and the file size, that it hasn't removed the mca files that are outside that border.
-
View User Profile
-
Send Message
Posted Apr 1, 2013Actually now that I've tested it myself on the latest dev build of CraftBukkit, I had no error when shutting down the server. The error you're getting is apparently due to JSONAPI (another plugin I presume?) based on your stack trace. Take it up with the author of that plugin.
-
View User Profile
-
Send Message
Posted Apr 1, 2013@Spezialeinheit
See my message right below yours.
-
View User Profile
-
Send Message
Posted Apr 1, 2013Hello Brettflan
I have the same Problem as andrewkm.
Since Build #2725: https://github.com/Bukkit/CraftBukkit/commit/052e955ed71a30516a5e9cfd76649daaba4ae7d8
When i stop the Server i get this Error: http://pastebin.com/RnfTVQAT
-
View User Profile
-
Send Message
Posted Apr 1, 2013@andrewkm
Strange, WorldBorder isn't registering a new task there, it's making sure the task is properly cancelled and ended. Silly Bukkit devs.
I'll look into it and add a fix. Good thing I hadn't yet made the next release, which should be coming up very soon now.
EDIT: actually, it seems to be triggering when WB is posting to the Minecraft log that it has stopped the border timer. Why that would be triggering their exception about registering a task... well, you'd need to ask them. I'll of course work around it regardless.
-
View User Profile
-
Send Message
Posted Apr 1, 2013@XeonG8
Earlier you said "0 entire regions". Is this a different world then?
So your border is 22000 blocks wide (radius 11000 from center), centered on x:2500 z:-2000. If you indeed really have a solid line of explored territory out 40000 blocks, you would be correct that it wouldn't make sense to only have 15 regions removed. That's unless you've previously run a Trim which already got rid of them or something.
Basically though, the thing is this: I know that the trim process works, and nobody else up to this point has run into a valid problem like what you're having, so that indicates the problem is almost certainly on your end rather than with the plugin.
Do you not have a map of the world so you can visually see whether the world is properly trimmed? That would be sensible. If you do, remember to clear its cache (or in DynMap fully restart the server and then run a fullrender on the world) to make sure that trimmed chunks and regions aren't falsely shown to still exist on the map.
-
View User Profile
-
Send Message
Posted Apr 1, 2013"World "kraftzone2_world" has border radius 11000 x:2500 z: -2000"
regions and explored area as far as 40000
and that's all that it trims.. seems broken to me
-
View User Profile
-
Send Message
Posted Apr 1, 2013Latest CB breaks this during stop command: http://pastie.org/7267629 Commit: https://github.com/Bukkit/CraftBukkit/commit/052e955ed71a30516a5e9cfd76649daaba4ae7d8
-
View User Profile
-
Send Message
Posted Mar 31, 2013@XeonG8
It does delete regions (512x512 block sections, thus 32x32 chunks) which are entirely outside the border. It will inform you if it fails to delete a region file, which can happen due to the file being locked.
For regions which have some chunks inside the border and some outside, the chunks are effectively wiped but you won't actually immediately recover the space used. A bit unfortunate, but no real choice based on how the region files are structured without just completely rearranging the entire region file. The amount of work needed to pull that off is far more than I'm interested in.
As for it being broken: it isn't.
If you want to discuss it further, post the output of /wb list, the exact trim command you used, and the log of the trim process. If you have a map available of the world it would be nice to have a link to see it as well.
-
View User Profile
-
Send Message
Posted Mar 31, 2013oh very much soo... it should have have removed at least 1gb worth of regions..
yet didn't remove much of anything, which is why i ask if its broken..
doesn't it delete the files that are not longer needed?
-
View User Profile
-
Send Message
Posted Mar 30, 2013@XeonG8
I highly doubt it. You specified a buffer zone of 1000 blocks radius beyond your border to leave untouched. Did you really have much more than that in the world beyond the border which you wanted trimmed off?
-
View User Profile
-
Send Message
Posted Mar 30, 2013so I did world trim, and it said "Trim 0 entire regions and 937 individual chunks trimmed so far(100% done)"
[time] task succesfully completed...
errrm there is a world border on the map of about 10000 and it should have wiped off a whole lot more than what it reported..
/wb myworld trim 2500 1000
is what i used.
so? bug?
-
View User Profile
-
Send Message
Posted Mar 29, 2013Burntapples i figured out the problem. Disable or take out all of ur plugins besides worldedit and vault. Then close all other applications besides ur server, then fill in the world. It took me 18 hours for a 9,100 border. Do prepare to leave ur pc for about a day.
-
View User Profile
-
Send Message
Posted Mar 29, 2013@burntapples
Looks to be a bug in CraftBukkit / NMS or whatever custom build of it you might be running.
-
View User Profile
-
Send Message
Posted Mar 29, 2013Hi, i'm getting an error about 38% of the way filling in chunks inside my border. After 1-2 minutes it crashes with this error. It seems pretty strange but I think it may have something to do with canceling a fill.
-
View User Profile
-
Send Message
Posted Mar 29, 2013@Brettflan
@Brettflan
Alright, thank you very much :D I was curious as too how that would end up so now i know its good to go xD also i know you have some info on this, but would it be wise to try to fill/trim in a radius of 10000-12500? and with default settings would that take days-weeks?