Unlockables — Secret Balls and Letters API Reference

--- @param type UnlockableType
--- @param key string
--- @return boolean
function Unlockables:isLocked(type, key)

--- @param type UnlockableType
--- @param key string
function Unlockables:unlock(type, key)

--- @param type UnlockableType
--- @param key string
--- @param applyWhenLevelWon boolean
function Unlockables:unlock(type, key, applyWhenLevelWon)

--- @param type UnlockableType
--- @param key string
function Unlockables:lock(type, key)

--- @param ballIndex integer
--- @return boolean
function SecretBallsUnlockables:isCollected(ballIndex)

--- @param ballIndex integer
function SecretBallsUnlockables:collect(ballIndex)

--- @param ballIndex integer
--- @param applyWhenLevelWon boolean
function SecretBallsUnlockables:collect(ballIndex, applyWhenLevelWon)

--- @param ballIndex integer
function SecretBallsUnlockables:unCollect(ballIndex)

--- @param letterIndex integer
--- @return boolean
function SecretLettersUnlockables:isCollected(letterIndex)

--- @param letterIndex integer
function SecretLettersUnlockables:collect(letterIndex)

--- @param letterIndex integer
--- @param applyWhenLevelWon boolean
function SecretLettersUnlockables:collect(letterIndex, applyWhenLevelWon)

--- @param letterIndex integer
function SecretLettersUnlockables:unCollect(letterIndex)

function OnBallRoll(self, rollIn, side, ball)
    if self.tag ~= "secret_ball_trigger" then return end

    if not Unlockables.secretBalls:isCollected(3) then
        Unlockables.secretBalls:collect(3, true)  -- collect, apply when level won
        Dialog.createTemporary("Secret ball found!", 3.0)
    end
end

function OnStart()
    if Unlockables:isLocked(UnlockableType.Theme, "ice_theme") then
        Logger.info("Ice theme is still locked")
    end
end