From 77b55291da21eb78f91e05e5b91d57a913756706 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 4 Dec 2025 17:35:39 +0300
Subject: [PATCH 1/2] document tick-interval

---
 doc/en/block-properties.md | 14 ++++++++++----
 doc/en/scripting/events.md |  2 +-
 doc/ru/block-properties.md | 16 +++++++++++-----
 doc/ru/scripting/events.md |  2 +-
 4 files changed, 23 insertions(+), 11 deletions(-)

diff --git a/doc/en/block-properties.md b/doc/en/block-properties.md
index 82811b630..274ac706d 100644
--- a/doc/en/block-properties.md
+++ b/doc/en/block-properties.md
@@ -216,10 +216,6 @@ Item will be chosen on MMB click on the block.
 
 Example: block `door:door_open` is hidden, so you need to specify `picking-item: "door:door.item"` to bind it to not hidden `door:door` block item.
 
-### *script-name*
-
-Used to specify block script name (to reuse one script to multiple blocks). Name must not contain `packid:scripts/` and extension. Just name.
-
 ### *ui-layout*
 
 Block UI XML layout name. Default: string block id.
@@ -316,6 +312,16 @@ Example: `base:dirt.item`.
 
 To generate loot, the function `block_loot(block_id: int)` in the `base:util` module should be used.
 
+## Other properties
+
+### *script-name*
+
+Used to specify block script name (to reuse one script to multiple blocks). Name must not contain `packid:scripts/` and extension. Just name.
+
+### Tick Interval - *tick-interval*
+
+The interval in ticks (1/20th of a second). A value of 20 results in an on_block_tick call interval of one second.
+
 ## Methods
 
 Methods are used to manage the overwriting of properties when extending a block with other packs.
diff --git a/doc/en/scripting/events.md b/doc/en/scripting/events.md
index fc8bb27f8..6ecc5db27 100644
--- a/doc/en/scripting/events.md
+++ b/doc/en/scripting/events.md
@@ -48,7 +48,7 @@ Called on random block update (grass growth)
 function on_blocks_tick(tps: int)
 ```
 
-Called tps (20) times per second. Use 1/tps instead of `time.delta()`.
+Called tps (20 / tick-interval) times per second. Use 1/tps instead of `time.delta()`.
 
 ```lua
 function on_block_tick(x, y, z, tps: number)
diff --git a/doc/ru/block-properties.md b/doc/ru/block-properties.md
index 4569cc493..828595f8f 100644
--- a/doc/ru/block-properties.md
+++ b/doc/ru/block-properties.md
@@ -226,11 +226,6 @@
 
 Пример: блок `door:door_open` скрыт (hidden) поэтому указывается `picking-item: "door:door.item"`
 
-### Имя скрипта - *script-name*
-
-Позволяет указать название скрипта блока. Свойство обеспечивает возможность использования одного скрипта для нескольких блоков.
-Название указывается без `пак:scripts/` и расширения.
-
 ### Имя макета UI - *ui-layout*
 
 Позволяет указать id XML-макета интерфейса блока. По-умолчанию используется строковый id блока.
@@ -325,6 +320,17 @@
 
 Для генерации лута следует использовать функцию `block_loot(block_id: int)` в модуле `base:util`.
 
+## Другое
+
+### Имя скрипта - *script-name*
+
+Позволяет указать название скрипта блока. Свойство обеспечивает возможность использования одного скрипта для нескольких блоков.
+Название указывается без `пак:scripts/` и расширения.
+
+### Интервал тактов - *tick-interval*
+
+Интервал в тактах мира (1/20 секуды). Значение 20 приводит к интервалу вызова on_block_tick равному одной секунде.
+
 ## Методы
 
 Методы используются для управлением перезаписью свойств при расширении блока другими паками.
diff --git a/doc/ru/scripting/events.md b/doc/ru/scripting/events.md
index 83baef253..7266a4356 100644
--- a/doc/ru/scripting/events.md
+++ b/doc/ru/scripting/events.md
@@ -48,7 +48,7 @@ function on_random_update(x, y, z)
 function on_blocks_tick(tps: int)
 ```
 
-Вызывается tps (20) раз в секунду. Используйте 1/tps вместо `time.delta()`.
+Вызывается tps (20 / tick-interval) раз в секунду. Используйте 1/tps вместо `time.delta()`.
 
 ```lua
 function on_block_tick(x, y, z, tps: number)

From ab640440cc95a12a303a81a9aa12e6c54e773ab1 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 4 Dec 2025 20:30:33 +0300
Subject: [PATCH 2/2] update doc/*/block-properties.md

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

diff --git a/doc/en/block-properties.md b/doc/en/block-properties.md
index 274ac706d..6233ea7ec 100644
--- a/doc/en/block-properties.md
+++ b/doc/en/block-properties.md
@@ -159,6 +159,8 @@ Face culling mode:
 - **optional** - face culling among blocks of the same rendering group can be disabled via the `graphics.dense-render` setting.
 - **disabled** - face culling among blocks of the same rendering group disabled.
 
+In `optional` mode, disabling `graphics.dense-render` will use the `*_opaque` texture variant (if available).
+
 ## Physics
 
 ### *obstacle*
diff --git a/doc/ru/block-properties.md b/doc/ru/block-properties.md
index 828595f8f..b70c5376d 100644
--- a/doc/ru/block-properties.md
+++ b/doc/ru/block-properties.md
@@ -168,6 +168,8 @@
 - **optional** - отсечение граней среди блоков одной группы отрисовки можно отключить через настройку `graphics.dense-render` (Плотный рендер блоков).
 - **disabled** - отсечение граней среди блоков одной группы отрисовки отключено.
 
+В режиме `optional` при отключении `graphics.dense-render` будет использоваться `*_opaque` вариант текстуры (при наличии).
+
 ## Физика
 
 ### Препятствие - *obstacle*