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

Forge_User_50532341
- Join Date: 9/17/2011
- Posts: 9
- Member Details
#265 Forge_User_50532341

View User Profile

Send Message

Posted May 29, 2012
great plugin ;)

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

View User Profile

Send Message

Posted May 27, 2012
@kozzy68

The trim process by default leaves a buffer of chunks (padding if you like) outside the border since they would otherwise need to be regenerated when someone neared the border as they're in viewing distance. I expect that's what you're seeing, then. See the info above for more on that, and if you want those chunks deleted as well you can specify 0 padding when you run the trim command.

Rollback Post to Revision RollBack
_ForgeUser8102634
- Join Date: 12/18/2011
- Posts: 136
- Member Details
#263 _ForgeUser8102634

View User Profile

Send Message

Posted May 27, 2012
Im not using dynamap.or Maping software to see if trim workd but when I see hauses far outside of borders it means those chunks were not deleted obviously. I like to delete all chuncks outside border even those modified with hauses or roads.... (some chunks got deleted however but not all).

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

View User Profile

Send Message

Posted May 26, 2012
@darkcloud784

Based on where it seems to be stopping I would almost think it's due to Java hitting the file handle limit, but WorldBorder itself doesn't leave file handles open after it's through with them, and I think you would normally get an error indicating the file handle limit had been exceeded.

So... sorry, but without more useful info from Java I have no idea why it's not working on your server. That's definitely not normal behavior.

Rollback Post to Revision RollBack
darkcloud784
- Location: Omaha
- Join Date: 5/17/2008
- Posts: 415
- Member Details
#261 darkcloud784

View User Profile

Send Message

Posted May 26, 2012
@Brettflan

No server just stopped responding then rebooted. That stacktrace was captured by craftbukkit + +. I also tried it on craftbukkit but it doesn't print out anything, just hangs then restarts due to server not responding.

This only happens when using the trim command, otherwise the server runs excellent with your plugin.

Last edited by darkcloud784: May 26, 2012

Rollback Post to Revision RollBack

Brettflan

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

#260 Posted May 26, 2012

@darkcloud784

There doesn't appear to be any useful crash info there that I can see. I see you're using CraftBukkit++.
This is the relevant thread of what WorldBorder was doing at the time:

2012-05-26 05:42:54 [SEVERE] Current Thread: Server thread
2012-05-26 05:42:54 [SEVERE]     PID: 12 | Alive: true | State: RUNNABLE
2012-05-26 05:42:54 [SEVERE]     Stack:
2012-05-26 05:42:54 [SEVERE]         java.io.RandomAccessFile.write(Native Method)
2012-05-26 05:42:54 [SEVERE]         java.io.RandomAccessFile.writeInt(Unknown Source)
2012-05-26 05:42:54 [SEVERE]         com.wimbli.WorldBorder.WorldTrimTask.wipeChunks(WorldTrimTask.java:286)
2012-05-26 05:42:54 [SEVERE]         com.wimbli.WorldBorder.WorldTrimTask.run(WorldTrimTask.java:149)
2012-05-26 05:42:54 [SEVERE]         org.bukkit.craftbukkit.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:126)
2012-05-26 05:42:54 [SEVERE]         net.minecraft.server.MinecraftServer.w(MinecraftServer.java:588)
2012-05-26 05:42:54 [SEVERE]         net.minecraft.server.MinecraftServer.run(MinecraftServer.java:506)
2012-05-26 05:42:54 [SEVERE]         net.minecraft.server.ThreadServerApplication.run(SourceFile:492)

Based on the stack trace it was in the middle of writing to the world region files to remove the extraneous chunks. No actual errors are indicated there though, it's just showing where the process was when the server stopped.
Was an actual error reported just before that dump which you pasted?

@kozzy68

What are you using to determine whether the chunks are deleted? DynMap? If so, I'll copy-paste the note which is just up the page a bit here:

NOTE: If you are using the DynMap plugin and use our "trim" command, you will need to restart your server afterwards and then run a "fullrender" in DynMap to properly update their map display.

If you're using some other mapping tool which caches map info, you will probably need to clear its cache to have the displayed map updated.

_ForgeUser8102634
- Join Date: 12/18/2011
- Posts: 136
- Member Details
#259 _ForgeUser8102634

View User Profile

Send Message

