Created Свойства блоков (markdown)

Свойства-блоков.md

@@ -0,0 +1,100 @@
+# Вид
+
+## Текстура - `texture`
+
+Название текстуры блока (указывается только имя, без расширения или пути к файлу)
+
+Файл текстуры должен находиться в `res/textures/blocks/` и иметь формат **png**
+
+## Текстурирование сторон - `texture-faces`
+
+>[!IMPORTANT]
+> Не может использоваться одновременно с `texture`
+
+Массив из 6 названий текстур, позволяющих указать их для каждой из сторон отдельно.
+
+Пример: 
+```json
+"texture-faces": [
+    "grass_side",
+    "grass_side",
+    "dirt",
+    "grass_top",
+    "grass_side",
+    "grass_side"
+]
+```
+
+## Модель - `model`
+
+Модель блока из списка:
+- "block" - используется по-умолчанию для всех обычных блоков
+- "none" - невидимый блок (пример: воздух)
+- "X" - модель травы (крест из двух спрайтов)
+- "aabb" - модель, соответствующая хитбоксу блока (трубы, лампочки, панели). Без указания хитбокса будет выглядеть как обычный блок
+
+## Группа отрисовки - `draw-group`
+
+Целое число определяющее номер группы отрисовки данного блока. 
+Актуально для полупрозрачных блоков - решает проблемы невидимых сторон блоков за этим блоком.
+
+## Вращение - `rotation`
+
+Профиль вращения (набор положений, в которые можно установить блок) из списка:
+
+- "none" - вращение блока отключено (по-умолчанию)
+- "pipe" - профиль "труба". Примеры блоков: бревно, труба, лампочка
+- "pane" - профиль "панель". Примеры блоков: панель, дверь, табличка
+
+# Освещение
+
+## Излучение - `emission`
+
+Массив из трех целых чисел - R, G, B освещения от 0 до 15.
+
+Примеры:
+
+- `[15, 15, 15]` - самый яркий белый свет
+- `[7, 0, 0]` - слабый красный свет
+- `[0, 0, 0]` - блок не излучает свет (по-умолчанию)
+
+
+## Светопроводимость - `light-passing`
+
+При значении `true` блок проводит свет от излучающих блоков.
+
+## Солнечная светопроводимость - `sky-light-passing`
+
+При значении `true` блок не препятствует прохождению вертикального луча солнечного света.
+
+# Физика
+
+## Препятствие - `obstacle`:
+
+Значение false отключает хитбокс у блока (позволяет игроку проходить сквозь блок)
+
+## Хитбокс - `hitbox`:
+
+Массив из 6 чисел описывающих смещение и размер хитбокса блока.
+
+Числа указываются в диапазоне [0.0, 1.0] - т.е в пределах блока.
+
+Массив `[0.25, 0.0, 0.5,  0.75, 0.4, 0.3]` описывает хитбокс: 
+- шириной (с востока на запад) 0.75 м
+- высотой 0.4 м
+- длиной (с юга на север) 0.3 м
+- смещен на 0.25 м на запад
+- смещен на 0.0 м вверх
+- смещен на 0.5 м на север
+
+## Выделяемость - `selectable`
+
+При значении в `false` курсор будет игнорировать блок, выделяя тот, что находится за ним.
+
+## Заменяемость - `replaceable`
+
+При значении в `true` на месте блока можно установить любой другой блок. Пример: вода, трава, цветок.
+
+## Разрушаемость - `breakable`
+
+При значении в `false` блок нельзя сломать.