WorldBorder

Table of Contents

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.

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:
Before and After Fill Before and After Trim

Borders are also displayed automatically by default in DynMap if you have it:

Comments

Brettflan
- Join Date: 5/19/2011
- Posts: 1,457
- Member Details
#1575 Brettflan

View User Profile

Send Message

Posted Apr 22, 2014
@Mal2ksc

Portals that would go outside the border in the overworld are already redirected to be just inside the border, by default.

@sovredcat

The Fill process is largely limited by how fast CraftBukkit/Minecraft itself can generate the chunks, and can be even more limited depending on how much added work your world generator plugins require.

@Kubixster

A chunk is either generated or not, whether it's a player who generated it or anything else such as the WorldBorder's Fill. So based on what I think you're asking, the answer is no.

Rollback Post to Revision RollBack
Forge_User_36145254
- Join Date: 3/11/2012
- Posts: 685
- Member Details
#1574 Forge_User_36145254

View User Profile

Send Message

Posted Apr 22, 2014
@sovredcat

Try fill 100 64 or so. Do you check for how much memory is left when it slows down?

Rollback Post to Revision RollBack
_ForgeUser8472580
- Join Date: 2/23/2012
- Posts: 17
- Member Details
#1573 _ForgeUser8472580

View User Profile

Send Message

Posted Apr 22, 2014
Can I fill unexplored chunks inside the border without changing explored chunks?

Rollback Post to Revision RollBack
_ForgeUser10415254
- Join Date: 1/19/2013
- Posts: 20
- Member Details
#1572 _ForgeUser10415254

View User Profile

Send Message

Posted Apr 22, 2014
Okay I will try that and report back thanks.

edit @fungreenfox that does not work at all.

Last edited by _ForgeUser10415254: Apr 22, 2014

Rollback Post to Revision RollBack
Forge_User_36145254
- Join Date: 3/11/2012
- Posts: 685
- Member Details
#1571 Forge_User_36145254

View User Profile

Send Message

Posted Apr 22, 2014
@sovredcat

I have 48GB ram, and have somehow the same issue. One problem here, is the Java itself, not clearing up the used garbage from memory in time. Therefor, the plugin stops and waits until that amount is cleared, set in config to be max use. (setting for max memory left in order to proceed with task). It also depends on depth of the world, for example subterranea generator can make worlds at 200 block depth. In this case, i had to make use of wb fill 10 64 (64 if you have 64bit). Going higher here, makes use of memory to fast and will cause the plugin to halt now and then, while waiting for free mem. With normal world, try a lower parameter like wb world fill 20 64 and see if it works.

Last edited by Forge_User_36145254: Apr 22, 2014

Rollback Post to Revision RollBack
_ForgeUser10415254
- Join Date: 1/19/2013
- Posts: 20
- Member Details
#1570 _ForgeUser10415254

View User Profile

Send Message

Posted Apr 22, 2014
This plugin is awesome and will save me so much trouble when I open my server. My only issue with it is that is seems really slow. Instead of the default fill of 20 I've set it to a 1000.

First it goes, 500, 300, 700, 900, 600 etc but after a while it seemed to have slown down a lot with it only going up to about 90 chunks / second. I'm not sure what is up with that, the CPU/RAM on the server is sufficient enough (E3-1225 V2 @ 3.20GHz and 16GB of ram) but it's only using 5% cpu.

Is there anything I can do to make it faster?

Rollback Post to Revision RollBack
_ForgeUser10439105
- Join Date: 1/23/2013
- Posts: 60
- Member Details
#1569 _ForgeUser10439105

View User Profile

Send Message

Posted Apr 22, 2014
@Brettflan

It seems to me that if you can create a fake wall around a world, you could also fill up the space from y=128 to y=255 in the nether the same way. If it's full of bedrock, nobody's going up there.

Also it'd be nifty if people could be prevented from creating portals in the nether that would take them out of bounds in the overworld, without otherwise restricting them from exploring/mining that part of the Nether.

Last edited by _ForgeUser10439105: Apr 22, 2014

Rollback Post to Revision RollBack
Brettflan
- Join Date: 5/19/2011
- Posts: 1,457
- Member Details
#1568 Brettflan

View User Profile

Send Message

Posted Apr 20, 2014
@AS1LV3RN1NJA

I'll check into it as another feature, though I wish CraftBukkit/Minecraft would finally properly address nether world height limits.

Rollback Post to Revision RollBack
_ForgeUser7463849
- Join Date: 8/29/2011
- Posts: 244
- Member Details
#1567 _ForgeUser7463849

View User Profile

Send Message

Posted Apr 20, 2014
Please could you add a check for players trying to go above the nether? They mainly use enderpearls I think.

Rollback Post to Revision RollBack
_ForgeUser11206854
- Join Date: 5/6/2013
- Posts: 3
- Member Details
#1566 _ForgeUser11206854

