Quick Start

First things first

  • If you are using Bukkit, then you need to have permissions to use WorldEdit. You can give yourself op (/op yourname) to give yourself permissions. Sponge servers will also need to use permissions, though Sponge does not use op to grant all permissions.
  • If you are using Forge/Fabric and playing single player, then WorldEdit is only enabled if your world has cheats enabled.
  • If you are using Forge/Fabric server, then only ops can use WorldEdit.

Tip

For Forge/Fabric, you can:

  • Turn on “cheat-mode” in WorldEdit’s settings (see Configuration) file to let you use WorldEdit even in survival (and on a server, everyone is allowed)
  • Or instead, turn on “use-in-creative” to let yourself use WorldEdit when you have creative mode (and on a server, when someone has creative)

Want to see selection lines?

To see lines that show what you have selected, then you need to install WorldEditCUI, a client-side mod. Note that the mod requires Fabric, so you will need to install that first.

Note

If you would like to use an older version of Minecraft (1.12 or before), in addition to downloading an older WorldEdit (version 6), you will also need the older WorldEditCUI mod by Mumfrey. Note that this version requires LiteLoader (installation instructions on that page) instead of Fabric.

Tip

Don’t want to install client mods? You can access a limited version of the selection outlines server-side via the //drawsel command. It only works for cuboid selections less than 32x32x32 in size, and you must be in creative mode. These restrictions are due to how structure blocks work in Minecraft.

The selection lines mod works regardless of how you may have installed WorldEdit (on a Bukkit server, on singleplayer, etc).

Getting Around

First, let’s figure out how you can get around quickly.

  1. Look at a block not too far away and type /jumpto
  2. Stand under a tree and type /ascend
  3. While on top of the tree, type /descend
  4. Stand behind a tree trunk, look straight ahead, make sure there’s room on the other side, and type /thru

Or whip out your compass (or type //wand -n), look at a nearby block, and left click. Want to go through walls? Right click on a wall.

Making Selections

A cuboid is like 3D rectangle. In WorldEdit, you select the region that you want by setting two points of a cuboid.

../_images/cuboid.png

How do you choose the two points? You can either:

  • Left and right click blocks while holding a wooden axe (use //wand to get a wooden axe)
  • Stand somewhere and type //pos1 and //pos2
  • Look at a block and type //hpos1 and //hpos2

Tutorial: Make an approximate selection of a 15x15x15 area to test with and go to the next section.

Doing things with the selection

  1. Set the entire thing to bedrock: //set minecraft:bedrock (minecraft is implicit. If you’re playing on a platform with mods, you’ll need the mod’s namespace to identify blocks, eg //set ic2:stone.)
  2. Set the entire thing to stone: //set 1 (these are legacy IDs used in Minecraft 1.12 and before. You can use them if you know them already, but it’s recommended (and easier) to learn the names of blocks - new blocks in 1.13+ don’t have these ids!)
  3. Set the selection to 50% sandstone, 50% glass: //set sandstone,glass
  4. Replace the sandstone with dirt: //replace sandstone dirt
  5. Clear the area: //set air
  6. Generate an interesting shape: //g 35 data=(32+15/2/pi*atan2(x,y))%16; (0.75-sqrt(x^2+y^2))^2+z^2<0.25^2
  7. Look in a cardinal direction (not diagonal) and repeat your selection: //stack 4

Let’s undo your changes!

  • Undo 7 times: //undo 7

Adjusting the selection

So you’ve got a cuboid. Let’s change it!

  1. Make the cuboid 10 blocks taller, going up: //expand 10 up
  2. Make the cuboid 5 blocks longer in the direction that you are looking: //expand 5
  3. Make the cuboid 10 blocks shorter, going down: //contract 10 down

Playing with brushes

  1. Grab a pickaxe (or any item of choice) and have it as your active slot.
  2. Turn on a stone brush of radius 5: /br sphere stone 5
  3. Aim at ground not near you and right click to place large stone spheres.
  4. Make it so the brush only affects grass: /mask grass
  5. Instead of placing stone, let’s place wool: /mat red_wool,green_wool
  6. Right click more areas.
  7. Disable the brush: /none

Continuing on…

Checkout out the rest of the docs.