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 Sep 2, 2012@juloo65
Not true, Worldborder is extremely lightweight with the border monitoring routine. Pretty much any other plugin you can name is more resource intensive. Look elsewhere for a scapegoat.
-
View User Profile
-
Send Message
Posted Sep 2, 2012cause many lags when more than 30 players are connected !
-
View User Profile
-
Send Message
Posted Sep 1, 2012Hello :) Is there a way to make that when a player reach the border, he is teleported to the opposite of the map, same as if he make a turn on the world, as if the map is a globe ? A feature like it could be fun ;)
-
View User Profile
-
Send Message
Posted Aug 29, 2012@ShakyTom
When counting chunks as it trims them it doesn't currently differentiate between existing and non-existent chunks; it just goes by the number of chunks available in the region file which are outside the border. I'd considered reworking it so that it can give a more accurate accounting of only the chunks which are actually trimmed, but I just don't have time for it.
What tool are you using to create the map?
-
View User Profile
-
Send Message
Posted Aug 29, 2012@Brettflan
The map is about 3GB in size so I will see what I can do. There are no errors when it does the trim.
I have noticed that I can do a trim, then restart the server and do another trim and it will trim almost exactly the same number of chunks each time.
-
View User Profile
-
Send Message
Posted Aug 29, 2012@Pr07o7yp3
Last I checked each world region file maxes out usually at a bit over 5 MB, and a region is 512x512 blocks (32x32 chunks). The size might have gone up since I checked and with heavy modification of a region it might need more data than that, so to be on the safe side you might figure ~ 6 MB per 512x512 block region (262144 blocks total). As before, I'll let you do the math from there.
@ShakyTom
If so, you should have received an error in your server log/console during the Trim process. I've already covered that and the other possibilities in my last response to you.
If you're telling me none of those is the case, you'll need to provide me with a lot more information (and possibly a copy of the world so I can take a look myself).
-
View User Profile
-
Send Message
Posted Aug 29, 2012@Brettflan
Rendered the map on an entirely different computer after running the trim command. The detached chunks still exist.
-
View User Profile
-
Send Message
Posted Aug 29, 2012No, I mean in GB :D Because my SSD is only 60 GB and I have 3 worlds. World 1: 25000 radius World 2: 20000 radius World 3: 15000 radius
Btw: round-border: false
I want to fill them to remove lag when my players expore the world.
-
View User Profile
-
Send Message
Posted Aug 29, 2012@Pr07o7yp3
Radius 20000 = 40000 x 40000 block area for square border. A bit less for round border, of course (search "calculate area of circle given radius" or similar in Google). Chunks are 16 x 16 blocks. I'll leave it to you to figure it out from there.
-
View User Profile
-
Send Message
Posted Aug 29, 2012What would roughly be the size of a world with radius 20000? Because I think to use fill command to fill all chunks of the world.
-
View User Profile
-
Send Message
Posted Aug 29, 2012@QweSteR2221
You would need to provide a bit more information than that. Are you trying to use custom world generators? IIRC you need to specify those in bukkit.yml for Bukkit and by extension WorldBorder's Fill process to know which world generator to use on a given world.
If that's not your problem, again, more info would be needed as to what problem you're actually having.
@diannetea
Partial fill? Not as such, though you can simply set the border to a smaller radius temporarily and run the Fill command, then increase the border radius again afterward.
@alexander_gq
I doubt it. If you're getting a bluescreen in Windows, that generally indicates hardware or driver problems.
-
View User Profile
-
Send Message
Posted Aug 28, 2012Is there any way for the fill command to survive a bluescreen? I've been trying to get through a 12,000 radius fill by doing about 1,000 blocks at a time then moving the border. Any bluescreen corrupts the world completely ("not in GZIP format" error).
-
View User Profile
-
Send Message
Posted Aug 28, 2012lol 2.5 is a dev build, wait until they release it and then complain.
Is there a way to do a partial fill? Or would I have to babysit it and then cancel when the parts I want generated are done
-
View User Profile
-
Send Message
Posted Aug 28, 2012Not work from Multiverse-Core v2.5
-
View User Profile
-
Send Message
Posted Aug 28, 2012@ShakyTom
Then I'd guess that whatever map renderer you are using is presumably caching the data and you need to clear its cache.
I've already explained that the Trim command goes through the actual region files and covers every single chunk ever generated for the world. If chunks were left behind, you would have a nice error message in your server log/console explaining that a region file could not be deleted. If no such message showed up when you ran the Trim process, it will have succeeded and the cause of your problem is with whatever you are using to render the map.
-
View User Profile
-
Send Message
Posted Aug 28, 2012I am not using DynMap, I just use one of those map renderers to view everything.
The rogue chunks are still there after a trim, just no longer connected to the world.
-
View User Profile
-
Send Message
Posted Aug 27, 2012@ShakyTom
The Trim command runs on every region file in your world, so it gives full coverage of everything.
Are you using DynMap? If so, shut down and restart your server to clear its memory cache, then run a fullrender in DynMap. If you're still seeing those errant chunks, clear your browser (IE, Chrome, Firefox, whatever) cache.
-
View User Profile
-
Send Message
Posted Aug 27, 2012Hi there.
I have a circular world that has insanely long branches of chunks coming off it.
I tried using the worldborder trim command, however it only trimmed the chunks close to the actual border and left the rest.
Any chance of a fix?
-
View User Profile
-
Send Message
Posted Aug 24, 2012@LordChaos2
Is your server log truncated? I would need the full stack trace from that for it to make any sense. The shortened error message you've posted doesn't have any stack trace provided, so there's no telling what might cause it or even whether it's WorldBorder at fault (unlikely).
Also, certain newer releases of CraftBukkit seem to have occasional random errors like that one, which is much more likely the cause of your error.
People having problems with the trim command, please read this post and provide the requested information:
http://dev.bukkit.org/server-mods/worldborder/tickets/25-trim-errors/#c4
Since I can't reproduce it and most people don't encounter it, I would need as much information on your setup and the circumstances of the error as you can provide.
-
View User Profile
-
Send Message
Posted Aug 24, 2012I get these with even just WorldBorder being the only plugin running. :(