View User Profile

Send Message

Posted Apr 19, 2014
@Brettflan

Thanks a lot :P

Rollback Post to Revision RollBack

Brettflan

Join Date: 5/19/2011
Posts: 1,457
Member Details

#1565 Posted Apr 19, 2014

@Eezjzbzbzb

import com.wimbli.WorldBorder.BorderData;
import com.wimbli.WorldBorder.Config;

// . . . . then . . . .

// target Location would go here
Location loc = yourLocation;

BorderData border = Config.Border(loc.getWorld().getName());
// make sure border is set (null = no border), then see if Location outside border
if (border != null && !border.insideBorder(loc))
{
	// there's a border for the world, and the location is outside of it
}

_ForgeUser11206854
- Join Date: 5/6/2013
- Posts: 3
- Member Details
#1564 _ForgeUser11206854

View User Profile

Send Message

Posted Apr 19, 2014
Hey, is there a way to check with my own plugin if a location is inside the border?

Rollback Post to Revision RollBack
Brettflan
- Join Date: 5/19/2011
- Posts: 1,457
- Member Details
#1563 Brettflan

View User Profile

Send Message

Posted Apr 17, 2014
@dela09

That's already on the list of things I'd like to do if/when I have time for it, though it would be a pseudo-wall sent to players (real enough for them) which wouldn't actually exist in the world data stored on your server.

Rollback Post to Revision RollBack
Forge_User_31771850
- Join Date: 3/17/2012
- Posts: 60
- Member Details
#1562 Forge_User_31771850

View User Profile

Send Message

Posted Apr 17, 2014
could you make an Option to create an 'end of this world'-wall? may the blocks for this wall could be choosen in the config. greetings dela09

Rollback Post to Revision RollBack
Brettflan
- Join Date: 5/19/2011
- Posts: 1,457
- Member Details
#1561 Brettflan

View User Profile

Send Message

Posted Apr 8, 2014
@CodeCreations

It's in the "Recent Files" list on the right side of this page, and on the list of files accessible by the "Files" tab at the top of the page.

Rollback Post to Revision RollBack
_ForgeUser14043196
- Join Date: 4/8/2014
- Posts: 4
- Member Details
#1560 _ForgeUser14043196

View User Profile

Send Message

Posted Apr 8, 2014
thanks for the instant reply. im running 1.7.8 which i got of this page. how would i go about getting 1.7.9? cause as of right now typing /wb help fill just try's to initiate a fill on the world "help"

Rollback Post to Revision RollBack
Brettflan
- Join Date: 5/19/2011
- Posts: 1,457
- Member Details
#1559 Brettflan

View User Profile

Send Message

Posted Apr 8, 2014
@CodeCreations

You can specify a higher frequency than default if you have the hardware to handle it and don't mind the lag it might cause in-game players.

The command documentation is linked above, or you can also use /wb help fill in-game if you're running version 1.7.9.

Rollback Post to Revision RollBack
_ForgeUser14043196
- Join Date: 4/8/2014
- Posts: 4
- Member Details
#1558 _ForgeUser14043196

View User Profile

Send Message

Posted Apr 7, 2014
Is there anyway to speed up the fill process? I help run a server that has dedicated and professionally maintained hardware and doesn't flinch whatsoever when I set the fill process on. But its taking forever to reach the desired border size (by my calculations around 200 days). Is there a way to increase the amount of chunks processed or are we stuck? thank you.

Rollback Post to Revision RollBack
Brettflan
- Join Date: 5/19/2011
- Posts: 1,457
- Member Details
#1557 Brettflan

View User Profile

Send Message

Posted Apr 6, 2014
@_elements

If you're using version 1.7.8 or newer, that shouldn't be the case. Use /wb denypearl on to be sure, though it does default to being enabled.

@FallenWarrior03

It does work, assuming you have version 1.7.7 or newer. /wb fillautosave <number_of_seconds>. The default is 30 seconds, and 0 would disable autosaving completely (generally a bad idea, but up to you). If you currently have it happen every 5 minutes, that would of course be 300 seconds.

Rollback Post to Revision RollBack
_ForgeUser9404855
- Join Date: 8/14/2012
- Posts: 19
- Member Details
#1556 _ForgeUser9404855

View User Profile

Send Message

Posted Apr 5, 2014
does the command /wb fillautosave not work. I am doing a fill and it is saving like every 5 mins. I understand it needs to save but it is lagging everyone out of my server. I need to bump it up a little

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

31650
Created

Aug 30, 2011
Last Released File

May 4, 2017
Total Downloads

1,167,016
License

BSD License

Bukkit

WorldBorder

Bukkit Plugins

WorldBorder

Table of Contents

Comments

About This Project

Categories

Members

Recent Files

Bukkit