Changes between Version 39 and Version 40 of CustomBlocks


Ignore:
Timestamp:
05/28/24 16:22:03 (4 months ago)
Author:
admin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • CustomBlocks

    v39 v40  
    4747The data can contain the following columns. Note that you can leave out any empty columns:
    4848
    49 ||= Column                         =||= Mandatory =||= Type  =||= Default =||= Description                                                                                                                                                                                                                                                   =||
    50 || `name`                           || *           || String  ||           || The namespace and name of the block separated by a colon ("ID" or "resource location")                                                                                                                                                                          ||
    51 || `discriminator`                  ||             || String  || -         || An optional discriminator to discriminate multiple rows with the same `name`. See [#Discriminator below] for details                                                                                                                                            ||
    52 || `properties`                     ||             || String  || -         || A comma-separated list of the names and types of all the properties this block can have. See [#Properties below] for details                                                                                                                                    ||
    53 || `opacity`                        ||             || Integer || ^1^)      || The opacity of the block (how much light it blocks), from 0 (fully transparent) to 15 (fully opaque)                                                                                                                                                            ||
    54 || `receivesLight`                  ||             || Boolean || ^1^)      || Whether the block should be lit itself, despite being fully opaque (e.g. stair blocks, slabs, etc.). Only applies to fully opaque blocks; should be set to `false` for other blocks                                                                             ||
    55 || `insubstantial`                  ||             || Boolean || ^1^)      || Whether the block should be considered insubstantial. See [#Insubstantialblocks below] for details                                                                                                                                                              ||
    56 || `resource`                       ||             || Boolean || ^1^)      || Whether the block should be considered an ore or resource. These are replaced with `minecraft:stone` by the "remove resources" Merge option                                                                                                                     ||
    57 || `tileEntity`                     ||             || Boolean || `false`   || Whether the block is a tile/block entity                                                                                                                                                                                                                        ||
    58 || `tileEntityId`                   ||             || Boolean || -         || If `tileEntity` is `true`: the ID of the corresponding behaviour. This is often, but not always, the same as `name`                                                                                                                                             ||
    59 || `treeRelated`                    ||             || Boolean || ^1^)      || Whether the block is part of trees, or attached to trees. These are removed by the "remove trees" Merge option                                                                                                                                                  ||
    60 || `vegetation`                     ||             || Boolean || ^1^)      || Whether the block is a plant, other than `treeRelated`. These are removed by the "remove vegetation" Merge option                                                                                                                                               ||
    61 || `blockLight`                     ||             || Integer || 0         || How much block light the block emits, from 0 - 15                                                                                                                                                                                                               ||
    62 || `natural`                        ||             || Boolean || ^1^)      || Whether the block should be considered natural as opposed to being man-made. Chunks with blocks that are ''not'' `natural` have the Read Only layer applied during Import                                                                                       ||
    63 || `watery`                         ||             || Boolean || false     || Whether the block is always flooded with water, regardless of its properties (e.g. water plants)                                                                                                                                                                ||
    64 || `colour`                         ||             || Hex     || Magenta   || The colour in which the block should be rendered in the editor view, as a hexidecimal number in `aarrggbb` format, where `aa` should always be `ff` (opaque). When not specified, the block will be rendered in magenta                                         ||
    65 || `horizontal_orientation_schemes` ||             || String  || ^2^)      || Overrides the detected horizontal orientation scheme(s). Can be `none` to indicate that the block cannot be rotated or mirrored horizontally, or a comma-separated list of valid horizontal orientation scheme names (see [#Horizontalorientationscheme below]) ||
    66 || `vertical_orientation_scheme`    ||             || String  || ^2^)      || Overrides the detected vertical orientation scheme. Can be `none` to indicate that the block cannot be mirrored vertically, or a valid vertical orientation scheme name (see [#Verticalorientationscheme below])                                                ||
     49||= Column                         =||= Mandatory =||= Type  =||= Default =||= Description                                                                                                                                                                                                                                                    =||
     50|| `name`                           || *           || String  ||           || The namespace and name of the block separated by a colon ("ID" or "resource location")                                                                                                                                                                           ||
     51|| `discriminator`                  ||             || String  || -         || An optional discriminator to discriminate multiple rows with the same `name`. See [#Discriminator below] for details                                                                                                                                             ||
     52|| `properties`                     ||             || String  || -         || A comma-separated list of the names and types of all the properties this block can have. See [#Properties below] for details                                                                                                                                     ||
     53|| `opacity`                        ||             || Integer || ^1^)      || The opacity of the block (how much light it blocks), from 0 (fully transparent) to 15 (fully opaque)                                                                                                                                                             ||
     54|| `receivesLight`                  ||             || Boolean || ^1^)      || Whether the block should be lit itself, despite being fully opaque (e.g. stair blocks, slabs, etc.). Only applies to fully opaque blocks; should be set to `false` for other blocks                                                                              ||
     55|| `insubstantial`                  ||             || Boolean || ^1^)      || Whether the block should be considered insubstantial. See [#Insubstantialblocks below] for details                                                                                                                                                               ||
     56|| `resource`                       ||             || Boolean || ^1^)      || Whether the block should be considered an ore or resource. These are replaced with `minecraft:stone` by the "remove resources" Merge option                                                                                                                      ||
     57|| `tileEntity`                     ||             || Boolean || `false`   || Whether the block is a tile/block entity                                                                                                                                                                                                                         ||
     58|| `tileEntityId`                   ||             || Boolean || -         || If `tileEntity` is `true`: the ID of the corresponding behaviour. This is often, but not always, the same as `name`                                                                                                                                              ||
     59|| `treeRelated`                    ||             || Boolean || ^1^)      || Whether the block is part of trees, or attached to trees. These are removed by the "remove trees" Merge option                                                                                                                                                   ||
     60|| `vegetation`                     ||             || Boolean || ^1^)      || Whether the block is a plant, other than `treeRelated`. These are removed by the "remove vegetation" Merge option                                                                                                                                                ||
     61|| `blockLight`                     ||             || Integer || 0         || How much block light the block emits, from 0 - 15                                                                                                                                                                                                                ||
     62|| `natural`                        ||             || Boolean || ^1^)      || Whether the block should be considered natural as opposed to being man-made. Chunks with blocks that are ''not'' `natural` have the Read Only layer applied during Import                                                                                        ||
     63|| `watery`                         ||             || Boolean || false     || Whether the block is always flooded with water, regardless of its properties (e.g. water plants)                                                                                                                                                                 ||
     64|| `colour`                         ||             || Hex     || Magenta   || The colour in which the block should be rendered in the editor view, as a hexidecimal number in `aarrggbb` format, where `aa` should always be `ff` (opaque). When not specified, the block will be rendered in magenta                                          ||
     65|| `horizontal_orientation_schemes` ||             || String  || ^2^)      || Overrides the detected horizontal orientation scheme(s). Can be `none` to indicate that the block cannot be rotated or mirrored horizontally, or a comma-separated list of valid horizontal orientation scheme names (see [#Horizontalorientationschemes below]) ||
     66|| `vertical_orientation_scheme`    ||             || String  || ^2^)      || Overrides the detected vertical orientation scheme. Can be `none` to indicate that the block cannot be mirrored vertically, or a valid vertical orientation scheme name (see [#Verticalorientationscheme below])                                                 ||
    6767
    6868^1^) The default value is guessed based on the block name
     
    121121(`opacity` is `15`) and not insubstantial (`insubstantial` is `false`).
    122122
    123 == Horizontal orientation scheme ==
     123== Horizontal orientation schemes ==
    124124
    125 This describes how to horizontally rotate and/or mirror blocks to which that applies. !WorldPainter normally auto-detects these based on the properties that are present. A block can have multiple horizontal orientation schemes. Note that ''if'' this value is specified it will override ''all'' horizontal orientation schemes:
     125This describes how to horizontally rotate and/or mirror blocks to which that applies. !WorldPainter normally auto-detects these based on the properties that are present. A block can have multiple horizontal orientation schemes. Note that ''if'' this value is specified it will override ''all'' horizontal orientation schemes for the block:
    126126
    127 ||= Name =||= Description =||
    128 || `none` || The block cannot be rotated or mirrored ||
    129 || `axis` || `axis` property containing `x`, `y` or `z` ||
    130 || `cardinal_directions` || `north`, `east`, `south` ''and'' `west` properties, each containing some arbitrary value ||
    131 || `facing` || `facing` property containing the cardinal direction `north`, `east`, `south` or `west` ||
    132 || `facing_asym` || `facing` property containing the cardinal direction `north`, `east`, `south` or `west`. This variant is for blocks which are not symmetrical and uses rotation to implement mirroring. Not autodetected ||
    133 || `rotation` || `rotation` property containing an integer from 0 to 15 (inclusive) where 0 is south, 4 is west, etc. ||
    134 || `shape` || `shape` property containing `north_south`, `east_west`, etc. as used by Minecraft for rails ||
    135 || `stair_corner` || `shape` property set to `inner_left`, `inner_right`, `outer_left` or `outer_right` as used by e.g. Minecraft stair corner blocks ||
    136 || `type` || `type` property containing `left` or `right` ||
    137 || `hinge` || `hinge` property containing `left` or `right` ||
     127||= Name                =||= Description                                                                                                                                                                                           =||
     128|| `none`                || The block cannot be horizontally rotated or mirrored                                                                                                                                                    ||
     129|| `axis`                || `axis` property containing `x`, `y` or `z`                                                                                                                                                              ||
     130|| `cardinal_directions` || `north`, `east`, `south` ''and'' `west` properties, each containing some arbitrary value                                                                                                                ||
     131|| `facing`              || `facing` property containing the cardinal direction `north`, `east`, `south` or `west`                                                                                                                  ||
     132|| `facing_asym`         || `facing` property containing the cardinal direction `north`, `east`, `south` or `west`. This variant is for blocks which are not symmetrical and uses rotation to implement mirroring. Not autodetected ||
     133|| `rotation`            || `rotation` property containing an integer from 0 to 15 (inclusive) where 0 is south, 4 is west, etc.                                                                                                    ||
     134|| `shape`               || `shape` property containing `north_south`, `east_west`, etc. as used by Minecraft for rails                                                                                                             ||
     135|| `stair_corner`        || `shape` property set to `inner_left`, `inner_right`, `outer_left` or `outer_right` as used by e.g. Minecraft stair corner blocks                                                                        ||
     136|| `type`                || `type` property containing `left` or `right`                                                                                                                                                            ||
     137|| `hinge`               || `hinge` property containing `left` or `right`                                                                                                                                                           ||
     138
     139== Vertical orientation scheme ==
     140
     141This describes how to vertically mirror blocks to which that applies. !WorldPainter normally auto-detects this based on the properties that are present:
     142
     143||= Name               =||= Description                                            =||
     144|| `none`               || The block cannot be vertically mirrored                  ||
     145|| `half`               || `half` property containing `top` or `bottom`             ||
     146|| `up`                 || `up` property containing `true` or `false`               ||
     147|| `type`               || `type` property containing `top` or `bottom`             ||
     148|| `up_down`            || `up` ''and' `down` property containing `true` or `false` ||
     149|| `vertical_direction` || `vertical_direction` property containing `up` or `down`  ||
    138150
    139151== Example ==