WorldEdit: command list and guide
WorldEdit is a mod (for singleplayer) and a plugin (for Bukkit/Spigot/Paper servers) that lets you edit a Minecraft world on a massive scale. Instead of placing blocks one by one, you select a region and fill it with a single command. You build walls, copy buildings, and generate spheres and pyramids in seconds. WorldEdit is not part of vanilla Minecraft, so you have to install it separately.
WorldEdit is an external mod/plugin made by the EngineHub team. It is not part of official Minecraft. On servers it has to be installed as a plugin (Bukkit/Spigot/Paper) or a mod (Fabric/Forge). In singleplayer you have to install the mod through Forge or Fabric. WorldEdit commands start with // (a double slash), unlike vanilla commands, which use a single /.
Selecting regions
Most WorldEdit commands work on a selected region: a rectangular area between two points. You have to select a region first, then run the operation.
| Command | Description |
|---|---|
//wand | Gives you a wooden axe, the selection tool. Left-click sets point 1, right-click sets point 2 |
//pos1 | Sets point 1 at your position (no axe needed) |
//pos2 | Sets point 2 at your position |
//hpos1 | Sets point 1 at the block you're looking at (crosshair) |
//hpos2 | Sets point 2 at the block you're looking at |
//expand [amount] [direction] | Expands the selection in the given direction (up, down, north, south, east, west) |
//contract [amount] [direction] | Shrinks the selection from the given direction |
//sel cuboid | Selection mode: cuboid (default) |
//sel poly | Selection mode: polygon |
Building and filling
| Command | Description |
|---|---|
//set [block] | Fills the whole selected region with a block. E.g. //set stone |
//replace [old] [new] | Replaces one block type with another in the selection. E.g. //replace dirt grass_block |
//walls [block] | Builds walls (no floor or ceiling) around the selection |
//faces [block] | Builds walls + floor + ceiling (a hollow box) |
//overlay [block] | Places a layer of the block on top of the existing blocks in the selection |
//stack [amount] [direction] | Duplicates the selection N times in the given direction. Great for bridges, walls and columns |
//move [distance] [direction] | Moves the blocks in the selection by the given amount in the given direction |
You give blocks as Minecraft IDs, e.g. stone, oak_planks, diamond_block. You can mix blocks: //set 50%stone,50%cobblestone fills the region with a random mix of stone and cobblestone.
Clipboard
WorldEdit has a clipboard that works like Ctrl+C / Ctrl+V on a computer: you copy a piece of the world, then paste it somewhere else.
| Command | Description |
|---|---|
//copy | Copies the selected region to the clipboard (relative to your position) |
//cut | Cuts the selected region (copies it and fills the area with air) |
//paste | Pastes the clipboard contents at your position |
//paste -a | Pastes without air (ignores air blocks in the clipboard) |
//rotate [degrees] | Rotates the clipboard by 90, 180 or 270 degrees |
//flip [direction] | Mirrors the clipboard in the given direction |
//schem save [name] | Saves the clipboard as a schematic file (.schem) |
//schem load [name] | Loads a schematic file into the clipboard |
The spot where you stand when you run //copy becomes the paste "anchor". When you run //paste, the clipboard is pasted relative to your current position, with the same offset. Stand at a corner of the building before copying so you get a predictable paste point.
Generating shapes
WorldEdit can generate geometric shapes that would take hours to build by hand:
| Command | Description |
|---|---|
//sphere [block] [radius] | Generates a filled sphere |
//hsphere [block] [radius] | Generates a hollow sphere |
//cyl [block] [radius] [height] | Generates a filled cylinder |
//hcyl [block] [radius] [height] | Generates a hollow cylinder (a tube) |
//pyramid [block] [size] | Generates a filled pyramid |
//hpyramid [block] [size] | Generates a hollow pyramid |
//forest [type] [density] | Generates a forest in the selected region. Type: oak, birch, spruce, etc. |
Shapes are generated at your position (the center of a sphere, the bottom of a cylinder or pyramid). You give the radius and height in blocks. E.g. //sphere glass 10 creates a glass sphere with a radius of 10 blocks.
Tools and brushes
Brushes let you "paint" with blocks in the world: hold the tool in your hand and right-click:
//brush sphere [block] [radius]- a spherical brush. Right-click places a sphere of blocks where you're looking//brush cyl [block] [radius] [height]- a cylindrical brush//brush smooth [radius]- a terrain-smoothing brush. Great for natural landscapes//brush gravity [radius]- "drops" blocks within the radius, as if gravity acted on them/tool tree [type]- right-click plants a tree of the given type/tool repl [block]- right-click replaces the clicked block with the given one
Brushes are best for terraforming: making natural-looking mountains, valleys and caves. You click on the terrain and shape it gradually, as if sculpting in clay.
Patterns and masks
Advanced WorldEdit use is about patterns and masks: you control not just WHAT you place, but WHERE:
Patterns
50%stone,50%andesite- a random mix of two blocks (percentages)##wool- random wool colors (a block tag)#clipboard- a pattern taken from the clipboard contents (a repeating pattern)
Masks
//gmask air- global mask: operations affect ONLY air blocks//gmask !water- operations affect EVERYTHING except water//mask stone- brush mask: the brush only modifies stone blocks
Other useful commands
//undo- undo the last operation (works repeatedly)//redo- redo an undone operation//drain [radius]- removes water and lava within the radius//fixwater [radius]- fixes "hanging" water within the radius (levels it out)//snow [radius]- covers the terrain with snow within the radius//thaw [radius]- removes snow and ice within the radius//count [block]- counts how many blocks of the given type are in the selection//size- shows the selection size and block count