update doc/*/block-properties.md

doc/ru/block-properties.md

@@ -34,6 +34,7 @@
 - "none" - невидимый блок (пример: воздух)
 - "X" - модель травы (крест из двух спрайтов)
 - "aabb" - модель, соответствующая хитбоксу блока (составной хитбокс будет объединен в один). Примеры: трубы, лампочки, панели.
+- "custom" - используется при указании собственной модели через *model-name*
 
 ### Имя модели - *model-name*
 
@@ -72,6 +73,39 @@
 При приближении к блоку движок создаст эмиттер, который будет работать 
 до разрушения блока или отдаления камеры на некоторое расстояние.
 
+## Варианты
+
+Некоторые свойства могут варьироваться динамически, в зависимости от номера варианта, хранимого в пользовательских битах блока.
+
+Параметры вариативности указываются в блоке `state-based`:
+
+```json
+{
+    ...
+    "state-based": {
+        "offset": 0,
+        "bits": 4,
+        "variants": [
+            {...},
+            ...
+        ]
+    }
+}
+```
+
+- `offset` определяет битового смещения, с которого начинается индекс варианта. (По-умолчанию - 0)
+- `bits` определяет число бит, кодирующих индекс варианта. (По-умолчанию - 4).
+На данный момент максимальное число вариантов - 16, поэтому указание более 4 бит не имеет практического смысла.
+
+Доступные для вариативности свойства:
+- model
+- model-name
+- texture
+- texture-faces
+- model-primitives (устарело)
+
+Управление состоянием производится через `block.set_variant(x, y, z, index)`.
+
 ## Освещение
 
 ### Излучение - *emission*: