patterns.md

Introduction

This page is currently being revised.

Patterns are used in various commands when changing blocks. e.g. //set <pattern> and //material <pattern>

Syntax

Blocks

Use the name or id of a block (e.g. stone).

Inventory

You can use hand, or e.g. slot5 to use blocks from your inventory.

Multiple patterns

Use a comma (,) to randomly use a block from multiple patterns. For specific ratios you can use % e.g. 80%stone,20%planks

Arguments

Pattern arguments should be inside square brackets e.g. #simplex[10][stone,wood]

Pattern list

#offset <dx> <dy> <dz> <pattern>

Desc: Offset a pattern

#mask <mask> <pattern-true> <pattern-false>

Desc: Apply a pattern depending on a mask

#spread <dx> <dy> <dz> <pattern>

Desc: Randomly spread blocks

#buffer <pattern>

Desc: Only place a block once while a pattern is in use
Use with a brush when you don’t want to apply to the same spot twice

#color <color>

Desc: Use the block closest to a specific color

#clipboard

Desc: Use the blocks in your clipboard as the pattern

#existing

Desc: Use the block that is already there

#biome <biome>

Desc: Set the biome

= <expression>

Desc: Expression pattern: http://wiki.sk89q.com/wiki/WorldEdit/Expression_syntax

#relative <pattern>

Desc: Offset the pattern to where you click

#saturate <r> <g> <b>

Desc: Saturate the existing block with a color

#darken

Desc: Darken the existing block

#anglecolor <distance>

Desc: A darker block based on the existing terrain angle

#desaturate <percent>

Desc: Desaturated color of the existing block

#averagecolor <r> <g> <b>

Desc: Average between the existing block and a color

#fullcopy [schem|folder|url=#copy] [rotate=false] [flip=false]

Desc: Places your full clipboard at each block

#buffer2d <pattern>

Desc: Only place a block once in a column while a pattern is in use

#angledata

Desc: Block data based on the existing terrain angle

#lighten [randomize=true] [max-complexity=100]

Desc: Lighten the existing block

#!x <pattern>

Desc: The pattern will not be provided the z axis info.
Example: !x[!z[#~[#l3d[pattern]]]]

#surfacespread <distance> <pattern>

Desc: Applies to only blocks on a surface. Selects a block from provided pattern with a given ranomized offset [0, ). e.g. Use #existing to randomly offset blocks in the world, or #copy to offset blocks in your clipboard

#solidspread <dx> <dy> <dz> <pattern>

Desc: Randomly spread solid blocks

#linear2d <pattern> [xscale=1] [zscale=1]

Desc: Use the x,z coordinate to pick a block from the list

#!y <pattern>

Desc: The pattern will not be provided the y axis info

#linear3d <pattern> [xscale=1] [yscale=1] [zscale=1]

Desc: Use the x,y,z coordinate to pick a block from the list

#linear <pattern>

Desc: Sequentially set blocks from a list of patterns

#!z <pattern>

Desc: The pattern will not be provided the z axis info

#simplex <scale=10> <pattern>

Desc: Use simplex noise to randomize blocks

#perlin <scale=10> <pattern>

Desc: Use perlin noise to randomize blocks

#rmf <scale=10> <pattern>

Desc: Use ridged multi-fractal noise to randomize blocks

#voronoi <scale=10> <pattern>

Desc: Use voronoi noise to randomize blocks