Posted May 26, 2012
Hi, trim does not seems to work right. I like to use it to regenerate old ugly map and keep only small area in center but after trim process finished it seems it did not deleted majority of chunks.

Rollback Post to Revision RollBack
darkcloud784
- Location: Omaha
- Join Date: 5/17/2008
- Posts: 415
- Member Details
#258 darkcloud784

View User Profile

Send Message

Posted May 25, 2012
The command trim seems to crash our server. Here's a full tread stacktrace, http://pastebin.com/SgwBb93f

Rollback Post to Revision RollBack
hawkfalcon
- Location: Reno
- Join Date: 12/17/2011
- Posts: 521
- Member Details
#257 hawkfalcon

View User Profile

Send Message

Posted May 24, 2012
@Brettflan

Oh ;p thank you I am blind!
It has nothing to do with borders though xD Just preventing people from going places ;0

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

View User Profile

Send Message

Posted May 24, 2012
@hawkfalcon

So for your own plugin you're wanting to know how to implement the main functionality of this plugin? The source for this plugin is available and linked at the top of the page here. Feel free to browse through it.

Rollback Post to Revision RollBack
hawkfalcon
- Location: Reno
- Join Date: 12/17/2011
- Posts: 521
- Member Details
#255 hawkfalcon

View User Profile

Send Message

Posted May 23, 2012
@Patolord This is what I was asking.
For my own plugin, what is the code that sets an invisible barrier that prevents people from going past the set limit? I can't figure out how to do this. Thanks!

Last edited by hawkfalcon: May 23, 2012

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

View User Profile

Send Message

Posted May 23, 2012
@tiffables

If you just set the border, it won't have destroyed anything. It will have just made it inaccessible. Just change the border size.

If however you actually trimmed the world so that some areas were indeed deleted, that can't be recovered. The world can of course be filled out to have those areas just like they were before anyone built or dug into them.

Rollback Post to Revision RollBack
_ForgeUser7740136
- Join Date: 10/21/2011
- Posts: 3
- Member Details
#253 _ForgeUser7740136

View User Profile

Send Message

Posted May 23, 2012
quick question, we changed our border from square to round, and it destroyed parts of buildings and in some cases entire buildings which were in the corners of the map. doesn't seem likely, but is there any way to revert this or undo the command? thanks!

Rollback Post to Revision RollBack
_ForgeUser8291187
- Join Date: 1/21/2012
- Posts: 27
- Member Details
#252 _ForgeUser8291187

View User Profile

Send Message

Posted May 22, 2012
@Brettflan

I will check the things again, make some tests and will notify you on the results.

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

View User Profile

Send Message

Posted May 22, 2012
@MrSerios

That's a new one on me. I never had that problem on my own server.

Rollback Post to Revision RollBack
_ForgeUser8291187
- Join Date: 1/21/2012
- Posts: 27
- Member Details
#250 _ForgeUser8291187

View User Profile

Send Message

Posted May 21, 2012
I don't want to be rude, but using your plugin causing bukkit to eat up all allocated ram til server crash, nice and slowly! Can you take a look on this issue. Although it is very good and useful plugin, i can't use it, because crashing my server every 2-3 hours. I use nolagg to test it, and when disable worldborder server start to behave correctly again and free up unused memmory

Rollback Post to Revision RollBack
Patolord
- Join Date: 4/25/2011
- Posts: 54
- Member Details
#249 Patolord

View User Profile

Send Message

Posted May 20, 2012
He is probably asking what is the "code" that prevents people for trepassing the end of the map

The invisible Barrier That prevents them for going after the limit set by worldborder

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

View User Profile

Send Message

Posted May 16, 2012
@hawkfalcon

I don't understand your question.

Rollback Post to Revision RollBack
hawkfalcon
- Location: Reno
- Join Date: 12/17/2011
- Posts: 521
- Member Details
#247 hawkfalcon

View User Profile

Send Message

Posted May 15, 2012
What is the code to deflect people?;0

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

View User Profile

Send Message

Posted May 14, 2012
@Baba43

I've already said I'm no longer going to actively develop the plugin, only maintain it to keep working with newer Bukkit releases. See here:

http://dev.bukkit.org/server-mods/worldborder/?comment=239

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,165,860
License

BSD License

Bukkit

WorldBorder

Bukkit Plugins

WorldBorder

Table of Contents

Comments

About This Project

Categories

Members

Recent Files

Bukkit