From 2b5acfde6279526f476ca58e40407bba415779c0 Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Mon, 27 Jul 2026 21:38:27 +0300
Subject: [PATCH] update doc/*/libworld.md & update doc/*/entity-properties.md

---
 doc/en/entity-properties.md           | 4 ++++
 doc/en/scripting/builtins/libworld.md | 2 ++
 doc/ru/entity-properties.md           | 6 +++++-
 doc/ru/scripting/builtins/libworld.md | 2 ++
 4 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/doc/en/entity-properties.md b/doc/en/entity-properties.md
index 4934e4264..b0aee9aea 100644
--- a/doc/en/entity-properties.md
+++ b/doc/en/entity-properties.md
@@ -67,6 +67,10 @@ If true - the entity blocks the placement of a block that intersects with the en
 
 Default value: *true*.
 
+### *selectable*
+
+If set to `false` the cursor will ignore the entity, passing the ray.
+
 ### *sensors*
 
 A sensor is an area attached to a physical body that detects the entry of other bodies into it.
diff --git a/doc/en/scripting/builtins/libworld.md b/doc/en/scripting/builtins/libworld.md
index 54b44fe15..5ff749cb8 100644
--- a/doc/en/scripting/builtins/libworld.md
+++ b/doc/en/scripting/builtins/libworld.md
@@ -92,6 +92,8 @@ world.raycast(
         -- exclusion filtering mode:
         --   if true, filter_entities defines the list of ignored entity types
         entities_exclusion: bool = false,
+        -- include entities with selectable=false
+        nonselect_blocks: bool = false;
 
         [==[ additional parameters (blocks) ]==]
         -- id of the block types used for filtering
diff --git a/doc/ru/entity-properties.md b/doc/ru/entity-properties.md
index 47126a258..2f5ca3791 100644
--- a/doc/ru/entity-properties.md
+++ b/doc/ru/entity-properties.md
@@ -61,12 +61,16 @@
 
 ### Блокирование - *blocking*
 
-Определяет блокирует ли сущность установку блока, пересекающегося с хитбоксом сущности.
+Определяет, блокирует ли сущность установку блока, пересекающегося с хитбоксом сущности.
 
 *В будущем будет также блокировать движение других сущностей.*
 
 Значение по-умолчанию: *true*.
 
+### Выделяемость - *selectable*
+
+При значении в `false` курсор будет игнорировать cущность, пропуская луч далее.
+
 ### Список сенсоров - *sensors*
 
 Сенсор - область пространства, привязанная к физическому телу, детектирующее попадание в него других тел.
diff --git a/doc/ru/scripting/builtins/libworld.md b/doc/ru/scripting/builtins/libworld.md
index 6b945aa76..52812f295 100644
--- a/doc/ru/scripting/builtins/libworld.md
+++ b/doc/ru/scripting/builtins/libworld.md
@@ -91,6 +91,8 @@ world.raycast(
         -- исключающий режим фильтрации:
         --   при значении (true) filter_entities определяет список игнорируемых
         entities_exclusion: bool = false,
+        -- учитывать сущности с selectable=false
+        nonselect_entities: bool = false;
         
         [==[ дополнительные параметры (блоки) ]==]
         -- id типов блоков используемых для фильтрации