Worldedit

Selection commands

  • //pos1, //pos2 — set start and end positions at your feet.
  • //hpos1, //hpos2 — set start and end positions at the block you’re looking at.
  • //chunk — set the selection to your current chunk’s boundaries.
  • //expand amount direction — expand your selection amount blocks in a given compass direction, i.e. «north», «up», «down», «e» etc.
  • //contract amount direction — contract your selection amount blocks in a given compass direction (pulls in the side opposite the direction you specify, in that direction)
  • //shift amount direction — shift the entire area of your selection amount blocks in a given compass direction.
  • //sel cuboid|poly — switch selection between normal cuboid selection mode and polygonal mode, where you click once to start a polygon and subsequent right-clicks add vertices (in the horizontal plane).

There is also a helper script that allows selection by coordinates, which worldedit does not permit normally. You must have an area already selected for it to work:

/weselect x1 y1 z1 x2 y2 z2 — Select the specified area in worldedit.

Brush Commands¶

(or , , )

Description Brushing commands
Usage
Description Forest brush, creates a forest in the area
Permissions
Usage
   The shape of the region
   The size of the brush
   The density of the brush
   The type of tree to use

(or )

Description Butcher brush, kills mobs within a radius
Permissions
Usage
   Radius to kill mobs in
   Also kill pets
   Also kill NPCs
   Also kill golems
   Also kill animals
   Also kill ambient mobs
   Also kill mobs with name tags
   Also kill all friendly mobs (Applies the flags -abgnpt)
   Also destroy armor stands
   Also kill water mobs
Description Paint brush, apply a function to a surface
Permissions
Usage
   The shape of the region
   The size of the brush
   The density of the brush

(or )

Description Unbind a bound brush from your current item
Usage

(or )

Description Choose the clipboard brush
Permissions
Usage
   Don’t paste air from the clipboard
   Paste starting at the target location, instead of centering on it
   Paste entities if available
   Paste biomes if available
   Skip blocks matching this mask in the clipboard

(or )

Description Gravity brush, simulates the effect of gravity
Permissions
Usage
   The radius to apply gravity in
   Affect blocks between the given height, upwards and downwards, rather than the target location Y + radius
Description Heightmap brush, raises or lowers terrain using an image heightmap
Permissions
Usage
   The name of the image
   The size of the brush
   The intensity of the brush
   Erase blocks instead of filling them
   Don’t change blocks above the selected height
   Randomizes the brush’s height slightly.

(or )

Description Shortcut fire extinguisher brush
Permissions
Usage
   The radius to extinguish

(or )

Description Choose the sphere brush
Permissions
Usage
   The pattern of blocks to set
   The radius of the sphere
   Create hollow spheres instead
Description Raise brush, raise all blocks by one
Permissions
Usage
   The shape of the region
   The size of the brush
Description

Choose the terrain softener brush

Example: ‘/brush smooth 2 4 grass_block,dirt,stone’

Permissions
Usage
   The radius to sample for softening
   The number of iterations to perform
   The mask of blocks to use for the heightmap

(or , )

Description Choose the cylinder brush
Permissions
Usage
   The pattern of blocks to set
   The radius of the cylinder
   The height of the cylinder
   Create hollow cylinders instead
Description Set brush, sets all blocks in the area
Permissions
Usage
   The shape of the region
   The size of the brush
   The pattern of blocks to set
Description Apply brush, apply a function to every block
Permissions
Usage
   The shape of the region
   The size of the brush
Description Deform brush, applies an expression to an area
Permissions
Usage
   The shape of the region
   The size of the brush
   Expression to apply
   Use the game’s coordinate origin
   Use the placement position as the origin
Description Lower brush, lower all blocks by one
Permissions
Usage
   The shape of the region
   The size of the brush
Description Snow brush, sets snow in the area
Permissions
Usage
   The shape of the region
   The size of the brush
   Whether to stack snow

Selection Commands¶

Description Set position 1
Permissions
Usage
   Coordinates to set position 1 to
Description Set position 2
Permissions
Usage
   Coordinates to set position 2 to
Description Set position 1 to targeted block
Permissions
Usage
Description Set position 2 to targeted block
Permissions
Usage
Description

Set the selection to your current chunk.

This command selects 256-block-tall areas,
which can be specified by the y-coordinate.
E.g. -c x,1,z will select from y=256 to y=511.

Permissions
Usage
   The chunk to select
   Expand your selection to encompass all chunks that are part of it
   Use chunk coordinates instead of block coordinates
Description Get the wand object
Permissions
Usage
   Get a navigation wand
Description Remind the user that the wand is now a tool and can be unbound with /tool none.
Permissions
Usage
Description Contract the selection area
Permissions
Usage
   Amount to contract the selection by
   Amount to contract the selection by in the other direction
   Direction to contract
