From 145a7b62739fa3f1bd5a5a5d9480f266533ef89f Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Tue, 25 Nov 2025 18:28:39 +0300
Subject: [PATCH] update doc/*/scripting/builtins/libentities.md

---
 doc/en/scripting/builtins/libentities.md | 9 +++++++++
 doc/ru/scripting/builtins/libentities.md | 8 ++++++++
 2 files changed, 17 insertions(+)

diff --git a/doc/en/scripting/builtins/libentities.md b/doc/en/scripting/builtins/libentities.md
index 9108fbdf..3fc24257 100644
--- a/doc/en/scripting/builtins/libentities.md
+++ b/doc/en/scripting/builtins/libentities.md
@@ -36,6 +36,15 @@ entities.def_index(name: str) -> int
 -- Returns number of available entity definitions
 entities.defs_count() -> int
 
+```
+
+> [!NOTE]
+> The following functions for retrieving multiple entities return tables with integer keys (uid).
+> For iteration, use `pairs`, and for calculating the table size, use `table.count_pairs`.
+> Using `ipairs` will yield incorrect results, since the returned table is not an array.
+
+```lua
+
 -- Returns a table of all loaded entities
 entities.get_all() -> table
 
diff --git a/doc/ru/scripting/builtins/libentities.md b/doc/ru/scripting/builtins/libentities.md
index ad0e5b2a..000070f2 100644
--- a/doc/ru/scripting/builtins/libentities.md
+++ b/doc/ru/scripting/builtins/libentities.md
@@ -35,6 +35,14 @@ entities.def_index(name: str) -> int
 
 -- Возвращает число доступных определений сущностей
 entities.defs_count() -> int
+```
+
+> [!NOTE]
+> Следующие функции для получения получения нескольких сущностей возвращают таблицы с целочисленными ключами (uid).
+> Для итерации нужно использовать pairs, для подсчёта размера таблицы - table.count_pairs.
+> Использование ipairs даст некорректные результаты, так как возвращаемая таблица не является массивом.
+
+```lua
 
 -- Возвращает таблицу всех загруженных сущностей
 entities.get_all() -> table