Guides · WorldEdit

How to use WorldEdit

WorldEdit builds a whole circle, tower or sphere with one command and takes it back with another. This guide covers installing it, the first commands you need, and the exact commands for circles, ovals, spheres, domes, vertical circles and pyramids, with what each radius really builds.

Updated

What WorldEdit is

WorldEdit is an in-game editor for Minecraft Java Edition. You select an area and fill, replace, copy or rotate everything in it at once, and shape commands build a circle, cylinder, sphere or pyramid around you in a single step. Every change can be undone.

It runs only on Java Edition, as a mod in singleplayer or a plugin on a server. It does not exist for Bedrock, Pocket Edition or Realms. WorldEdit is free and made by EngineHub; it is not part of Minecraft and not made by Mojang.

Install WorldEdit

Download the build for your Minecraft version and your loader from Modrinth or enginehub.org. There are builds for Fabric, NeoForge, Forge and Quilt (mods) and for Paper, Spigot, Bukkit and Folia (server plugins).

Where you play What to install Where it goes
Singleplayer, Fabric WorldEdit for Fabric (on 1.14 also Fabric API) the mods folder
Singleplayer, NeoForge or Forge WorldEdit for NeoForge or Forge the mods folder
Your own Paper or Spigot server the WorldEdit plugin the server’s plugins folder
Someone else’s server nothing; the server needs it ask the server staff

Then you need permission to run it:

  • Singleplayer: cheats must be on. Turn them on when you create the world, or open the pause menu, choose Open to LAN and set Allow Cheats to ON.
  • Fabric or NeoForge server: only operators can use WorldEdit by default. Run /op <name> in the server console.
  • Paper or Spigot server: operators can use everything; other players need the worldedit.* permissions from a permissions plugin.

Type // in chat. If the command list offers WorldEdit commands, it is installed and you can use it.

Your first WorldEdit commands

Most WorldEdit commands start with two slashes, so they do not clash with vanilla commands: //set, not /set.

  1. Type //wand to get a wooden axe. Left-click a block to set the first corner (position 1), right-click another block to set the second corner (position 2). The selection is the box between them.
  2. Or set the corners where you stand: //pos1 and //pos2 use the block your feet are in, and //hpos1 and //hpos2 use the block you are looking at.
  3. //set stone fills the whole selection with stone. //set air clears it.
  4. //replace dirt grass_block swaps one block for another inside the selection.
  5. //undo takes back the last command, //undo 3 the last three, and //redo brings it back.

//expand 5 up grows the selection by 5 blocks upward, and //shift 3 north moves it without changing its size. Block names are the game’s IDs without minecraft:, such as stone, glass, oak_planks or white_concrete.

Make a circle with //cyl

The shape commands do not need a selection. They build around the block your feet are in, so stand on the block that should be the middle and run:

  • //cyl stone 7 1 for a filled circle of stone, one block tall.
  • //hcyl stone 7 1 for only the outline (a hollow circle).

The three values are the block, the radius and the height. The radius counts outward from the center block, so the circle is the center plus that many blocks on each side: radius r makes a circle 2r + 1 blocks across.

Top view of //hcyl stone 5 1: a ring 11 blocks across, with the center block where you stand and 5 blocks on each side of it.radius 511 blocks = 5 + 1 + 5Center block:where you stand
Top view of //hcyl stone 5 1. The center block is where you stand; radius 5 adds 5 blocks on each side, so the ring is 11 blocks across.
Command Width Blocks, filled Blocks, outline
//cyl stone 3 1 7 37 16
//cyl stone 5 1 11 97 28
//cyl stone 7 1 15 177 40
//cyl stone 10 1 21 349 56
//cyl stone 15 1 31 749 84
//cyl stone 20 1 41 1,313 112
//cyl stone 25 1 51 2,053 144

For a circle of a given width, use radius = (width − 1) ÷ 2. WorldEdit’s circles are block-for-block the same as the circle generator’s blueprints for odd sizes, so you can preview one there and paste the command it shows.

Even sizes are not possible. Every WorldEdit circle has a center block, so the width is always odd. A radius like 7.5 does not give 16: it gives a 17-wide circle with single blocks sticking out at the four edges. If you need an even width, build it from a blueprint by hand or load the generator’s .litematic with Litematica.

A thick ring. //hcyl walls are always one block thick. For a ring several blocks wide, build the outer circle filled, then clear the middle from the same spot: //cyl stone 10 1, then //cyl air 7 1.

Ovals

