diff --git a/doc/en/block-properties.md b/doc/en/block-properties.md index 3bede279e..6c038c693 100644 --- a/doc/en/block-properties.md +++ b/doc/en/block-properties.md @@ -112,6 +112,8 @@ Properties available for variance: - model-name - texture - texture-faces +- hitbox +- hitboxes - model-primitives (deprecated) Variants are managed via `block.set_variant(x, y, z, index)`. @@ -142,6 +144,26 @@ In this example: - Variant 1 = `stairs_left` (from variants[0]) - Variant 2 = `stairs_right` (from variants[1]) +### Hitbox variants + +A variant can override `hitbox` or `hitboxes`. Variants without them inherit the root hitboxes. Collisions, raycasts, block selection and `aabb` models use the hitboxes of the current variant. + +```json +{ + "model": "aabb", + "hitbox": [0.0, 0.0, 0.0, 1.0, 0.5, 1.0], + "rotation": "pipe", + "state-based": { + "bits": 1, + "variants": [ + { "hitbox": [0.0, 0.0, 0.0, 1.0, 1.0, 1.0] } + ] + } +} +``` + +For extended blocks the variant is taken from the origin segment. + ## Lighting ### *emission* diff --git a/doc/ru/block-properties.md b/doc/ru/block-properties.md index e6b0ceb85..e87686619 100644 --- a/doc/ru/block-properties.md +++ b/doc/ru/block-properties.md @@ -113,6 +113,8 @@ - model-name - texture - texture-faces +- hitbox +- hitboxes - model-primitives (устарело) Управление состоянием производится через `block.set_variant(x, y, z, index)`. @@ -143,6 +145,26 @@ - Вариант 1 = `stairs_left` (из variants[0]) - Вариант 2 = `stairs_right` (из variants[1]) +### Хитбоксы по вариантам + +Вариант может переопределять `hitbox` или `hitboxes`. Варианты без них наследуют хитбоксы из корня. Коллизии, рейкасты, выделение блока и модели `aabb` используют хитбоксы текущего варианта. + +```json +{ + "model": "aabb", + "hitbox": [0.0, 0.0, 0.0, 1.0, 0.5, 1.0], + "rotation": "pipe", + "state-based": { + "bits": 1, + "variants": [ + { "hitbox": [0.0, 0.0, 0.0, 1.0, 1.0, 1.0] } + ] + } +} +``` + +Для расширенных блоков вариант берётся из сегмента-источника. + ## Освещение ### Излучение - *emission*: