Differences

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

--- minecraft:mod:my-mods:bunyedit:argument-types [2024/02/21 01:37] – created raccoon
+++ minecraft:mod:my-mods:bunyedit:argument-types [2024/02/24 04:45] (current) – raccoon
@@ Line 10: / Line 10: @@
 prefixing with ''^'' specifies a coordinate whose value is relative and whose axes are based on the player's look direction. these look direction relative components //cannot// be intermixed with any other type.
+"sway" means left from your perspective, "heave" means upward from the top of your head, "surge" means straight ahead. if you are, say, facing north but looking up into the sky, "sway" is -X (west), "heave" is +Z (south), and "surge" is +Y (up).
 ===== block =====
 <code>
 <id>[:<meta>]
+id: (<int>|<key>)
+key: <str>[.<str>...]
 </code>
@@ Line 21: / 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 37: / 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>