docs: add :block placement to world generator

2025-11-24 21:24:30 +03:00
parent 9ccaecddd2
commit 3074836bcc
2 changed files with 32 additions and 0 deletions
@@ -430,6 +430,22 @@ end
 - точка_а, точка_б - vec3, vec3 позиции начала и конца тоннеля.
 - радиус - радиус тоннеля в блоках

+Одиночный блок:
+```lua
+{":block", id_блока, позиция, [поворот], [приоритет]}
+```
+
+Где:
+- id_блока: числовой runtime‑id блока, который нужно поставить.
+- позиция: vec3 позиция в блоках относительно начала текущего чанка.
+- поворот: 0–3, поворот вокруг оси Y. По умолчанию: 0. Для расширенных блоков (размер > 1) этот поворот применяется ко всем сегментам.
+- приоритет: целое число. Бóльший приоритет ставится позже и перезаписывает более низкий.
+
+Примечания:
+- `:block` автоматически раскладывает расширенные блоки на сегменты и заменяет любые блоки в занимаемых ячейках.
+- Размещение корректно работает на границах чанков: движок сам разносит плейсмент по затрагиваемым прототипам на основе размера/AABB блока.
+- `:block` используйте для точечных блоков; `:line` — для туннелей/линий.
+

 ### Расстановка малых структур