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 , , )

(or )

(or )

(or )

(or )

(or )

(or )

(or , )

Selection Commands¶

(or , , )

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¶

(or )

(or )

Warning

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

Please use instead.

(or )

Warning

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

Please use instead.

(or )

Warning

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

Please use instead.

Warning

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

Please use instead.

Warning

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

Please use instead.

Warning

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

Please use instead.

Warning

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

Please use instead.

(or )

Warning

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

Please use instead.

Warning

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

Please use instead.

Warning

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

Please use instead.

(or )

Warning

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

Please use instead.

(or )

(or )

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¶

(or , )

(or )

(or )