From 65b88356984ce549dc69179a17393c716790bc33 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 24 Dec 2024 15:53:26 +0300
Subject: [PATCH] update doc/*/block-properties.md (model-name)

---
 doc/en/block-properties.md | 10 ++++++++++
 doc/ru/block-properties.md | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/doc/en/block-properties.md b/doc/en/block-properties.md
index 6400c910f..87df173b6 100644
--- a/doc/en/block-properties.md
+++ b/doc/en/block-properties.md
@@ -35,6 +35,16 @@ Block model type from list:
 - "X" - grass model (two crossed sprites)
 - "aabb" - model based of block hitbox (complex hitbox will be combined into one). Examples: pipes, bulbs, panels.
 
+### *model-name*
+
+In addition to built-in model types, you can use your own, loaded from file.
+
+The property specifies the model name without `entry_point:models/` nor extension.
+
+> [!WARNING]
+> Textures (materials) used in the model must be in the `blocks` atlas and specified in the *atlas-texture* format:
+> `blocks:texture_name`
+
 ### *draw-group*
 
 Integer specifying number of block draw group (render order). Used for semi-transparent blocks.
diff --git a/doc/ru/block-properties.md b/doc/ru/block-properties.md
index 366cf0fb3..2f958e889 100644
--- a/doc/ru/block-properties.md
+++ b/doc/ru/block-properties.md
@@ -35,6 +35,16 @@
 - "X" - модель травы (крест из двух спрайтов)
 - "aabb" - модель, соответствующая хитбоксу блока (составной хитбокс будет объединен в один). Примеры: трубы, лампочки, панели.
 
+### Имя модели - *model-name*
+
+Кроме встроенных типов моделей, можно использовать собственные, загружаемые из файлов.
+
+В свойстве указывается имя модели без `точка_входа:models/` и расширения.
+
+> [!WARNING]
+> Текстуры (материалы), использующиеся в модели, должны находиться в атласе `blocks` и указываться в соответствующем формате:
+> `blocks:имя_текстуры`
+
 ### Группа отрисовки - *draw-group*
 
 Целое число определяющее номер группы отрисовки данного блока.