Description Shift the selection area
Permissions
Usage
   Amount to shift the selection by
   Direction to contract
Description Outset the selection area
Permissions
Usage
   Amount to expand the selection by in all directions
   Only expand horizontally
   Only expand vertically
Description Inset the selection area
Permissions
Usage
   Amount to contract the selection by in all directions
   Only contract horizontally
   Only contract vertically
Description Get information about the selection
Permissions
Usage
   Get clipboard info instead
Description Counts the number of blocks matching a mask
Permissions
Usage
   The mask of blocks to match
Description Get the distribution of blocks in the selection
Permissions
Usage
   Get the distribution of the clipboard instead
   Separate blocks by state
   Gets page from a previous distribution.

(or , , )

Description Choose a region selector
Usage
   Selector to switch to
   Set default selector
Description Expand the selection area
Permissions
Usage
   Amount to expand the selection by, can be vert to expand to the whole vertical column
   Amount to expand the selection by in the other direction
   Direction to expand

Non-obvious things to note

One important thing to realise is that we are NOT running the latest version of worldedit — since it’s bukkit only (ugh!). So not all of the documentation is in fact accurate, and some of the listed commands don’t yet exist in our version. Having said that, the following are a few less well documented bits of worldedit that DO work on our version, that you, dear reader, may not know about:

  • //set sign:4|Line1|Line2_Text|Line3 — create signs with prewritten text, and a specified orientation. Great for police cordons.
  • //set crops:7 — damage (data) values!
  • //replace dirt,cobble,glass 0 — lists!
  • //set 5%stone,95%dirt — percentages! Set contents to a random distribution. You don’t have to use two, you can use three or more. And they don’t have to add up to 100%… not entirely sure how it handles it if you don’t, though.
  • You can also do all the above with //replace, //fill and //fillr. Careful with the latter two, though!
  • //replace can replace more than one block type at once, to save a lot of typing — i.e. //replace glass,wool stone
  • //overlay <blocktype> — places one layer of blocktype on top of the highest block in the selection. May not always work. This unfortunately doesn’t work with percentages above. The trick — overlay first, then replace the overlay block type selectively!

Tool Commands¶

Description Binds a tool to the item in your hand
Usage
Description Block stacker tool
Permissions
Usage
   The max range of the stack
   The mask to stack until
Description Selection wand tool
Permissions
Usage
Description Tree generator tool
Permissions
Usage
   Type of tree to generate
Description Block replacer tool
Permissions
Usage
   The pattern of blocks to place
Description Wand at a distance tool
Permissions
Usage

(or )

Description Unbind a bound tool from your current item
Usage
Description Floating tree remover tool
Permissions
Usage
Description Long-range building tool
Permissions
Usage
   Pattern to set on left-click
   Pattern to set on right-click

(or )

Description Flood fill tool
Permissions
Usage
   The pattern to flood fill
   The range to perform the fill
Description Block data cycler tool
Permissions
Usage
Description Navigation wand tool
Permissions
Usage
Description Block information tool
Permissions
Usage

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Unbind a bound tool from your current item
Usage

(or )

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Selection wand tool
Permissions
Usage

(or )

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Navigation wand tool
Permissions
Usage

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Block information tool
Permissions
Usage

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Tree generator tool
Permissions
Usage
   Type of tree to generate

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Block replacer tool
Permissions
Usage
   The pattern of blocks to place

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Block data cycler tool
Permissions
Usage

(or )

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Flood fill tool
Permissions
Usage
   The pattern to flood fill
   The range to perform the fill

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Floating tree remover tool
Permissions
Usage

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Wand at a distance tool
Permissions
Usage

(or )

Warning

This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.

Please use instead.

Description Long-range building tool
Permissions
Usage
   Pattern to set on left-click
   Pattern to set on right-click

(or )

Description Toggle the super pickaxe function
Permissions
Usage
   The new super pickaxe state
Description Set the brush mask
Permissions
Usage
   The mask to set

(or )

Description Set the brush material
Permissions
Usage
   The pattern of blocks to use
Description Set the brush range
Permissions
Usage
   The range of the brush
Description Set the brush size
Permissions
Usage
   The size of the brush

Installation Step-by-step¶

Bukkit / Spigot / Paper

Once you’ve set up your Bukkit-based server (instructions can be found on the respective Paper/Spigot sites), download WorldEdit from the Bukkit dev site. Make sure you get the right WorldEdit download for your Minecraft version.

  1. In your server folder, create a “plugins” folder if one does not yet exist. (It should be created when you first run the server).
  2. Move the WorldEdit .jar file into the plugins folder.
  3. Start your server.

Check your server log for errors. If you encounter errors, see the FAQ page.

Forge Single-Player

