Skip to content
mikeprimm edited this page Jan 3, 2014 · 6 revisions

The following are examples of schematic specifications:

sch123

This selects the schematic named sch123, and applies it without rotating it or flipping it.

sch1*

This selects any schematics starting with sch1 (including sch123 and sch124, for example), and applies it without rotating it or flipping it. If more than one matches, each use of the tool selects one randomly.

^sch1.*

This is the regex equivalent of the sch1* example, above.

sch123@90

This selects the schematic named sch123, and rotates it 90 degrees before applying it.

sch123@0N

This selects the schematic named sch123, rotates it 0 degrees (no rotation), and then flips it north-to-south before applying it.

sch123@*

This selects the schematic named sch123, and randomly rotates it 0, 90, 180, or 270 degrees each time it is applied.

sch123@0*

This selects the schematic named sch123, rotates it 0 degrees (no rotation), and then flips it randomly no flipping, north-to-south, or east-to-west) each time it is applied.

sch123@**

This selects the schematic named sch123, and randomly rotates it 0, 90, 180, or 270 degrees AND randomly flips it (none, north-south, east-west) each time it is applied.

sch123^2

This selects the schematic named sch123 and shifts its position up by 2, when applied. (Requires v0.4 or later).

When more than one schematic specification is selected, each application of the brush will result in one of the specifications being randomly selected (with any random rotation and/or flipping being done after that selection). The percentage chance of a specific schematic being selected can be controlled by providing the :weight suffix. When provided, the weight determines the percentage change of that schematic being selected. Any schematics not specifying a weight will share equally in the change of being selected for any remaining percentage. For example:

sch1:20 sch2:30 sch3 sch4 sch5 sch6 sch7

Would result in a 20% chance for sch1 to be selected, a 30% chance for sch2, and the remaining 50% being divided equally between sch3, sch4, sch5, sch6, and sch7 (10% each).

//schbr Examples

//schbr sch1

Use sch1 as the brush (no rotation, flipping)

//schbr sch1:20 sch2:30 sch3 sch4 sch5 sch6 sch7

Randomly select between sch1 to sch7, with the previously mentioned percentages.

//schbr &schsetA

Use the schematic set schsetA as the brush.

//schbr &schsetA -incair

Use the schematic set schsetA as the brush, and apply any air blocks in the schematics when pasting them.

//schbr &schsetA -replaceall

Use the schematic set schsetA as the brush, and replace existing non-air blocks with the schematics contents when pasting them.

//schbr &schsetA -yoff:1

Use the schematic set schsetA as the brush, and shift the placement position up 1 block from the default). The default placement is -place:CENTER, which is the same as the standard Clipboard brush (schematic is applied vertically centered on the click position of the brush).

//schbr &schsetA -place:DROP

Use the schematic set schsetA as the brush, and place the schematic so that the bottommost layer of the schematic that has non-air blocks is placed just above the click position of the brush (that is, it 'drops' until it lands with its bottommost block just above the vertical position where the brush was clicked).

//schbr &schsetA -place:BOTTOM

Use the schematic set schsetA as the brush, and place the schematic so that the bottommost layer of the schematic is placed just above the click position of the brush.

//schset examples

//schset create schsetA sch1:20 sch2:30 sch3

Define schematic set schsetA, and include sch1, sch2, and sch3 with given weights.

//schset append schsetA sch4 sch5 sch6 sch7

Add sch4, sch5, sch6, and sch7 to schematic set schsetA.

//schset remove schsetA sch7

Remove sch7 from schematic set schsetA.

//schset delete schsetA

Delete schematic set schsetA.

//schset setdesc schsetA This is my schematic set

Sets the description of schematic set schsetA to "This is my schematic set"