voxelcore/doc/ru/scripting/builtins/libhud.md
Xertis 32feb78002
Improved docs (#708)
* начало переписи доков

* extensions update

* libapp update

* libfile update

* io_stream update

* Update io_stream.md

* io_stream update x3

* io_stream update x4

* libtime update

* libgui update + make bytearray.md

* libinput update

* Update libapp.md

* Update libapp.md

* libgui update

* events.md ru fix

* да ну не надо так делать

--> не имеет смысла, ибо гитхаб -> показывает адекватно

* types refactoring

* fixes

* Update libblock.md

* Update libblock.md

* Update libbyteutil.md
2025-12-18 12:58:39 +03:00

3.4 KiB
Raw Blame History

Библиотека hud

-- Открывает инвентарь.
hud.open_inventory()

-- Закрывает инвентарь.
hud.close_inventory()

-- Открывает инвентарь и UI.
-- Если макет UI не существует - бросается исключение.
-- Если invid не указан, создаётся виртуальный (временный) инвентарь.
-- Возвращает invid или id виртуального инвентаря.
hud.open(
    -- Макет UI
    layoutid: string, 
    -- Не открывать инвентарь игрока
    [опционально] disablePlayerInventory: boolean, 
    -- Инвентарь, к которому будет привязан UI макет
    [опционально] invid: int
) -> int

-- Возвращает true если указаный макет UI открыт.
hud.is_open(
    layoutid: string
) -> boolean

-- Открывает инвентарь и UI блока.
-- Если блок не имеет макета UI - бросается исключение.
-- Возвращает id инвентаря блока 
-- (при *"inventory-size"=0* создаётся виртуальный инвентарь, 
--  который удаляется после закрытия), и id макета UI. 
hud.open_block(x: int, y: int, z: int) -> int, string

Note

Одновременно может быть открыт только один блок

-- Показывает элемент в режиме оверлея. 
-- Также показывает инвентарь игрока, если playerinv - **true**.
-- Через args можно указать массив значений параметров, что будут переданы
-- в on_open показываемого оверлея.
hud.show_overlay(layoutid: string, playerinv: boolean, [опционально] args: table)

-- Добавляет постоянный элемент на экран. Элемент не удаляется при 
-- закрытии инвентаря. Чтобы не перекрывать затенение в режиме 
-- инвентаря нужно установить z-index элемента меньшим чем -1. 
-- В случае тега inventory, произойдет привязка слотов к инвентарю игрока.
hud.open_permanent(layoutid: string)

-- Удаляет элемент с экрана.
hud.close(layoutid: string)

-- Дает ID инвентаря открытого блока или 0.
hud.get_block_inventory() -> int

-- Дает ID игрока, к которому привязан пользовательский интерфейс.
hud.get_player() -> int

-- Открывает меню паузы.
hud.pause()

-- Закрывает меню паузы.
hud.resume()

-- Возвращает true если открыто меню паузы.
hud.is_paused() -> boolean

-- Возвращает true если открыт инвентарь или оверлей.
hud.is_inventory_open() -> boolean

-- Устанавливает разрешение на паузу. При значении false меню паузы не приостанавливает игру.
hud.set_allow_pause(flag: boolean)

-- Функция, управляющая именованным скелетом 'hand' (см. gfx.skeletons)
hud.hand_controller: function()