Worldedit permissions list!

Available Patterns¶

Note

This list may be incomplete as patterns are added to WorldEdit. In addition, our API allows other plugins to register new patterns, which will not be listed here.

Tip

Here’s a video detailing some of these patterns which were added in WorldEdit 7: https://www.youtube.com/watch?v=S5wCVMf3SvM

Single Block Pattern

The most basic pattern of just a single block. A block is identified by two parts: the , and additional block states. These two links to the Minecraft Wiki, along with WorldEdit’s in-built tab-completion for commands, should guide you in specifying the block you want. Additional states are always appended to the type using the syntax . Note that when states are not specified, or if some are left out, the default values will be used for those states.

Example: Single block patterns

Setting a selection to stone:

//set stone

Setting a selection to a note block with a specific instrument and pitch:

//set note_block

Setting a selection to an oak stair block facing east with the bigger part on top:

//set oak_stairs

Random Pattern

This pattern allows setting random blocks from any number of other patterns. The basic form is as simple as a comma-separated list of patterns, which will be chosen from evenly. You can also specify weights for each pattern with .

Example:: Random Patterns

Setting a selection to different types of stone, equally distributed:

//set stone,diorite,andesite,granite

Setting a selection to mostly red wool, with a small amount of glass (5:1 ratio, see note below):

//set 50%red_wool,10%red_stained_glass

Note

Despite the percentage sign, weights need not add up to 100. They are cumulative and will be divided by the total. That is, means 25% of blocks will be dirt, and 75% will be stone. In other words, weights are relative to each other, not to 100. Because of that, the pattern isn’t valid. If you only want to set 5% of blocks to dirt, you should use the .

Tip

You can use any other pattern as one of the choices, not just the single block pattern. Keep reading to see more patterns…

Random State Pattern

Prefixing any block type with an asterisk () will randomly choose between all states for that block for each position.

Example: Random State Pattern

Setting oak logs facing in random directions:

//set *oak_log

Clipboard Pattern

The pattern will take blocks from your clipboard in the same arrangement. This makes it easy to build one part of a repeating complicated pattern by hand, and then repeat it over and over. You can also offset the pattern by adding .

Example: Using the clipboard pattern

Replacing to your clipboard:

//replace #existing #clipboard

Using the clipboard in the first image to replace a hill. Note the repeating layers.

Using an offset to align the clipboard:

//set #clipboard@

Type or State Applying Pattern

This pattern, prefixed by , lets you set the type or states of a block without modifying everything else. This pattern will, for example, allow you to change a spiral staircase from oak to acacia without having to worry about the stairs facing in different directions and so on. You can either specify a block type (to change block type but not states, where applicable), or any number of states (to only change those states, where applicable).

Example: Type/State Applying Patterns

Replacing all oak stairs to acacia stairs, while maintaining orientation, etc:

//replace oak_stairs ^acacia_stairs

Removing the water from all waterloggable blocks:

//set ^

Doubling up all slabs:

//replace ##slabs ^

Rotating¶

Sometimes you may want to rotate your copy. The command currently lets you rotate your copy
around the Y (up-down) axis 90 degrees or at any multiple of 90 degrees. To be accurate, it actually allows you to
revolve your copy around the relative offset that you were at when you originally made the copy. If you wanted to rotate
a copy around its center, you would have had to stand in the middle of the copy when you had made it.

Note that the rotate command can also take an angle to rotate around the X or Z axis, though you must specify 0 for the
axes that you don’t use, e.g. for X axis rotation , and for Z axis . These two axes
can be used to make something vertical, horizontal, or vice versa.

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
   Set the include mask, non-matching blocks become air
Description Repeat the contents of the selection
Permissions
Usage
   # of copies to stack
   How far to move the contents each stack
   Shift the selection to the last stacked copy
   Ignore air blocks
   Also copy entities
   Also copy biomes
   Use block units
   Set the include mask, non-matching blocks become air
Description Regenerates the contents of the selection
Permissions
Usage
   The seed to regenerate with, otherwise uses world seed
   Regenerate biomes as well
Description

Deforms a selected region with an expression

