Differences

This shows you the differences between two versions of the page.

--- minecraft:mod:my-mods:bunyedit:argument-types [2024/02/21 02:13] – further explanation raccoon
+++ minecraft:mod:my-mods:bunyedit:argument-types [2024/02/24 04:45] (current) – raccoon
@@ Line 16: / Line 16: @@
 <code>
 <id>[:<meta>]
+id: (<int>|<key>)
+key: <str>[.<str>...]
 </code>
@@ Line 23: / Line 27: @@
 the special key "air" can be used as an alias for id 0.
+===== pattern =====
+represents a transformation that can be applied to blocks.
+there are currently two:
+the ''block'' type seen above can be interpreted as a pattern that sets any block to that block.
+----
+the ''weighted-random'' pattern combines several `block`s, seperated by slashes, with an optional integer weight attached:
+<code>
+<weighted-block>[/<weighted-block>...]
+weighted-block: [<weight>*]<block>
+</code>
+it randomly chooses one of the blocks to place. higher-weighted blocks are more likely.
+example:
+<code>
+wool/3*wool:3/3*wool:6
+</code>
+===== filter =====
+<code>
+<component>[/<component...]
+component: [!](<filterblock>|#<material>)
+filterblock: <fuzzy-id>[:<fuzzy-meta>]
+fuzzy-id: (<int>|<range>|<fuzzy-key>|*)
+fuzzy-meta: (<int>|<range>|*)
+range: (<int>..<int>|<int>..|..<int>)
+fuzzy-key: <str>[.<str>...][;]
+</code>
+determines whether a block should be modified or not.
+you can place a "!" before each filter component to invert it.
+you can specify a (potentially unbounded) range instead of an int for ID and meta.
+when you match a block by translation key, ''grass'' will match ''grass.retro'' (for example). you can avoid this behavior by instead typing ''grass;'' (with a semicolon at the end).
 ===== axis =====
@@ Line 39: / Line 91: @@
 represents a specific direction.
+a letter represents an absolute direction ((N)orth, (E)ast, (S)outh, (W)est, (U)p, (D)own).
 ''^'' specifies the direction the player is looking in.
+===== bound =====
+<code>
+<component>[,<component>...]
+component: <boundDirection>[<boundDirection>...][magnitude=0]
+boundDirection: N|E|S|W|U|D|F|B|L|R|*
+magnitude: <int>
+</code>
+//note: this section documents the way bound arguments will work in 0.5.0. in 0.4.x the default magnitude is 1, and each component can only specify one ''boundDirection''.//
+represents a relative selection that is bigger/smaller than the existing selection in the given directions.
+direction can be specified absolutely, or relative to the direction the player is facing ((F)orward, (B)ackward, (L)eft, (R)ight).
+''*'' is shorthand for "all directions".
+magnitude represents a number of blocks to grow by in that direction. a negative number can be specified to allow for shrinking.
+examples:
+<code>
+* : the same as the current selection.
+FB1,LR2 : expanded by one block forward and backward, two blocks left and right
+</code>