Merge branch 'main' into dev

doc/ru/block-properties.md

@@ -106,6 +106,32 @@
 
 Управление состоянием производится через `block.set_variant(x, y, z, index)`.
 
+### Кастомные модели по вариантам (переключение геометрии)
+
+Для custom-моделей можно переключать геометрию по варианту. Укажите отдельный `model-name` в нужных вариантах — рендерер кэширует геометрию по паре (id блока, вариант).
+
+Базовая модель (из корня) становится вариантом 0. Массив variants соответствует индексам 1+.
+
+Пример (база + два кастомных варианта):
+```json
+{
+    "model": "custom",
+    "model-name": "stairs_middle",
+    "state-based": {
+        "bits": 4,
+        "variants": [
+            { "model": "custom", "model-name": "stairs_left" },
+            { "model": "custom", "model-name": "stairs_right" }
+        ]
+    }
+}
+```
+
+В этом примере:
+- Вариант 0 = `stairs_middle` (из корня)
+- Вариант 1 = `stairs_left` (из variants[0])
+- Вариант 2 = `stairs_right` (из variants[1])
+
 ## Освещение
 
 ### Излучение - *emission*:

doc/ru/scripting/builtins/libplayer.md

@@ -119,6 +119,18 @@ player.get_name(playerid: int) -> str
 
 Сеттер и геттер имени игрока
 
+```lua
+player.get_camera(playerid: int) -> int
+```
+
+Возвращает индекс текущей камеры игрока
+
+```lua
+player.set_camera(playerid: int, camera_index: int)
+```
+
+Переключает камеру игрока. См. [камеры](libcameras.md).
+
 ```lua
 player.set_selected_slot(playerid: int, slotid: int)
 ```

doc/ru/scripting/events.md

@@ -190,6 +190,12 @@ function on_hud_open(playerid: int)
 
 Вызывается после входа в мир, когда становится доступна библиотека hud. Здесь на экран добавляются постоянные элементы.
 
+```lua
+function on_hud_render()
+```
+
+Вызывается каждый кадр. Используется для клиентских задач, таких как анимация, управление камерой.
+
 ```lua
 function on_hud_close(playerid: int)
 ```