3.6 KiB
События движка
События блоков
Функции для обработки событий, прописываемые в скрипте блока.
function on_placed(x, y, z, playerid)
Вызывается после установки блока игроком
function on_broken(x, y, z, playerid)
Вызывается после разрушения блока игроком
function on_interact(x, y, z, playerid) -> bool
Вызывается при нажатии на блок ПКМ. Предотвращает установку блоков, если возвращает true
function on_update(x, y, z)
Вызывается при обновлении блока (если изменился соседний блок)
function on_random_update(x, y, z)
Вызывается в случайные моменты времени (рост травы на блоках земли)
function on_blocks_tick(tps: int)
Вызывается tps (20) раз в секунду
События предметов
Функции для обработки событий, прописываемые в скрипте предмета.
function on_use(playerid: int)
Вызывается при нажатии ПКМ не на блок.
function on_use_on_block(x: int, y: int, z: int, playerid: int)
Вызывается при нажатии ПКМ на блок. Предотвращает установку блока, прописанного в placing-block если возвращает true
function on_block_break_by(x: int, y: int, z: int, playerid: int)
Вызывается при нажатии ЛКМ на блок (в т.ч неразрушимый). Предотвращает разрушение блока, если возвращает true
События мира
События мира для контент-пака прописываются в scripts/world.lua
function on_world_open()
Вызывается при загрузке мира
function on_world_save()
Вызывается перед сохранением мира
function on_world_tick()
Вызывается 20 раз в секунду
function on_world_quit()
Вызывается при выходе из мира (после сохранения)
События макета
События прописываются в файле layouts/имя_макета.xml.lua.
function on_open(invid: int, x: int, y: int, z: int)
Вызывается при добавлении элемента на экран.
- При отсутствии привязки к инвентарю invid будет равен 0.
- При отсутствии привязки к блоку x, y, z так же будут равны 0.
function on_close(invid: int)
Вызывается при удалении элемента с экрана.
События HUD
События связанные с игровым интерфейсом прописываются в файле scripts/hud.lua
function on_hud_open(playerid: int)
Вызывается после входа в мир, когда становится доступна библиотека hud. Здесь на экран добавляются постоянные элементы.
function on_hud_close(playerid: int)
Вызывается при выходе из мира, перед его сохранением.