BO3Tools 1.5

Home | Source | Commands and permissions | Changelog

BO3s are objects used by TerrainControl. BO3Tools allows you to export your WorldEdit selection as a BO3 object. It can also convert a BO2 object to a BO3 object.

Running Spigot 1.9 or 1.10? Download BO3Tools 1.5.

whitespace hack


  • Convert a WorldEdit selection to a BO3.
  • Lets you select the origin of the BO3.
  • Convert BO2s to BO3s.
  • Automatically sets the author of the BO3 to the name of the player who used the command.
  • Has size limits which make sure that the BO3 is never larger than 32x256x32.
  • Permissions support.
  • In-game, so no block lists that need to be updated.
  • Can export the contents of chests/dispensers/etc.
  • Can add BlockChecks to the BO3.
  • Doesn't directly use internal server code, so it doesn't need to be updated on every Minecraft update.

whitespace hack

Installation and configuration

Download the latest file from BukkitDev and place it in the plugins folder. Make sure that WorldEdit and Terrain Control are already installed. No worlds need to be assigned to Terrain Control if you don't need to export tile entities. There is no configuration file.

whitespace hack

Commands and permissions

bo3tools.all gives access to all the commands. Server operators automatically have this permission. You can export a BO3 using /exportbo3 <name>, which will convert your current WorldEdit selection to a BO3 and put it in Terrain Control's GlobalObjects folder. You can convert a loaded BO2 to a BO3 using /convertbo2 <name>.

See here for full commands and permissions.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Noumpas13 Noumpas13 Sep 04, 2016 at 22:10 UTC - 0 likes

    Its not compatible with terrain control 2.8.2 snapshot. it give you error when you try to export

  • Avatar of rutgerkok rutgerkok Jun 30, 2016 at 19:12 UTC - 0 likes

    @McPixel: Go

    It should be compatible, there's no need for an update.

  • Avatar of McPixel McPixel Jun 27, 2016 at 08:39 UTC - 0 likes

    @rutgerkok: Go

    not compatible with spigot 1.10 yet ? :(

  • Avatar of robotnikthingy robotnikthingy May 23, 2016 at 01:08 UTC - 0 likes

    @rutgerkok: Go

    Hi, I tried to export a bo3 with a spawner inside of it using includetileentities, and it gave me an internal error in the console


  • Avatar of rutgerkok rutgerkok Apr 23, 2016 at 19:14 UTC - 0 likes

    @McSaber: Go

    Set TerrainControl as the world generator for the world in the Bukkit.yml file. See TerrainControl's installation instructions on how to do this.

    @The_PC_Tech_Guy: Go

    Terrain population happens on a square of 2x2 chunks, which is 32x32 blocks. Any object larger than this (whether it's a BO2 or a BO3) simply won't spawn.

  • Avatar of The_PC_Tech_Guy The_PC_Tech_Guy Apr 23, 2016 at 07:52 UTC - 0 likes

    Do bo2's also have a 32x32 limit? Wiki for Terrain Control has no mention of limits for either object.

    This account is so old that I don't even use that username anymore.
    I now go by "robomwm"

  • Avatar of McSaber McSaber Apr 15, 2016 at 01:46 UTC - 0 likes

    So im using the latest version of this plugin and the latest version of Terrain Control. When i try and create a BO3 using the command /exportbo3 <name>  -- includeair -- includetileentities it displays this message: "Terrain Control needs to be enabled for this world to save tileentities." Do you have any idea how i could fix this? I really need the tile entities to work because i have yet to figure out any other method for terrain control and chests...

    Last edited Apr 15, 2016 by McSaber
  • Avatar of rutgerkok rutgerkok Mar 15, 2016 at 09:54 UTC - 0 likes

    @Monktress: Go

    Whether leaves decay is stored in the data value of the leaves. By default, BO3Tools converts all user-placed leaves blocks (which don't decay) to natural leaves blocks (which do decay). If you don't want this, use the following command to export your BO3s:

    /exportbo3 <name> --noleavesfix

  • Avatar of Monktress Monktress Mar 12, 2016 at 21:36 UTC - 0 likes

    So i have a puzzle at my hands. Im trying to figure out what is it in the bo3 files that make the leafs decay in game. the bo3s i have when they spawn in game and look at them with f3 say check_decay true and decayable false. So i have been trying to find in the bo3 file where i can change that.

    i dont want to have to redo all the bo3s i have. any help or guidance ?

  • Avatar of WrennAmethyst WrennAmethyst Sep 24, 2015 at 23:41 UTC - 0 likes

    I'm having a problem. I'm attempting to set the BO3 center towards the top of a pretty tall object, and I'm getting the message "The B03 center is too far away".


Date created
Mar 10, 2013
Last update
Mar 01, 2016
Development stage
BSD License
Curse link
Recent files



Required dependency
Terrain Control