voxelcore/doc/ru/scripting/builtins/libhud.md
2026-08-14 01:46:35 +05:00

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 второго открытого инвентаря (блок, виртуальный инвентарь...) или 0.
hud.get_second_inventory() -> int

-- Получить ID инвентаря, в котором находится предмет во время 
-- его перемещения в инвентаре, или 0 если его не существует.
-- Имеет единственный слот - 0
hud.get_exchange_inventory() -> int

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

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

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

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

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

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

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

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