The expression is executed for each block and is expected
to modify the variables x, y and z to point to a new block
to fetch. See also https://tinyurl.com/weexpr

Permissions
Usage
   The expression to use
   Use the game’s coordinate origin
   Use the placement’s coordinate origin
   Use the selection’s center as origin
Description

Hollows out the object contained in this selection

Thickness is measured in manhattan distance.

Permissions
Usage
   Thickness of the shell to leave
   The pattern of blocks to replace the hollowed area with
Description Make a forest within the region
Permissions
Usage
   The type of tree to place
   The density of the forest

Выделение

//wand — дает вам деревянный топор (топор редактирования). ЛКМ по блоку деревянным топором назначает первую позицию, ПКМ по блоку назначает вторую позицию.

//toggleeditwand — отключает деревянный топор. Теперь им можно пользоваться по прямому назначению.

//sel <cuboid|poly> — выбор формы выделяемого региона. cuboid — выделяет куб. poly — выделяет только в плоскости.

//pos1 — назначает первой позицией для выделения блок на котором вы стоите.

//pos2 — назначает второй позицией для выделения блок на котором вы стоите.

//hpos1 — назначает первой позицией для выделения блок на который вы смотрите.

//hpos2 — назначает второй позицией для выделения блок на который вы смотрите.

//chunk — выделяет весь чанк на котором вы находитесь.

//contract <amount> — уменьшает выбранный вами регион на amount блоков в направлении, в которое вы смотрите.

//contract <amount> <direction> — уменьшает выбранный вами регион на amount блоков в направлении direction (north, east, south, west, up, down).

//contract <amount> <reverse-amount> — уменьшает выбранный вами регион в двух направлениях. amount — количество блоков уменьшения в первом направлении, reverse-amount — количество блоков уменьшения в противоположном направлении, direction — направление (north, east, south, west, up, down). Например: //contract 10 7 south — уменьшит выбранный регион на 10 блоков к югу (south) и на 7 блоков к северу (north).

//expand <amount> — расширяет выбранный вами регион на amount блоков в направлении, в которое вы смотрите.

//expand <amount> <direction> — расширяет выбранный вами регион на amount блоков в направлении direction (north, east, south, west, up, down).

//expand <amount> <reverse-amount> — расширяет выбранный вами регион в двух направлениях. amount — количество блоков расширения в первом направлении, reverse-amount — количество блоков расширения в противоположном направлении, direction — направление (north, east, south, west, up, down). Например: //expand 10 7 south — расширит выбранный регион на 10 блоков к югу (south) и на 7 блоков к северу (north).

//expand vert — максимально расширит выбранный вами регион вверх и вниз.

//outset <amount> — Расширяет выбранный регион в каждом направлении.

//inset <amount> — Сужает выбранный регион в каждом направлении.

//shift <amount> — перемещает регион выбора. Не перемещает содержимое региона. amount — расстояние, direction (north, east, south, west, up, down).

//size — введите что-бы узнать размер выделенного региона.

//count <block> — введите что бы узнать сколько блоков чего либо (block) находится в выбранном регионе.

//distr — введите для получения списка блоков находящихся в выбранном регионе.

Utility Commands¶

Description Fill a hole
Permissions
Usage
   The blocks to fill with
   The radius to fill in
   The depth to fill
Description Fill a hole recursively
Permissions
Usage
   The blocks to fill with
   The radius to fill in
   The depth to fill
Description Drain a pool
Permissions
Usage
   The radius to drain
   Also un-waterlog blocks

(or )

Description Fix lava to be stationary
Permissions
Usage
   The radius to fix in

(or )

Description Fix water to be stationary
Permissions
Usage
   The radius to fix in

(or )

Description Remove blocks above your head.
Permissions
Usage
   The apothem of the square to remove from
   The maximum height above you to remove from

(or )

Description Remove blocks below you.
Permissions
Usage
   The apothem of the square to remove from
   The maximum height below you to remove from

(or )

Description Remove blocks near you.
Permissions
Usage
   The mask of blocks to remove
   The radius of the square to remove from

(or )

