BuilderTools

✔️ Advanced World Editor commands

✔️ Using Sub Chunk Iterator to make updating world faster

✔️ Supports 4 different types of schematics

✔️ Asynchronous Minecraft: Java Version maps world fixer

✔️ Supports latest PocketMine API version

💬 FAQ

Required extension Core has an incompatible version (* not >= 8.0)

Your server is using outdated PHP version. If you host your server by yourself, update your php binaries More information. If you are using some host provider, contact them to update their php version.

Out of memory (allocated ******) (tried to allocate ****** bytes) OR Allowed memory size exhausted

Your server needs more memory for this action. To avoid this issue, you should disable memory limits in pocketmine.yml (by setting both main-hard-limit and async-worker-hard-limit to 0). After that, enable clipboard-compression in config.yml

Plugin crashes when I do ...

In this case, submit issue on github. Make sure you used pre-formatted document and filled all the information. Only then, the problem can begin to be solved.

🏠 BuilderTools commands

All BuilderTools commands starts with //except for the /buildertools command that was added as an alias because //help not works in newer versions.
In game, you can get list of all commands using commands //commands

Commands

Command Description

//commands

Displays list BuilderTools commands

Alias: //commands, /buildertools Usage: //commands <page: 1-4>

//biome

Changes biome in selected area

Usage: //biome list OR //biome

//blockinfo

Switch block info mode

Usage: //blockinfo Alias: //bi

In blockinfo mode you can get information about block by touching it.

//clearinventory

Clears inventory

Usage: //clearinventory Alias: //ci

//center

Finds center of the selection

Usage: //center

Bedrock will appear in the middle of the selection

//copy

Copy selected area into the clipboard

Usage: //copy

Copied area can be placed again using //paste, merged with the environment //merge or rotated //rotate.

//cube

Creates cube

Usage: //cube id1:dmg1,id2,...

Creates a cube at your position.

//cut

Cuts out selected area

Usage: //cube id1:dmg1,id2,...

The are is afterwards moved on to clipboard.

//cylinder

Creates cylinder

Usage: //cube id1:dmg1,id2,...

Creates a cylinder at your position.

//draw

Draws with blocks

Usage: `//draw <cube

//fill

Fill selected area

Aliases: //set, //change Usage: //fill id1:dmg1,id2,...

First you must create area using //pos1, //pos2 or by //wand.

//fix

Fixes block in world from Minecraft: Java Edition

Usage: //fix

//flip

Flips selection

Usage //flip x OR //flip y OR //flip z

The argument represents axis to flip the selection through.

//hcube

Creates hollow cube

Usage: //hcube id1:dmg1,id2,...

Creates hollow cube at your position.

//hcylinder

Creates hollow cylinder

Usage: //hcyl id1:dmg1,id2,...

Creates hollow cylinder at your position.

//hpyramid

Creates hollow pyramid

Usage: //hpyramid id1:dmg1,id2,...

Creates hollow pyramid at your position.

//hsphere

Creates hollow sphere

Usage: //hsphere id1:dmg1,id2,...

Creates hollow sphere at your position.

//id

Displays id of item in your hand

Usage: //id

//merge

Merge copied area

Usage: //merge

//move

Move blocks in selection

Usage: //move

Move blocks in selected area.

//naturalize

Replaces blocks in selected area to grass,dirt and stone

Usage: //naturalize

//outline

Fills hollow selected area

Usage: //outline id1:dmg1,id2,...

Changes the all the outer layers.

//paste

Paste copied area

Usage: //paste

//pos1

Select first position

Aliases: //1, //pos1 Usage: //pos1

You need select two positions for eg. filling or fixing Minecraft: Java Edition maps.

//pos2

Select second position

Aliases: //2, //pos2 Usage: //pos2

You need select two positions for eg. filling or fixing Minecraft: Java Edition maps.

//pyramid

Creates pyramid

Usage: //pyramid id1:dmg1,id2,...

Creates pyramid in your position.

//redo

Re-do BuilderTools action

Usage: //redo

//replace

Replace blocks in selected area

Usage: //replace <blocksToReplace: id1,id2> <blocks: id1:dmg1,id2,...>

Replace blocks in selected area. First you must create area using //pos1, //pos2 or by //wand.

//rotate

Rotate copied area

Usage: //rotate [x] [z]

Y, X or Z is axis you can rotate object around. Use degrees as unit. Example: //rotate 90

//schematic

Manage with schematics

Usage: //schem [filename]

Manage with schematics (reload - loads all schematics to memory; load - loads schematics for //schem paste; list - displays list of loaded schematics.

//sphere

Creates sphere

Usage: //sphere id1:dmg1,id2,...

Creates a sphere in your position.

//stack

Stacks copied area

Usage: `//stack [side

