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 Jun 14, 2013@Wolf314151
It's not just this plugin, Minecraft itself never generates single blocks, only chunks. So it may indeed be something with dynmap.
-
View User Profile
-
Send Message
Posted Jun 14, 2013@Brettflan
Yes I know that's whats weird to me, I believe it is a problem with dynmaps though as they are blocks and your plugin deals with chunks (dynmap displays every block, and I believe whats happening is some are 'leftovers' that don't get removed from my map.
-
View User Profile
-
Send Message
Posted Jun 14, 2013@Wolf314151
Minecraft does not generate single blocks, it only generates in 16x16 (horizontal X/Z) chunks.
If WorldBorder and you are both unable to delete those regions, stop/restart your server. After they're gone you will of course need to do a fullrender in dynmap to make it register those chunks as no longer existing.
@rotiripsnoc
The wshape command does that. Refer to the link at the top of the page here covering commands and permissions, or refer to the in-game help.
-
View User Profile
-
Send Message
Posted Jun 12, 2013is it possible \ will it be possible to have each world's shape defined ? I'd like to have some round \ some square worlds.
-
View User Profile
-
Send Message
Posted Jun 12, 2013When I set a 250 radius border and fill it right after spawning in it for the first time. There are blocks (not chunks) loaded outside the circle randomly all over the place. So I try to trim it but it tells me "region file which is outside the border could not be deleted" and removing them manually in the regions folder causes them to regenerate later. I cannot seem to remove these chunks and its annoying how they appear in dynmap.
Ive tried making the regions folder not read only but it does that silly thing where after hitting apply and ok it turns back into read only again.
-
View User Profile
-
Send Message
Posted Jun 11, 2013@slimedog007
Trimming deletes chunks, yes.
Chunks are normally only loaded into memory when a player gets close to them, other than the chunks around the spawn point which are kept loaded.
-
View User Profile
-
Send Message
Posted Jun 10, 2013Hi, when I trim my world, does it delete the chunks? I don't want any of my players' buildings destroyed, but I dont want all of these chunks loaded at once.
-
View User Profile
-
Send Message
Posted Jun 7, 2013@Brettflan
gotta use MCPC+ instead of BukkitForge for FTB now, and it puts everything as dimensions instead of worlds...
-
View User Profile
-
Send Message
Posted Jun 5, 2013@Cattraknoff
Per-world bypasses? I'd rather not add to the overhead of checking whether a player beyond the border needs to be knocked back inside. Still, it wouldn't be much overhead, and not a huge amount of work to implement it... it could happen, but I don't really have the time or interest to do it. The source is available on GitHub if somebody else wants to give it a shot.
@pimsserver
I don't plan to add support for multiple borders per world, sorry. I also don't plan to have a permission which automatically allows the people with that permission beyond the border, as Ops and people with "*" permission are automatically granted all permissions. That's why I have the bypass method require a command.
-
View User Profile
-
Send Message
Posted Jun 4, 2013It would be nice to have different borders for different permissions groups (VIPs have a larger world).
And to have the option to name the borders (when clicking on the border on the dynmap)
-
View User Profile
-
Send Message
Posted Jun 4, 2013I would like the ability to add permanent bypasses on particular worlds.
-
View User Profile
-
Send Message
Posted Jun 3, 2013Useful! May use it!
Keep calm and carry on!
Dlljs.
-
View User Profile
-
Send Message
Posted Jun 2, 2013@MCLegendServer
What version of the plugin and what version of CraftBukkit are you running? Please post what's reported at server startup rather than guessing or assuming version numbers (please oh please don't just say "latest").
I ask because I checked back around 1.5.1-ish of CraftBukkit and riding pigs across the border was properly handled.
-
View User Profile
-
Send Message
Posted Jun 2, 2013You can get out of the map by using a pig with a saddle, you can go past the borders of the world, I have no complications other than the spamming that I reached the edge of the world, it doesnt teleport you back at all.
Can you fix this bug?
-
View User Profile
-
Send Message
Posted Jun 1, 2013@Glacksy
Twilight Forest is a mod which is not handled or interfaced at all through Bukkit, right? This being a Bukkit plugin, it can only interface with things Bukkit provides interfaces for.
-
View User Profile
-
Send Message
Posted Jun 1, 2013how can i get this to work on a set dimension? not a world.. im using the mod "twilight forest" which is in FTB, and i want a border there... but since its not "its own world" i cant seem to figure out how o.O
-
View User Profile
-
Send Message
Posted May 30, 2013@Talidorn
Sorry, the fill process doesn't force a check to make sand or gravel blocks fall, it just generates the chunks the same as if a player had traveled in range of them.
There may well be a plugin out there which does what you want, but I don't know of one offhand.
-
View User Profile
-
Send Message
Posted May 30, 2013Quick question/comment.
I have a FLAT world with the following config: 2;2x1,16x0,1,16x0,1,16x0,1,16x0,1,5x13;1;stronghold,biome_1,village,decoration,dungeon,lake,mineshaft,lava_lake
So, obviously there is a lot of gravel. I tried to use your fill section to do the generation. The issue that I see is that the generation must have happened but it didn't deal with (which I was hoping for) the initial gravel falling. I'm hoping that you might have a suggestion to help reduce the gravel lag on the map that is defined square with 5k borders from 0.0
Thanks for your time.
-
View User Profile
-
Send Message
Posted May 29, 2013@Synesthesy77
That error indicates those region files are currently locked by your OS (presumably in use), likely by the Minecraft server itself. You can try restarting the server to see if that unlocks the files and then run the trim again, or you can try to manually delete the indicated files yourself.
-
View User Profile
-
Send Message
Posted May 29, 2013I've got a problem with the trim function. When I use /wb trim (in the world I want to trim) an error occurs: "Region file wich is outside the border could not be deleted: (region name).mca"; repeated for each region file involved.