Changes between Version 38 and Version 39 of CustomBlocks


Ignore:
Timestamp:
05/28/24 16:14:47 (6 months ago)
Author:
admin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • CustomBlocks

    v38 v39  
    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_scheme` ||             || String  || ^2^)      || Overrides the detected horizontal orientation scheme. Can be `none` to indicate that the block cannot be rotated or mirrored horizontally, or a valid horizontal orientation scheme name (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 [#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])                                                ||
    6767
    6868^1^) The default value is guessed based on the block name
     
    123123== Horizontal orientation scheme ==
    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:
     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:
    126126
    127127||= Name =||= Description =||
    128128|| `none` || The block cannot be rotated or mirrored ||
    129129|| `axis` || `axis` property containing `x`, `y` or `z` ||
    130 || `cardinal_directions` || `north`, `east`, `south` _and_ `west` properties, each containing some arbitrary value
     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` ||
    131138
    132139== Example ==