First, you’ll have to install Minecraft Forge. There are many third-party launchers designed to easily install modpacks. If you’re using one of those, you can add WorldEdit as a mod through the launcher interface. Otherwise, Forge will install a profile available through the official Minecraft Launcher. After installing Forge one way or the other, download WorldEdit from the CurseForge site. Make sure you get the right WorldEdit download for your Minecraft version and platform (Fabric builds are also there — make sure you grab the right one).

  1. If you’ve installed Forge as a profile in the official Minecraft launcher, follow Mojang’s instructions for finding where your “.minecraft” folder is. If you’re using a third-party launcher, this might be in a different location (consult the launcher’s docs).
  2. Create a “mods” folder inside the “.minecraft” folder if it doesn’t yet exist (it should be created if you’ve run Forge once already).
  3. Place the WorldEdit .jar file inside the mods folder. Start Forge from your launcher. WorldEdit should show up in the mods list.

If you encounter any errors, see the FAQ page.

Fabric Single-Player or Server

First, you’ll have to install Fabric. They have instructions on their website depending on how you’d like to install. The MultiMC instructions are recommended for single-player.

Then, download WorldEdit from the CurseForge site. Make sure you get the right WorldEdit download for your Minecraft version and platform (Forge builds are also there — make sure you grab the right one).

On Minecraft 1.14.x versions, you will also need to install the Fabric API mod. This is not required for 1.15+.

Add the WorldEdit .jar to the “loader mods” section of your MultiMC instance and check to enable it, or add the jar to your mods folder (see Forge instructions above) if you’re installing in the official Mojang launcher.

Forge Server / Sponge

First, you’ll have to install your server software of choice. For Forge, you can download the installer and run from a terminal or command prompt (search online for more comprehensive instructions). Sponge has documentation on setting up a server. After installing your server software, download WorldEdit from Curseforge, if using Forge or Ore, if using Sponge. If you are using SpongeForge, either version of WorldEdit will work (but don’t use both) — the Forge version may perform better in some cases.

  1. Create a “mods” folder if it doesn’t exist (it will be created automatically after running the server once).
  2. Add the WorldEdit .jar file to the mods folder.
  3. Start the server.

Check your server log for errors. If you encounter errors, see the FAQ page.

Want to see selection lines?

To see lines showing your selection, you can either:

  1. Access a limited version of the selection outlines server-side via the command. It works only for cuboid selections that are not larger than 48x48x48 (or 32x32x32 on older versions), and you have to be in creative mode. These limitations are due to how structure blocks have worked in Minecraft for a long time.
  2. Use a third party client-side mod, e.g. WorldEdit CUI (Fabric). Note that this mod requires Fabric, so you will have to install it at first.

Note

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

Undo

The //undo command is not to be relied upon. Use this in emergencies only — but don’t get into the habit of breaking things and fixing them with undo. It will often break signs, ruin redstone circuitry, break torches, and do terrible things to Craftbook and LionsMod sign-driven systems.

Also, do not confuse Worldedit’s //undo with Cuboid’s /undo! Both can be used for each of the plugins independently, and the two can be used together for some excellent effects. However, you stand a chance of accidentally undoing a previous repair from halfway round the world, and Cuboid cannot always manage /redo.

Region Commands¶

Description Sets all the blocks in the region
Permissions
Usage
   The pattern of blocks to set
Description

Draws line segments between cuboid selection corners or convex polyhedral selection vertices

Can only be used with a cuboid selection or a convex polyhedral selection

Permissions
Usage
   The pattern of blocks to place
   The thickness of the line
   Generate only a shell
Description

Draws a spline through selected points

Can only be used with a convex polyhedral selection

Permissions
Usage
   The pattern of blocks to place
   The thickness of the curve
   Generate only a shell

(or , )

Description Replace all blocks in the selection with another
Permissions
Usage
   The mask representing blocks to replace
   The pattern of blocks to replace with
Description Set a block on top of blocks in the region
Permissions
Usage
   The pattern of blocks to overlay

(or )

Description Set the center block(s)
Permissions
Usage
   The pattern of blocks to set
Description 3 layers of dirt on top then rock below
Permissions
Usage
Description Build the four sides of the selection
Permissions
Usage
   The pattern of blocks to set

(or )

Description Build the walls, ceiling, and floor of a selection
Permissions
Usage
   The pattern of blocks to set
Description

Smooth the elevation in the selection

Example: ‘//smooth 1 grass_block,dirt,stone’ would only smooth natural surface terrain.

Permissions
Usage
   # of iterations to perform
   The mask of blocks to use as the height map
Description Move the contents of the selection
Permissions
Usage
   number of times to apply the offset
   The offset to move
   The pattern of blocks to leave
   Shift the selection to the target location
   Ignore air blocks
   Also copy entities
   Also copy biomes