Merge branch 'MihailRis:main' into main

doc/ru/scripting/builtins/libgui.md

@@ -59,6 +59,17 @@ gui.escape_markup(
 
 Экранирует разметку в тексте.
 
+```lua
+gui.alert(
+    -- сообщение (не переводится автоматически, используйте gui.str(...))
+    message: str,
+    -- функция, вызываемая при закрытии
+    on_ok: function() -> nil
+)
+```
+
+Выводит окно с сообщением. **Не** останавливает выполнение кода.
+
 ```lua
 gui.confirm(
     -- сообщение (не переводится автоматически, используйте gui.str(...))

doc/ru/scripting/builtins/libplayer.md

@@ -96,6 +96,15 @@ player.get_spawnpoint(playerid: int) -> number, number, number
 
 Сеттер и геттер точки спавна игрока
 
+```lua
+player.is_suspended(pid: int) -> bool
+player.set_suspended(pid: int, suspended: bool)
+```
+
+Сеттер и геттер статуса "заморозки" игрока.
+
+При "заморозке" удаляется сущность, а игрок выключается из симуляции мира.
+
 ```lua
 player.set_name(playerid: int, name: str) 
 player.get_name(playerid: int) -> str

doc/ru/scripting/builtins/libworld.md

@@ -48,10 +48,11 @@ world.is_night() -> bool
 world.count_chunks() -> int
 
 -- Возвращает сжатые данные чанка для отправки.
+-- Если чанк не загружен, возвращает сохранённые данные.
 -- На данный момент включает:
 -- 1. Данные вокселей (id и состояние)
 -- 2. Метаданные (поля) вокселей
-world.get_chunk_data(x: int, z: int) -> Bytearray
+world.get_chunk_data(x: int, z: int) -> Bytearray или nil
 
 -- Изменяет чанк на основе сжатых данных.
 -- Возвращает true если чанк существует.
@@ -60,4 +61,12 @@ world.set_chunk_data(
     -- сжатые данные чанка
     data: Bytearray
 ) -> bool
+
+-- Сохраняет данные чанка в регион.
+-- Изменения будет записаны в файл только после сохранения мира.
+world.save_chunk_data(
+    x: int, z: int,
+    -- сжатые данные чанка
+    data: Bytearray
+)
 ```

doc/ru/scripting/ecs.md

@@ -26,6 +26,9 @@ entity:get_uid() -> int
 entity:get_component(name: str) -> компонент или nil
 -- Проверяет наличие компонента по имени
 entity:has_component(name: str) -> bool
+
+-- Включает/выключает компонент по имени
+entity:set_enabled(name: str, enable: bool)
 ```
 
 ## Встроенные компоненты