//tree

Spawns tree

Usage: //tree

There are implemented only basic trees (oak, spruce, jungle and birch)

//undo

Cancels BuilderTools action

Usage: //undo

//walls

Makes walls around selection

Usage: //walls

//wand

Switch wand tool

Usage: //wand

First position is set by breaking the block, second by touching the block. Wand tool can be turned of typing //wand again.

🛠️ Other features:

📜 Schematics

You can save your selection to a file and then load it again
BuilderTools supports loading MCEdit and MCStructure formats and creating schematics wth MCEdit format.
Schematics are loaded asynchronously, that means it won't lag server while loading.

Loading schematics:

Move schematic file to /plugin_data/BuilderTools/schematics directory
Load schematic using //schem load
Paste into the world using //schem paste

Creating schematics:

Select two positions using //pos1 & //pos2 commands or using wand axe.
Use //schem create
File will be saved in directory /plugin_data/BuilderTools/schematics/schematicName.schematic

🌎 Fixing Java: Edition worlds

BuilderTools is able to fix block ids in worlds generated by Minecraft: Java Edition.
Currently, we support only Anvil world format
To fix a world use //fix
Worlds are fixed asynchronously, so the process will not freeze server. Players are able to play while fixing world, but are not able to join the world, which is being fixed.

📃 Permissions

All BuilderTools Permissions:

Permission Command Operator Permissions required

buildertools.command.help //commands ✔️

buildertools.command.biome //biome ✔️

buildertools.command.blockinfo //blockinfo ✔️

buildertools.command.clearinventory //clearinventory ✔️

buildertools.command.copy //copy ✔️

buildertools.command.cube //cube ✔️

buildertools.command.cut //cut ✔️

buildertools.command.cylinder //cylinder ✔️

buildertools.command.decoration //decoration ✔️

buildertools.command.draw //draw ✔️

buildertools.command.fill //fill ✔️

buildertools.command.fix //fix ✔️

buildertools.command.hcube //hcube ✔️

buildertools.command.hcylinder //hcylinder ✔️

buildertools.command.hpyramid //hpyramid ✔️

buildertools.command.hsphere //hsphere ✔️

buildertools.command.id //id ✔️

buildertools.command.merge //merge ✔️

buildertools.command.move //move ✔️

buildertools.command.naturalize //naturalize ✔️

buildertools.command.outline //outline ✔️

buildertools.command.paste //paste ✔️

buildertools.command.pos1 //pos1 ✔️

buildertools.command.pos2 //pos2 ✔️

buildertools.command.pyramid //pyramid ✔️

buildertools.command.rotate //rotate ✔️

buildertools.command.schematic //schematic ✔️

buildertools.command.sphere //sphere ✔️

buildertools.command.stack //stack ✔️

buildertools.command.tree //tree ✔️

buildertools.command.undo //undo ✔️

buildertools.command.walls //walls ✔️

buildertools.command.wand //wand ✔️

🔧 Configuration

New in 1.2
Default configuration:

BuilderTools configuration file

Target BuilderTools version: 1.3.0-beta1

Do not change this line.

config-version: 1.3.0.0

This is format which will be used for creating schematics

Supported formats: 'mcedit', 'mcstructure', 'buildertools'

output-schematics-format: 'mcedit'

Option for compressing clipboards. This will make the actions

slower, but reduces RAM usage.

clipboard-compression: false

Some shapes are generated with duplicate blocks. This problem causes

some blocks are not reverted right when doing //undo. This option

is for removing duplicates.

Warning: This action takes around 98% time of the whole process!

remove-duplicate-blocks: true

BuilderTools saves player's clipboard, undo & redo stuff when player

leaves server to disk. This cache should be cleaned after restart (to

avoid unexpected bugs). This option is to disable removing those files.

clean-cache: true

When player leaves the server, player's session is saved, even if player did not

do any action with BuilderTools. If you enable this, player's sessions will not

be saved and when player joins the server again, his clipboard data will be lost

This option is good when BuilderTools is only used as api plugin on server with

high amount of players.

discard-sessions: false

PowerItems settings:

When disabled, //wand command still works, but instead of wand axe is hand

going to be the 'wand tool'

wand-axe: enabled: true name: "§r§fWand Axe\n§7§oBreak for first pos\n§7§oTouch for second pos"

blockinfo-stick: enabled: false name: "§r§fDebug Stick\n§7§oTouch block for info" ...

💰 Credits

Icon made by Freepik from www.flaticon.com is licensed by CC 3.0 BY
Seabuild spawn built by CryptoKey

💡 License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Full license here.