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:
@huangzong
Here's a bit of basic API info:
https://dev.bukkit.org/bukkit-plugins/worldborder/pages/further-information/#w-api-integration
You can also monitor events for Fill and Trim starting and finishing under java.com.wimbli.WorldBorder.Events.
For what you're wanting though, you'd probably just need to build your own modified version of WorldBorder. The source is of course available on GitHub, linked above.
Nice plugin!!! Is there any API for develpment? I would like to add a function when player bump into the border,the console will use a command to him.
@Pedigru
It sounds like the custom map wasn't designed to fit the terrain output by the standard world generator for the world's seed.
There are plugins and mods which modify worldgen; perhaps one of those provides pure ocean or something similar, though I don't know for sure. WorldBorder uses the chunk loading / generation methods provided by Bukkit, so the world will generate accordingly.
I apologize for not reading the huge thread for the answer to my question. Perhaps someone would be kind enough to offer me what I'm looking for.
I wish to use a custom map which is not universally shaped. It is actually very hourglass shaped. Perhaps I used the wrong command but, I believe I filled the map to the border size I want to use...and doing this caused huge straight edged chunks of random world gen map inside the gaps between the custom map out to the world border edges.. So...thinking of an hourglass, we have a large north and south portion of custom map but at the middle at the sides of the oceans we have random world generated map. It looks very cut and pasted at the edges and I'm curious if there is a method to fill the missing chunks to the boarder with no world gen or at least just ocean based world gen?
@MR_Blocker
If all borders are cleared so that there are none set, WorldBorder obviously doesn't enforce any nonexistent borders. Look elsewhere for your problem.
As for being able to "see" the border, I assume you mean in some other tool such as DynMap? You may have a caching issue with DynMap or whatever you're "seeing" the border in; if WorldBorder's /wb list command indicates there are no borders set, then there are no borders set. Simple.
So an admin messed with wb and now when ppl do f home etc they "suffocate in wall" even though i have cleared all worldborders and wb list shows none. But i can still "see" where the worldborder is. Help please
@Space_m0nkey
Sorry, but WorldBorder is limited to one border per world.
You could use another plugin such as WorldGuard for multiple border restrictions per world, though that could have a performance impact on the server.
@Brettflan
Hello there!!! I em using the plugin for quite some time but i need now that i em not sure that even is possible and that is why i seek help. I was wondering if there is a way to make 2 borders in the same world.Why?I have the Spawn area (the area that is playable around 30K blocks) and the Shop area that is really fare from the Spawn area.They are separated from each other with a gap of like 100 000K blocks....I just wanted to make things on the server a bit different..The thing is that now that everything is set up it is not an option to move the Shop...It is wayyy to big (i imported it with MCEdit...u can imagine).And i have tried to make a second border around it bit its removing the 1st one...And now im kinda stuck cuz if i have the border around the playable area when the players goes /shop...it does not let them cuz of the border... So i was wondering is there a way to buypass this thing?Not like a permission thing, this way it is like having no WB... Is there a way to make it work ?Or im stuck with an open world? :/
@Beetrroot
You should try LaggRemover too, it might work for the thing that u need
@Beetrroot
That depends on what you mean. It generates the chunks which are then stored on disk and can later be quickly loaded from disk rather than having to be generated from scratch by the server. They're not "loaded forever" in memory though, as that would take up too far much memory for most servers; the server normally only keeps chunks loaded in memory based on which ones are needed.
Awesome plugin! I have a question, though. Does rendering out the world keep those chunks loaded forever? I couldn't find any other chunk-loading plugins that work.
@zhongshinan
Ah, sure, that's fine. Thanks for asking.
@Brettflan
http://www.mcbbs.net/thread-608265-1-1.html Look at this. Do you agree with me? I only convert English into Chinese.
@zhongshinan
I'm not sure what you're asking. If you want to use the plugin on a server, of course you can.
If you want to do something with the source code, that's fine too as long as you follow the BSD license which covers the source code. Basically you'd just need to include a mention of the original author of some of the code (me). Other than that, no restrictions.
@firie
This plugin doesn't directly support an automated border size increase. You'd need to do that through commands. You can use the list command to see what size each border is, or get a visual representation if you're using Dynmap.
Hello.I'm come from China.I want to take the WorldBorder in Chinese mcbbs. Can you agree with me?
hello can you help me how can i do that every day their is 20 block more without the slow ticks and if a player dies the border decrease ? and what command can you show the boarder thx :)
@Qballl
http://dev.bukkit.org/bukkit-plugins/worldborder/pages/further-information/#w-api-integration
@Dragon_12dk
What are you talking about? The only thing this plugin will delete are the parts of a world outside the border which you specify if you run the Trim command.
this plugin deletes everything :(
Is there any sort of api for devlopers?
Still cannot figure out what is killing it, I've been disabling plugins like crazy to find the solution and I am having no luck.
The messages are getting more consistent and starting to spam my console - http://pastebin.com/qu3ybYLL