BLOXAR Lua API

Скрипты блоков в BLOXAR пишутся на Lua и выполняются в изолированной виртуальной машине (fengari) — у каждого скрипта своё собственное состояние, скрипты не видят переменные друг друга напрямую. Общаться между собой блоки могут только через явные функции движка, описанные в этом документе, или через события (emit/on).

🚀 Первый скрипт

1. Откройте проект в Studio Mode.
2. В панели Explorer выберите блок, нажмите ➕ и добавьте 📜 Script.
3. Кликните по скрипту — откроется редактор кода.
4. Напишите Lua-код и нажмите Save & Close.
5. Нажмите Publish, чтобы опубликовать мир на сервер.

Минимальный пример

function onTick(dt)
    if isKeyDown('e') then
        say('Привет из скрипта!')
    end
end

onTick(dt) — единственная функция, которую движок вызывает автоматически, каждый кадр, с dt — временем в секундах с прошлого кадра. Весь остальной код внутри скрипта пишется вокруг неё.

🧬 Переменные блока

Эти функции доступны только внутри скрипта, привязанного к блоку — они возвращают данные именно этого блока, не требуя UUID.

⚡ События

-- Блок-кнопка
on('door_toggle')
function onEvent_door_toggle(data)
    say('Дверь получила сигнал от ' .. data.from)
end

function onTick(dt)
    if isKeyDown('e') then
        emit('door_toggle', 'state', 'open')
    end
end

❤️ Здоровье и позиция игрока

⌨️ Ввод

🎥 Камера

🌍 Время суток и гравитация

🧱 Блоки

Каждая функция принимает или возвращает uuid — уникальный ID блока (получить его можно через getBlockUUID() у своего блока, findBlockByName() у чужого, или как результат spawnBlock()).

Поиск

Чтение свойств

Изменение

Создание / удаление

📡 Рейкаст

🎒 Инвентарь и очки

setGlobalVar('score', (getGlobalVar('score') or 0) + 10)
say('Очки: ' .. getGlobalVar('score'))

👥 Мультиплеер

Только чтение — другие игроки управляются сервером напрямую.

🔊 Звук и чат

⏱ Таймеры

wait(2, function()
    say('Прошло 2 секунды')
end)

🖥️ UI и диалоги

📊 Таблицы данных

Большинство функций API возвращают строку (проще маршалить в Lua), но для списков объектов есть версии, отдающие настоящую Lua-таблицу.

for i, p in ipairs(getOtherPlayersTable()) do
    print(p.nickname, p.x, p.y, p.z)
end

🎬 Анимации

🧮 Математика и утилиты

💡 Готовые примеры (Copy & Paste)

Лёгкая машина (сесть по E)

local carId = nil
local seated = false
local eWasDown = false
local speed = 6.0
local turnSpeed = 2.2
local enterRadius = 2.5
local rotY = 0

function onTick(dt)
    if carId == nil then carId = getBlockUUID() end
    local cx, cy, cz = getBlockX(), getBlockY(), getBlockZ()
    local eDown = isKeyDown('e')
    local ePressed = eDown and not eWasDown
    eWasDown = eDown

    if not seated then
        if ePressed and distanceToPlayer(cx, cy, cz) < enterRadius then
            seated = true
            say('Сел за руль')
        end
        return
    end

    if ePressed then
        seated = false
        say('Вышел из машины')
        setPlayerPosition(cx + 2, cy + 1, cz)
        return
    end

    if isKeyDown('a') then rotY = rotY + turnSpeed * dt end
    if isKeyDown('d') then rotY = rotY - turnSpeed * dt end

    local moveDir = 0
    if isKeyDown('w') then moveDir = 1 end
    if isKeyDown('s') then moveDir = -1 end

    local nx, nz = cx, cz
    if moveDir ~= 0 then
        nx = cx + math.sin(rotY) * speed * dt * moveDir
        nz = cz + math.cos(rotY) * speed * dt * moveDir
    end

    setBlockPosition(carId, nx, cy, nz)
    setBlockRotation(carId, 0, rotY, 0)
    setPlayerPosition(nx, cy + 1.0, nz)
    setPlayerRotationY(rotY)
end

Ловушка-шипы (урон при касании)

local cooldown = 0

function onTick(dt)
    cooldown = math.max(0, cooldown - dt)
    local x, y, z = getBlockX(), getBlockY(), getBlockZ()
    if distanceToPlayer(x, y, z) < 1.2 and cooldown <= 0 then
        cooldown = 1.5
        damagePlayer(20)
        playSound('land', 1)
    end
end

Интерактивная кнопка

local activated = false

function onTick(dt)
    local x, y, z = getBlockX(), getBlockY(), getBlockZ()
    if distanceToPlayer(x, y, z) < 3 and not activated then
        if isKeyDown('e') then
            activated = true
            playSound('jump', 1)
            setBlockColor(getBlockUUID(), 0x2EE6A6)
            announce('Кнопка активирована!')
        end
    end
end

Портал с задержкой

local used = false

function onPlayerEnter(who)
    if used then return end
    used = true
    say(who .. ' активировал портал')
    wait(1, function()
        setPlayerPosition(0, 5, 0)
        used = false
    end)
end