Description Replace nearby blocks
Permissions
Usage
   The radius of the square to remove in
   The mask matching blocks to remove
   The pattern of blocks to replace with

(or )

Description Simulates snow
Permissions
Usage
   The radius of the cylinder to snow in
   The height of the cylinder to snow in
   Stack snow layers

(or )

Description Thaws the area
Permissions
Usage
   The radius of the cylinder to thaw in
   The height of the cylinder to thaw in

(or )

Description Converts dirt to grass blocks in the area
Permissions
Usage
   The radius of the cylinder to convert in
   The height of the cylinder to convert in
   Also convert coarse dirt

(or , , , , )

Description Extinguish nearby fire
Permissions
Usage
   The radius of the square to remove in
Description Kill all or nearby mobs
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

(or , )

Description Remove all entities of a type
Permissions
Usage
   The type of entity to remove
   The radius of the cuboid to remove from

(or , , , )

Description Evaluate a mathematical expression
Permissions
Usage
   Expression to evaluate
Description Displays help for WorldEdit commands
Permissions
Usage
   List sub-commands of the given command, if applicable
   The page to retrieve
   The command to retrieve help for

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

Generation Commands¶

Description Generates a hollow cylinder.
Permissions
Usage
   The pattern of blocks to generate
   The radii of the cylinder. 1st is N/S, 2nd is E/W
   The height of the cylinder
Description Generates a cylinder.
Permissions
Usage
   The pattern of blocks to generate
   The radii of the cylinder. 1st is N/S, 2nd is E/W
   The height of the cylinder
   Make a hollow cylinder
Description Generates a hollow sphere.
Permissions
Usage
   The pattern of blocks to generate
   The radii of the sphere. Order is N/S, U/D, E/W
   Raise the bottom of the sphere to the placement position
Description Generates a filled sphere.
Permissions
Usage
   The pattern of blocks to generate
   The radii of the sphere. Order is N/S, U/D, E/W
   Raise the bottom of the sphere to the placement position
   Make a hollow sphere
Description Generate a forest
Permissions
Usage
   The size of the forest, in blocks
   The type of forest
   The density of the forest, between 0 and 100
Description Generate pumpkin patches
Permissions
Usage
   The size of the patch
Description Generate a hollow pyramid
Permissions
Usage
   The pattern of blocks to set
   The size of the pyramid
Description Generate a filled pyramid
Permissions
Usage
   The pattern of blocks to set
   The size of the pyramid
   Make a hollow pyramid

(or , )

Description

Generates a shape according to a formula.

See also https://tinyurl.com/weexpr.

Permissions
Usage
   The pattern of blocks to set
   Expression to test block placement locations and set block type
   Generate a hollow shape
   Use the game’s coordinate origin
   Use the placement’s coordinate origin
   Use the selection’s center as origin

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

Control Structures¶

if/else

if (<condition>) <true-branch>
if (<condition>) <true-branch> else <false-branch>
  • is evaluated to decide which branch to execute.
  • Everything greater than zero is interpreted as true and everything else as false.
  • and can either be single statements delimited with a semicolon or block statements.

Note: An else keyword is always associated with the last if.
This allows elseif constructs like these:

if (<condition 1>) <true-code 1> else if (<condition 2>) <true-code 2> else <false-code>

Loops

Loops can at most loop 256 times.

while

while (<condition>) <body>
do <body> while (<condition>);
  • is evaluated to decide whether to continue looping.
  • can either be a single statement delimited with a semicolon or a block statement.
  • do-while checks the condition after executing the body.

Java/C-style for

for (<init>; <condition>; <increment>) <body>
  • , and are single expressions.
  • can either be a single statement delimited with a semicolon or a block statement.

Execution steps

First, is evaluated once, then, each iteration follows these steps:

  1. If evaluates as less than or equal to zero (i.e. false), the loop is aborted.
  2. is executed.
  3. is executed.

Simple for

for (<counter> = <first>, <last>) <body>
  • is a variable used to count the iterations.
  • and are single expressions.
  • can either be a single statement delimited with a semicolon or a block statement.

Execution steps