Give //cyl or //hcyl two radii separated by a comma. The first is the east-west radius, the second the north-south radius:

  • //cyl stone 10,6 1 is an oval 21 blocks east to west and 13 blocks north to south.
  • //hcyl stone 6,10 1 is the same outline turned the other way.

Press F3 to see which way you face. Odd widths match the oval generator exactly.

Towers and cylinders

The last number of //cyl is the height, counted up from the block your feet are in:

  • //hcyl stone_bricks 6 20 is a round tower wall 13 blocks across and 20 blocks tall.
  • //cyl stone 6 20 is a solid pillar of the same size.
  • A negative height builds downward: //cyl air 4 -30 digs a round shaft 9 blocks wide and 30 deep from where you stand.

Add the floor and roof of a tower with two more flat circles: //cyl stone_bricks 6 1 at the bottom, and the same command again standing at the top.

Spheres

  • //sphere stone 10 builds a solid sphere.
  • //hsphere glass 10 builds a hollow sphere, a shell one block thick.

The center is the block your feet are in, so half the sphere goes into the ground. Add -r to raise it: //hsphere -r glass 10 puts the bottom of the sphere at your feet. As with circles, radius r makes a sphere 2r + 1 blocks across.

Command Width Blocks, solid Blocks, hollow
//sphere stone 5 11 739 278
//sphere stone 7 15 1,791 530
//sphere stone 10 21 4,945 1,082
//sphere stone 15 31 15,515 2,382
//sphere stone 20 41 36,137 4,242

Three radii make an ellipsoid: //hsphere glass 12,6,8 is 25 blocks east to west, 13 blocks tall and 17 blocks north to south (east-west, up-down, north-south). The sphere generator shows any odd size layer by layer with the same blocks as //sphere.

Domes and half spheres

There is no dome command. Build a sphere and clear its lower half. Run these from the block where you ran //hsphere, without moving, and replace R with your radius:

//hsphere glass R
//pos1
//pos2
//shift 1 down
//expand R R north
//expand R R east
//expand R-1 down
//set air

//pos1 and //pos2 select the center block, //shift 1 down moves that one-block selection under the center, the two //expand lines with R R widen it to the sphere’s full width, and //expand R-1 down makes it R layers deep. Type the numbers, not the letter: for radius 10 the lines are //expand 10 10 north, //expand 10 10 east and //expand 9 down.

Side view through the middle of //hsphere stone 5: the top six layers stay as the dome and the five layers below the center are selected and cleared.Selection: 5 layersbelow the center,then //set airCenter layer (kept)The dome
Side view through the middle of //hsphere stone 5. The selection covers the 5 layers below the center; //set air clears them and leaves the dome.

That works as written when the lower half is in the air. On flat ground the lower half of the shell went into the ground, and //set air would dig a square pit: use //replace glass dirt instead as the last line, which turns only the buried shell back into dirt. The dome keeps the sphere’s widest layer at its bottom, the same as the dome generator, which also shows a dome layer by layer if you want to build one by hand in survival.

Vertical circles and arches

//cyl only builds flat circles. To stand one up, build it flat, copy it and rotate the copy:

  1. Stand on the center and run //cyl stone 7 1 (or //hcyl).
  2. Without moving, select it: //pos1, //pos2, //expand 7 7 north, //expand 7 7 east.
  3. //copy, then //set air to remove the flat one.
  4. //rotate 0 90 stands the copy up, running east-west. //rotate 0 0 90 stands it up running north-south.
  5. Go 7 blocks up, on a pillar or flying, and //paste. The circle is pasted centered on your feet, so its bottom block lands 7 blocks below you.

For an arch, the half circle over a doorway or a bridge, the arch generator is easier: pick round, pointed or bridge arches of any width, follow the front-view blueprint, or download its .litematic.

Pyramids and cones

  • //pyramid sandstone 10 builds a solid pyramid 10 layers tall, with a base 19 blocks wide. //hpyramid builds only its walls. The base is centered on the block you stand on. For a beacon base, the beacon calculator gives the four layers (9 × 9 down to 3 × 3, 164 blocks) and a .litematic to place it.
  • //cone stone 6 12 builds a cone with radius 6 and height 12. //cone was added in recent WorldEdit versions; if it is an unknown command, update WorldEdit.

For any other shape, //generate builds what a math expression describes inside the selection, for example //generate stone x^2+y^2+z^2<1 fills the selected box with the biggest ellipsoid that fits. See the WorldEdit documentation for expressions.

Brushes

