WorldEdit Guide
WorldEdit is a powerful open source in-game map editor mod (and plugin). Players can transform large areas of terrain with just a few commands. This article will explain the basics of WorldEdit along with tips, tricks, and other resources to get the most out of it.
Note: Many WorldEdit commands use a double forward slash (//) prefix. This is different from regular Minecraft commands that only have one (/).
The Basics
//wand
Adds a wooden axe (unless otherwise defined in the configuration file) to your inventory used for marking positions that form a region for edits to affect.
Making a Selection
Left-click a block to set your first position, and right-click to set your second.
WorldEdit selection confirmation messages.
The two positions create a cuboid shape.
Visualized cuboid region selection.
Alternatively, //pos1 and //pos2 can be used to select region points from your character’s leg’s current location.
//hpos1 & //hpos2
Selects respective region points to the block your character’s head is looking.
//hpos1
Patterns
WorldEdit patterns are the instructions for how WorldEdit should generate blocks based on the command.
Single Block
stone_bricks
Multiple Blocks
stone_bricks,oak_planks
Ratioed
The % signs do not need to equal 100% as they are cumulative and divided by the total. The following example has a 3:4 ratio.
30%stone_bricks,40%oak_planks
With Block States
Each block state must be inside brackets and indicated with a name and value.
stone_slab[type=top]
oak_stairs[facing=north,half=top]
With Random Block States
Each position will have a random block states for that block.
*oak_log
Clipboard
The contents of your clipboard.
#clipboard
and more!
Region Operations
With Patterns
//set <pattern>
Completely fills selected region with pattern.
//set stone_bricks
//replace <new pattern>
Replaces all blocks in a selected region to new pattern.
//replace grass_block
//replace <original pattern> <new pattern>
Replaces all original pattern blocks in a selected region with new pattern.
//replace grass_block stone_bricks
//replacenear <radius> <mask> <pattern>
Replaces mask pattern in a radius of the player with new pattern.
//replacenear 2 grass_block acacia_log
//center <pattern>
Creates pattern at center of selcted region. Will be 1 block if odd on all sides, 2 if odd on one and even on the other, and 4 if even on all sides. Commonly used for determining the center of a region in general.
//center diamond_block
//overlay <pattern>
Finds the highest blocks in a selected region and places pattern on top.
//overlay 10%gold_ore,10%diamond_ore,80%iron_ore
//walls <pattern>
Builds walls from the top to the bottom of the outer selected region.
//walls stone
//outline <pattern>
Builds a box made of the pattern on the outer selected region.
//outline stone
Lines and Curves
//line <pattern> [thickness]
Creates a line from pos1 to pos2 when using //sel cuboid.
//line diamond_block 2
//curve [-h] <pattern> [thickness]
Creates a curved line from various points selected when using //sel convex.
//curve -h diamond_block 3
With Selections
//stack <count> <direction>
Repeats a selection for a number of times in a certain direction. If no direction is added, the closest player direction will be used.
//stack 5 up
Clipboard Operations
The clipboard is similar to that of a computer where you can cut, copy, and paste. Instead of text, you’re copying blocks and entities.
Copy and copy-like commands (i.e. cut) copy the region relative to your in-game position. In other words, where you stand when executing these commands will change where they are pasted later.
Basics
//copy
Copies everything in the selected region.
//copy
//cut
Copies everything in the selected region and then removes it.
//cut
//paste
Pastes your clipboard content.
//paste
Manipulating Clipboard Content
Once you have copied or cut content to your clipboard, you can then modify it before pasting.
//rotate <degrees>
Rotates in y-axis degrees.
//rotate 90
//flip [direction]
Flips clipboard to a direction like a mirror.
//flip down
History
//undo [# of steps]
Undo one edit, or multiple edits if a number is passed.
//undo
//redo [# of steps]
Redo one edit, or multiple edits if a number is passed.
//redo
//clearhistory
Wipes edit history. All previous //redo(s) and //undo(s) will no longer be available.
//clearhistory
Tools
Commands that can be bound to an item and activated upon clicking a block.
//tool tree <type>
Paste a vanilla-style tree where you click.
//tree cherry