update doc/*/block-properties.md

This commit is contained in:
MihailRis 2026-10-31 17:19:10 +03:00
parent b8b2e4f451
commit 6f761e08b3
2 changed files with 44 additions and 0 deletions

View file

@ -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*

View file

@ -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*: