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

;blockid (or ;id)

Description Prints the id and states of the block you're looking at.
Permission worldedit.blockid
Usage ;blockid

;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]