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.
- Type
//wandto 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. - Or set the corners where you stand:
//pos1and//pos2use the block your feet are in, and//hpos1and//hpos2use the block you are looking at. //set stonefills the whole selection with stone.//set airclears it.//replace dirt grass_blockswaps one block for another inside the selection.//undotakes back the last command,//undo 3the last three, and//redobrings 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 1for a filled circle of stone, one block tall.//hcyl stone 7 1for 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.
| 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 1is an oval 21 blocks east to west and 13 blocks north to south.//hcyl stone 6,10 1is 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 20is a round tower wall 13 blocks across and 20 blocks tall.//cyl stone 6 20is a solid pillar of the same size.- A negative height builds downward:
//cyl air 4 -30digs 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 10builds a solid sphere.//hsphere glass 10builds 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.
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:
- Stand on the center and run
//cyl stone 7 1(or//hcyl). - Without moving, select it:
//pos1,//pos2,//expand 7 7 north,//expand 7 7 east. //copy, then//set airto remove the flat one.//rotate 0 90stands the copy up, running east-west.//rotate 0 0 90stands it up running north-south.- 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 10builds a solid pyramid 10 layers tall, with a base 19 blocks wide.//hpyramidbuilds 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 12builds a cone with radius 6 and height 12.//conewas 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 5places 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.
//limitshows 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_planksorlight_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 |