update doc/ru/** scripting-related docs

doc/ru/scripting/builtins/libhud.md

@@ -0,0 +1,52 @@
+# Библиотека hud
+
+```lua
+-- Открывает инвентарь.
+hud.open_inventory()
+
+-- Закрывает инвентарь.
+hud.close_inventory()
+
+-- Открывает инвентарь и UI блока. 
+-- Если блок не имеет макета UI - бросается исключение.
+-- Возвращает id инвентаря блока 
+-- (при *"inventory-size"=0* создаётся виртуальный инвентарь, 
+--  который удаляется после закрытия), и id макета UI. 
+hud.open_block(x: int, y: int, z: int) -> int, str
+```
+
+> [!NOTE]
+> Одновременно может быть открыт только один блок
+
+```lua
+-- Показывает элемент в режиме оверлея. 
+-- Также показывает инвентарь игрока, если playerinv - **true**.
+hud.show_overlay(layoutid: str, playerinv: bool)
+
+-- Добавляет постоянный элемент на экран. Элемент не удаляется при 
+-- закрытии инвентаря. Чтобы не перекрывать затенение в режиме 
+-- инвентаря нужно установить z-index элемента меньшим чем -1. 
+-- В случае тега inventory, произойдет привязка слотов к инвентарю игрока.
+hud.open_permanent(layoutid: str)
+
+-- Удаляет элемент с экрана.
+hud.close(layoutid: str)
+
+-- Дает ID инвентаря открытого блока или 0.
+hud.get_block_inventory() -> int
+
+-- Дает ID игрока, к которому привязан пользовательский интерфейс.
+hud.get_player() -> int
+
+-- Открывает меню паузы.
+hud.pause()
+
+-- Закрывает меню паузы.
+hud.resume()
+
+-- Возвращает true если открыто меню паузы.
+hud.is_paused() -> bool
+
+-- Возвращает true если открыт инвентарь или оверлей.
+hud.is_inventory_open() -> bool
+```

doc/ru/scripting/builtins/libinventory.md

@@ -0,0 +1,66 @@
+# Библиотека *inventory*
+
+Библиотека функций для работы с инвентарем.
+
+```lua
+-- Возвращает id предмета и его количество. id = 0 (core:empty) обозначает, что слот пуст.
+inventory.get(
+    -- id инвентаря
+    invid: int,
+    -- индекс слота
+    slot: int
+) -> int, int
+
+-- Устанавливает содержимое слота.
+inventory.set(
+    -- id инвентаря
+    invid: int,
+    -- индекс слота
+    slot: int,
+    -- id предмета
+    itemid: int,
+    -- количество предмета
+    count: int
+)
+
+-- Возращает размер инвентаря (число слотов). 
+-- Если указанного инвентаря не существует, бросает исключение.
+inventory.size(invid: int) -> int
+
+-- Добавляет предмет в инвентарь. 
+-- Если не удалось вместить все количество, возвращает остаток.
+inventory.add(
+    -- id инвентаря
+    invid: int, 
+    -- id предмета
+    itemid: int, 
+    -- количество предмета
+    count: int
+) -> int
+
+-- Функция возвращает id инвентаря блока.
+-- Если блок не может иметь инвентарь - возвращает 0.
+inventory.get_block(x: int, y: int, z: int) -> int
+
+-- Привязывает указанный инвентарь к блоку.
+inventory.bind_block(invid: int, x: int, y: int, z: int)
+
+-- Отвязывает инвентарь от блока.
+inventory.unbind_block(x: int, y: int, z: int)
+```
+
+> [!WARNING]
+> Инвентари, не привязанные ни к одному из блоков, удаляются при выходе из мира.
+
+```lua
+-- Создает копию инвентаря и возвращает id копии. 
+-- Если копируемого инвентаря не существует, возвращает 0.
+inventory.clone(invid: int) -> int
+
+-- Перемещает предмет из slotA инвентаря invA в slotB инвентаря invB.
+-- invA и invB могут указывать на один инвентарь.
+-- slotB будет выбран автоматически, если не указывать явно.
+inventory.move(invA: int, slotA: int, invB: int, slotB: int)
+```
+
+

doc/ru/scripting/builtins/libworld.md

@@ -0,0 +1,38 @@
+# Библиотека *world*
+
+```lua
+-- Возвращает информацию о мирах.
+world.get_list() -> массив таблиц {
+    -- название мира
+    name: str,
+    -- предпросмотр (автоматически загружаемая текстура)
+    icon: str
+}
+
+-- Возвращает текущее игровое время от 0.0 до 1.0, где 0.0 и 1.0 - полночь, 0.5 - полдень.
+world.get_day_time() -> number
+
+-- Устанавливает указанное игровое время.
+world.set_day_time(time: number)
+
+-- Устанавливает указанную скорость смены времени суток.
+world.set_day_time_speed(value: number)
+
+-- Возвращает скорость скорость смены времени суток.
+world.get_day_time_speed() -> number
+
+-- Возвращает суммарное время, прошедшее в мире.
+world.get_total_time() -> number
+
+-- Возвращает зерно мира.
+world.get_seed() -> int
+
+-- Проверяет существование мира по имени.
+world.exists() -> bool
+
+-- Проверяет является ли текущее время днём. От 0.333(8 утра) до 0.833(8 вечера).
+world.is_day() -> bool
+
+-- Проверяет является ли текущее время ночью. От 0.833(8 вечера) до 0.333(8 утра).
+world.is_night() -> bool
+```