First, an internal counter is set to . Then, each iteration follows these steps:

  1. If the internal counter exceeds , the loop is aborted.
  2. is set to the internal counter.
  3. <body> is executed.
  4. <counter> is incremented by 1.0.

and are only evaluated once.

Selection Modes¶

Using the command allows you to change between different shapes. It is recommended to install the CUI mod when using more complex shapes so you can visualize what you’re selecting.

The standard cuboid selection mode, described above.

Left-click to select first point. All subsequent points are selected by right-clicking. Every right-click will extend the cuboid selection to encompass the new point.

Left-click to select first point. All subsequent points are selected by right-clicking. Every right-click will add an additional point. The top and bottom will always encompass your highest and lowest selected points.

Left-click to choose center, right-click to extend. You can control the radii along the x, y, and z planes individually depending on where you click.

Left-click to select center, right-click to extend. Selection will always be a sphere from the first point which has a radius to the second point.

Left-click to choose center, right click to extend. You can control the x and z radii, while the height will always encompass your highest and lowest points.

Left-click to select first point. All subsequent points are selected by right clicking. The selection is a convex hull encompassing all your selected points.

Functions¶

Math Functions

The expression parser provides the following functions from the Java Math library:

Returns the absolute value of a number.
Returns the arc cosine of a value; the returned angle is in the range 0.0 through pi.
Returns the arc sine of a value; the returned angle is in the range -pi/2 through pi/2.
Returns the angle theta from the conversion of rectangular coordinates (x, y) to polar coordinates (r, theta).
Returns the arc tangent of a value; the returned angle is in the range -pi/2 through pi/2.
Returns the cube root of a value.
Returns the smallest (closest to negative infinity) value that is greater than or equal to the argument and is equal to a mathematical integer.
Returns the trigonometric cosine of an angle.
Returns the hyperbolic cosine of a value.
Returns Euler’s number e raised to the power of a value.
Returns the largest (closest to positive infinity) value that is less than or equal to the argument and is equal to a mathematical integer.
Returns the natural logarithm (base e) of a value.
Returns the natural logarithm (base e) of a value.
Returns the base 10 logarithm (base e) of a value.
Returns the greatest of the values. (supports 2 and 3 arguments)
Returns the smallest of the values. (supports 2 and 3 arguments)
Returns the number that is closest in value to the argument and is equal to a mathematical integer.
Returns the closest number to the argument
Returns the trigonometric sine of an angle.
Returns the hyperbolic sine of a value.
Returns the correctly rounded positive square root of a value.
Returns the trigonometric tangent of an angle.
Returns the hyperbolic tangent of a value.

Additional Functions

Additionally, it provides the following functions:

Rotates the given coordinate pair by the given angle, in radians.
Swaps the contents of the 2 given variables.
Returns a random positive number less than 1.0.
Returns a random positive integer less than max.
Generates perlin noise with the given parameters.
Generates voronoi noise with the given parameters.
Generated ridged multi fractal noise with the given parameters.

Block Query Functions

The following functions can be used to query blocks in a world in an editing context. Note that they still use legacy ID and data, so they may have undefined behaviors for new (1.13+) blocks.

Returns true if the block at the given coordinates has the given legacy id and data value. If type or data are variables, the id and data of the block will be assigned to that variable.
Like query, except with an offset from the currently evaluated block coordinates
Like query, except with absolute world coordinates

Special Block Data Syntax¶

Some blocks have additional syntax for setting extra information.

Sign Text

You can set text on signs by separating it with a pipe symbol (). Note that if the text has spaces, you must wrap the entire pattern in quotes .

Example: Setting sign text

Simple Example:

//set oak_sign|Line1|Line2

With spaces and rotation:

//set "oak_wall_sign|Hello world|Second|Third line"

Player Heads

You can set the skin of a player head by specifying a username after the pipe symbol.

Example: Setting a skin on a head

//set player_head|dinnerbone

Mob Spawners

You can set the type of mob to be spawned (again via the pipe symbol). Note that the name of the mob must be an . Prefixing minecraft: is optional, modded mobs must have a namespace.

Example: Creating a squid spawner

//set spawner|squid