Elements Namespace — RollingQuest Lua Scripting API

--- static
---@type table<string, any>
Elements.tagged

-- Retrieve the block tagged "exit-gate"
local gate = Elements.tagged["exit-gate"]
if gate ~= nil then
    gate:activate()
end

-- Retrieve all enemies tagged "guard" and stun them
local guards = Elements.tagged["guard"]
if guards ~= nil then
    for _, enemy in ipairs(guards) do
        enemy:stun()
    end
end

function OnKeyCollected()
    -- Open every door tagged "key-door" when the player picks up a key
    local doors = Elements.tagged["key-door"]
    if doors == nil then return end

    -- Handle both single-entity and multi-entity cases
    if doors.activate ~= nil then
        -- Single entity — it has methods directly
        doors:activate()
    else
        for _, door in ipairs(doors) do
            door:activate()
        end
    end
end

-- Emit a signal to the element tagged "boss-trigger"
local trigger = Elements.tagged["boss-trigger"]
if trigger ~= nil then
    Signals.emitTo("OnBossStart", trigger)
end