Commands
Commands are the main way to use the many features of WorldEdit. Type ;help to get a list of available commands. If you don't find a command here that's in the original, look in the differences page to see if it's planned.
Reading this documentation
Commands may come with arguments. When you see an argument surrounded in [square brackets], then that argument is optional. If it's surrounded in <angled brackets>, then you need to define it when using the command. If you find arguments that look like [-this], they are flags. Flags change how commands are executed. Each letter after the "-" is its own flag. You can define them apart (-a -b) or together (-ab). Some flags even require an argument defined after them. Finally, | means you have a choice among the list it makes and must choose one.
Permissions
Each command has their own permission requirements to be useable by a player. To give yourself or anyone else permission for various commands, just type /tag "@s, or a player name" add "permission". For example, /tag @s add worldedit.region.set would give yourself permission to use the ;set command. You can give yourself permission for multiple comands at once. Using worldedit.clipboard for instance would give you permission to use every clipboard command. If you add - to the begin of a permission, you can also blacklist commands that use those permissions. So -worldedit.clipboard would prevent you from using clipboard commands.
Note
No command will work unless you at least have explicit permission to use any worldedit command. /tag @s add worldedit would give you permission for all of them.
The commands
;help (or ;?)
| Description | Get a list of commands available and a quick description for each of them |
|---|---|
| Permission | worldedit.help |
| Usage | ;help ([page]|<command>) |
;worldedit (or ;we)
| Description | WorldEdit commands |
|---|---|
| Permission | |
| Usage | ;worldedit <version|perf> |
;worldedit version
| Description | Get WorldEdit version |
|---|---|
| Permission | |
| Usage | ;worldedit version |
;worldedit perf
| Description | Toggle performance mode for the current session. |
|---|---|
| Permission | |
| Usage | ;worldedit perf |
;limit
| Description | Set the number of blocks you can change per action |
|---|---|
| Permission | worldedit.limit |
| Usage | ;limit [limit] |
;kit
| Description | Give yourself a set of items to do common worldedit functions |
|---|---|
| Permission | worldedit.kit |
| Usage | ;kit |
;toggleplace
| Description | Toggles the placement position used in various WorldEdit operations. |
|---|---|
| Permission | |
| Usage | ;toggleplace |
;pos1 (or ;1)
| Description | Set the first position of your selection to the specified or current position |
|---|---|
| Permission | worldedit.selection.pos |
| Usage | ;pos1 [coordinates] |
;pos2 (or ;2)
| Description | Set the second position of your selection to the specified or current position |
|---|---|
| Permission | worldedit.selection.pos |
| Usage | ;pos2 [coordinates] |
;hpos1
| Description | Set the first position of your selection to the position of the block you're facing |
|---|---|
| Permission | worldedit.selection.hpos |
| Usage | ;hpos1 |
;hpos2
| Description | Set the second position of your selection to the position of the block you're facing |
|---|---|
| Permission | worldedit.selection.hpos |
| Usage | ;hpos2 |
;chunk
| Description | Select your current, or specified chunk. |
|---|---|
| Permission | worldedit.selection.chunk |
| Usage | ;chunk [-cs] ([coordinates]|<coordinates>) |
;drawsel
| Description | Toggle your selection's visibility |
|---|---|
| Permission | worldedit.drawsel |
| Usage | ;drawsel |
;sel (or ;deselect, ;desel)
| Description | Change selection mode |
|---|---|
| Permission | |
| Usage | ;sel <cuboid|extend|sphere|cyl> |
;sel cuboid
| Description | Select two corners of a cuboid |
|---|---|
| Permission | |
| Usage | ;sel [-d] cuboid |
;sel extend
| Description | Fast cuboid selection mode |
|---|---|
| Permission | |
| Usage | ;sel [-d] extend |
;sel sphere
| Description | Select a sphere |
|---|---|
| Permission | |
| Usage | ;sel [-d] sphere |
;sel cyl
| Description | Select a cylinder |
|---|---|
| Permission | |
| Usage | ;sel [-d] cyl |
;wand
| Description | Give yourself a selection wand |
|---|---|
| Permission | worldedit.wand |
| Usage | ;wand |
;contract
| Description | Contract the selection area |
|---|---|
| Permission | worldedit.selection.contract |
| Usage | ;contract (<amount> [direction]|<amount> <reverseAmount> [direction]) |
;expand
| Description | Expand the selection area |
|---|---|
| Permission | worldedit.selection.expand |
| Usage | ;expand <vert> |
;expand vert
| Description | Vertically expand your selection to world height limits |
|---|---|
| Permission | |
| Usage | ;expand vert [height] |
;shift
| Description | Shift the selection area |
|---|---|
| Permission | worldedit.selection.shift |
| Usage | ;shift <amount> [direction] |
;outset
| Description | Outset the selection area |
|---|---|
| Permission | worldedit.selection.outset |
| Usage | ;outset [-hv] <amount> |
;inset
| Description | Inset the selection area |
|---|---|
| Permission | worldedit.selection.inset |
| Usage | ;inset [-hv] <amount> |
;count
| Description | Count the number of blocks that match a mask |
|---|---|
| Permission | worldedit.analysis.count |
| Usage | ;count <mask> |
;distr
| Description | Analyse the amount of different blocks in the selection |
|---|---|
| Permission | worldedit.analysis.distr |
| Usage | ;distr [-cd] |
;cut
| Description | Remove your current selection and place it in the clipboard |
|---|---|
| Permission | worldedit.clipboard.cut |
| Usage | ;cut [-ae] [fill] [-m <mask>] |
;copy
| Description | Copy the current selection to the clipboard |
|---|---|
| Permission | worldedit.clipboard.copy |
| Usage | ;copy [-aem <mask>] |
;paste
| Description | Paste your clipboard into the world |
|---|---|
| Permission | worldedit.clipboard.paste |
| Usage | ;paste [-osnm <mask>] |
;clearclipboard
| Description | Clear your clipboard |
|---|---|
| Permission | worldedit.clipboard.clear |
| Usage | ;clearclipboard |
;hsphere
| Description | Generate a hollow sphere |
|---|---|
| Permission | worldedit.generation.sphere |
| Usage | ;hsphere [-r] <pattern> <radii> |
;sphere
| Description | Generate a sphere |
|---|---|
| Permission | worldedit.generation.sphere |
| Usage | ;sphere [-hr] <pattern> <radii> |
;cyl
| Description | Generate a cylinder |
|---|---|
| Permission | worldedit.generation.cylinder |
| Usage | ;cyl [-hr] <pattern> <radii> [height] |
;hcyl
| Description | Generate a hollow cylinder |
|---|---|
| Permission | worldedit.generation.cylinder |
| Usage | ;hcyl [-r] <pattern> <radii> [height] |
;pyramid
| Description | Generate a pyramid |
|---|---|
| Permission | worldedit.generation.pyramid |
| Usage | ;pyramid [-h] <pattern> <size> |
;hpyramid
| Description | Generate a hollow pyramid |
|---|---|
| Permission | worldedit.generation.pyramid |
| Usage | ;hpyramid <pattern> <size> |
;gen (or ;g)
| Description | Generate any kind of shape in your selection |
|---|---|
| Permission | worldedit.generation.shape |
| Usage | ;gen [-h] <pattern> <expr> |
;gradient
| Description | Create a gradient to use in patterns. |
|---|---|
| Permission | worldedit.generation.gradient |
| Usage | ;gradient [-sf <fade>] <id> [patterns...] |
;gmask
| Description | Set the global mask |
|---|---|
| Permission | worldedit.global-mask |
| Usage | ;gmask [mask] |
;set
| Description | Fill the selection with a block pattern |
|---|---|
| Permission | worldedit.region.set |
| Usage | ;set <pattern> |
;replace
| Description | Replace certain blocks in the selection with other blocks |
|---|---|
| Permission | worldedit.region.replace |
| Usage | ;replace <mask> <pattern> |
;move
| Description | Move the selection in a certain direction |
|---|---|
| Permission | worldedit.region.move |
| Usage | ;move [-aes] [amount] [offset] [replace] [-m <mask>] |
;stack
| Description | Repeat the contents of the current selection |
|---|---|
| Permission | worldedit.region.stack |
| Usage | ;stack [-aers] [count] [offset] [-m <mask>] |
;rotate
| Description | Rotate the selection |
|---|---|
| Permission | worldedit.region.rotate |
| Usage | ;rotate [-ows] <rotate> [rotateX] [rotateZ] |
;flip
| Description | Flip the selection |
|---|---|
| Permission | worldedit.region.flip |
| Usage | ;flip [-ows] [direction] |
;walls
| Description | Generate a wall from your selection |
|---|---|
| Permission | worldedit.region.walls |
| Usage | ;walls <pattern> |
;smooth
| Description | Smooth the surface within the selection |
|---|---|
| Permission | worldedit.region.smooth |
| Usage | ;smooth [iterations] [mask] |
;faces
| Description | Generate an outline from your selection |
|---|---|
| Permission | worldedit.region.faces |
| Usage | ;faces <pattern> |
;hollow
| Description | Hollow out the objects contained in your selection |
|---|---|
| Permission | worldedit.region.hollow |
| Usage | ;hollow [thickness] [pattern] |
;line
| Description | Create a line between your first and second selection points |
|---|---|
| Permission | worldedit.region.line |
| Usage | ;line <pattern> |
;center (or ;middle)
| Description | Set the center block(s). |
|---|---|
| Permission | worldedit.region.center |
| Usage | ;center <pattern> |
;fill
| Description | Fill an area with certain blocks |
|---|---|
| Permission | worldedit.utility.fill |
| Usage | ;fill <pattern> <radius> [depth] [direction] |
;fillr
| Description | Recursively fill an area with certain blocks |
|---|---|
| Permission | worldedit.utility.fillr |
| Usage | ;fillr <pattern> <radius> [depth] [direction] |
;removeabove
| Description | Remove blocks above you |
|---|---|
| Permission | worldedit.utility.removeabove |
| Usage | ;removeabove <size> [height] |
;removebelow
| Description | Remove blocks below you |
|---|---|
| Permission | worldedit.utility.removebelow |
| Usage | ;removebelow <size> [depth] |
;removenear
| Description | Remove nearby blocks |
|---|---|
| Permission | worldedit.utility.removenear |
| Usage | ;removenear <mask> <size> |
;replacenear
| Description | Replace nearby blocks with other blocks |
|---|---|
| Permission | worldedit.utility.replacenear |
| Usage | ;replacenear <size> <mask> <pattern> |
;drain
| Description | Drain nearby fluids |
|---|---|
| Permission | worldedit.utility.drain |
| Usage | ;drain [-w] <radius> |
;fixwater
| Description | Make nearby flowing water blocks source blocks |
|---|---|
| Permission | worldedit.utility.fixwater |
| Usage | ;fixwater <radius> |
;fixlava
| Description | Make nearby flowing lava blocks source blocks |
|---|---|
| Permission | worldedit.utility.fixlava |
| Usage | ;fixlava <radius> |
;snow
| Description | Simulate snow in the area |
|---|---|
| Permission | worldedit.utility.snow |
| Usage | ;snow [-s] <size> [height] |
;thaw
| Description | Melt snow and ice exposed to the sky |
|---|---|
| Permission | worldedit.utility.thaw |
| Usage | ;thaw <size> [height] |
;green
| Description | Turn nearby dirt into grass |
|---|---|
| Permission | worldedit.utility.green |
| Usage | ;green [-f] <radius> |
;extinguish (or ;ext, ;ex)
| Description | Extinguish nearby fires |
|---|---|
| Permission | worldedit.utility.extinguish |
| Usage | ;extinguish <radius> |
;butcher
| Description | Kill nearby entities. |
|---|---|
| Permission | worldedit.utility.butcher |
| Usage | ;butcher [-pngabtrwf] [radius] |
;calculate (or ;calc, ;eval, ;evaluate, ;solve)
| Description | Evaluate a mathematical expression. |
|---|---|
| Permission | worldedit.utility.calc |
| Usage | ;calculate <expr> |
;navwand
| Description | Give yourself a navigation wand |
|---|---|
| Permission | worldedit.setwand |
| Usage | ;navwand |
;up
| Description | Move up a certain number of blocks |
|---|---|
| Permission | worldedit.navigation.up |
| Usage | ;up <height> |
;unstuck (or ;!)
| Description | Move out of blocks |
|---|---|
| Permission | worldedit.navigation.unstuck |
| Usage | ;unstuck |
;jumpto (or ;j)
| Description | Teleport you to the top of the block you're looking at |
|---|---|
| Permission | worldedit.navigation.jumpto.command |
| Usage | ;jumpto |
;thru
| Description | Teleport through any wall you look at |
|---|---|
| Permission | worldedit.navigation.thru.command |
| Usage | ;thru |
;ascend
| Description | Go up a floor |
|---|---|
| Permission | worldedit.navigation.ascend |
| Usage | ;ascend [levels] |
;descend
| Description | Go down a floor |
|---|---|
| Permission | worldedit.navigation.descend |
| Usage | ;descend [levels] |
;ceil
| Description | Go to the ceiling. |
|---|---|
| Permission | worldedit.navigation.ceiling |
| Usage | ;ceil [clearance] |
;tool
| Description | Get all sorts of tools |
|---|---|
| Permission | |
| Usage | ;tool <none|stacker|selwand|navwand|farwand|cmd|repl|cycler> |
;tool none
| Description | Unbind held tool |
|---|---|
| Permission | |
| Usage | ;tool none |
;tool stacker
| Description | Block stacker tool |
|---|---|
| Permission | worldedit.tool.stack |
| Usage | ;tool stacker [range] [mask] |
;tool selwand
| Description | Selection tool |
|---|---|
| Permission | worldedit.setwand |
| Usage | ;tool selwand |
;tool navwand
| Description | Navigation tool |
|---|---|
| Permission | worldedit.setwand |
| Usage | ;tool navwand |
;tool farwand
| Description | Selection tool, but can reach farther |
|---|---|
| Permission | worldedit.farwand |
| Usage | ;tool farwand |
;tool cmd
| Description | Command exeution tool; both vanilla and worldedit |
|---|---|
| Permission | worldedit.tool.cmd |
| Usage | ;tool cmd <command...> |
;tool repl
| Description | Block replacer tool |
|---|---|
| Permission | worldedit.repl |
| Usage | ;tool repl <pattern> |
;tool cycler
| Description | Block cycler tool |
|---|---|
| Permission | worldedit.cycler |
| Usage | ;tool cycler |
;brush (or ;br)
| Description | Set the type of a brush being held |
|---|---|
| Permission | |
| Usage | ;brush <none|sphere|cyl|smooth|struct|erode|overlay> |
;brush none
| Description | Unbind a bound brush from your current item |
|---|---|
| Permission | |
| Usage | ;brush none |
;brush sphere
| Description | Create a sphere brush |
|---|---|
| Permission | worldedit.brush.sphere |
| Usage | ;brush sphere [-h] <pattern> [radius] |
;brush cyl
| Description | Create a cylinder brush |
|---|---|
| Permission | worldedit.brush.cylinder |
| Usage | ;brush cyl [-h] <pattern> [radius] [height] |
;brush smooth
| Description | Create a terrain smoothing brush |
|---|---|
| Permission | worldedit.brush.smooth |
| Usage | ;brush smooth [radius] [iterations] [mask] |
;brush struct
| Description | Creates a brush that places structures |
|---|---|
| Permission | worldedit.brush.struct |
| Usage | ;brush struct <clipboard> |
;brush erode
| Description | Creates a terrain shaping brush |
|---|---|
| Permission | worldedit.brush.erode |
| Usage | ;brush erode <lift|fill|melt|smooth> |
;brush overlay
| Description | Creates a terrain overlaying brush |
|---|---|
| Permission | worldedit.brush.overlay |
| Usage | ;brush overlay <pattern> [radius] [depth] [mask] |
;mask
| Description | Set what kind of blocks a brush can affect, if any |
|---|---|
| Permission | worldedit.brush.options.mask |
| Usage | ;mask [mask] |
;tracemask
| Description | Set what kind of blocks a brush can be used on |
|---|---|
| Permission | worldedit.brush.options.tracemask |
| Usage | ;tracemask [mask] |
;size
| Description | Set the size of a brush or get information about the selection |
|---|---|
| Permission | |
| Usage | ;size (<size>|[-c]) |
;range
| Description | Set how far a brush can be used from |
|---|---|
| Permission | worldedit.brush.options.range |
| Usage | ;range [range] |
;material
| Description | Set what kind of blocks a brush should make |
|---|---|
| Permission | worldedit.brush.options.material |
| Usage | ;material <pattern> |
;undo
| Description | Undo a certain amount of actions |
|---|---|
| Permission | worldedit.history.undo |
| Usage | ;undo [times] |
;redo
| Description | Redo a certain amount of actions |
|---|---|
| Permission | worldedit.history.redo |
| Usage | ;redo [times] |
;clearhistory
| Description | Clear your editing history |
|---|---|
| Permission | worldedit.history.clear |
| Usage | ;clearhistory |
;export
| Description | Exports the selection for later use. |
|---|---|
| Permission | worldedit.structure.export |
| Usage | ;export [-ea] <name> |
;import
| Description | Imports a structure to the clipboard. |
|---|---|
| Permission | worldedit.structure.import |
| Usage | ;import <name> |
;biomeinfo
| Description | Retrieve the kinds of biomes in your selection |
|---|---|
| Permission | worldedit.biome.info |
| Usage | ;biomeinfo [-pt] |
;setbiome
| Description | Change the biomes in your selection |
|---|---|
| Permission | worldedit.biome.set |
| Usage | ;setbiome <biome> [-p] |