A brush puts a shape where you look instead of where you stand, so you can build from far away. Hold an item, such as a feather, and bind a brush to it:

  • /brush sphere stone 5 (short: /br s stone 5): right-click to place a sphere of radius 5 on the block you look at. /brush sphere -h glass 5 places hollow ones.
  • /brush cylinder stone 3 4 (short: /br c): a cylinder of radius 3, 4 blocks tall.

Each click is one step in //undo. /brush none removes the brush from the item.

Plan the size first

The commands are quick, but a sphere of radius 20 is 41 blocks across and 4,242 blocks hollow, so check the size before you place it. The generators on this site build the same shapes as WorldEdit for odd sizes and show the block count, layers and the matching command:

Shape WorldEdit Generator
Circle //cyl / //hcyl with height 1 Circle generator
Oval //cyl with two radii Oval generator
Sphere //sphere / //hsphere Sphere generator
Dome sphere, then clear the lower half Dome generator
Arch copy and rotate a circle Arch generator

Every generator has a WorldEdit box with a copy button; set the size there and paste the command into chat.

Troubleshooting

  • Unknown command. Check that you typed two slashes, that WorldEdit is installed for your exact Minecraft version and loader, and that the game was started with that loader’s profile.
  • “You are not permitted to do that.” Turn on cheats in singleplayer, or get operator status or WorldEdit permissions on the server.
  • The sphere is half underground. The center is your feet. Use -r, or stand higher.
  • Too many blocks. Servers can limit how many blocks one command changes. //limit shows or sets your own limit; the server’s maximum is in its WorldEdit config.
  • The shape is off by one. Sizes are 2r + 1. A circle 20 wide does not exist in WorldEdit; use radius 10 for 21 or radius 9 for 19.
  • Wrong block. Use the block ID, like oak_planks or light_blue_stained_glass, not the display name. Pressing Tab completes it.

Common commands

Command What it does
//wand Gives the selection axe
//pos1, //pos2 Set a corner at your feet
//set <block> Fill the selection
//replace <from> <to> Replace blocks in the selection
//cyl, //hcyl <block> <radius> <height> Filled or hollow cylinder; height 1 for a circle
//sphere, //hsphere <block> <radius> Solid or hollow sphere, centered on you
//pyramid, //hpyramid <block> <size> Solid or hollow pyramid
//copy, //paste Copy the selection, paste it around you
//rotate <degrees> Rotate the copied blocks
//undo, //redo Undo or redo

FAQ

What is the WorldEdit command for a circle?

//cyl <block> <radius> 1 builds a filled circle one block tall around you, and //hcyl <block> <radius> 1 builds only the outline. For example //hcyl stone 10 1 makes a ring 21 blocks across. The width is always twice the radius plus one.

How do I make a hollow sphere in WorldEdit?

Stand on the center block and type //hsphere <block> <radius>, for example //hsphere glass 10 for a glass sphere 21 blocks across. Add -r (//hsphere -r glass 10) to raise it so its bottom sits at your feet instead of half underground.

Is there a dome command in WorldEdit?

No. Build a sphere with //hsphere, then select the half below its center and clear it with //set air. The selection commands for that are in the dome section of this guide.

Does WorldEdit work in survival?

Yes. WorldEdit does not check your game mode, only your permission, so with cheats on in singleplayer or as an operator on a server you can use it in survival. The blocks it places are not taken from your inventory.

Is there WorldEdit for Bedrock?

No. WorldEdit runs only on Minecraft Java Edition, as a mod or a server plugin. On Bedrock you can use /fill for boxes and follow a blueprint from one of the shape generators for round builds.

Is WorldEdit free?

Yes. WorldEdit is free and open source, made by EngineHub, and the official downloads are on Modrinth, CurseForge and enginehub.org.

How do I undo in WorldEdit?

Type //undo to undo your last WorldEdit command, or //undo 5 to undo the last five. //redo brings back what you undid. Vanilla commands like /fill are not part of this history.

How do I make an oval in WorldEdit?

Give //cyl two radii separated by a comma: //cyl stone 10,6 1 makes an oval 21 blocks east to west and 13 blocks north to south. The first radius is east-west, the second north-south.

How do I make a vertical circle in WorldEdit?

WorldEdit only builds flat circles, so build one with //cyl, copy it, turn it upright with //rotate 0 90 and paste it. The vertical circle section of this guide has the exact commands.

Why can't I make an even-sized circle with WorldEdit?

WorldEdit always puts the center on one block and counts the radius out from it, so every circle, sphere and cylinder has an odd width. A radius of 7.5 does not make 16; it makes 17 with a bumpy edge. For an even size, build it by hand from a blueprint.