👣События

Информация

В bLua событие — это функция, которую вызывает сама система, когда происходит определённое действие или изменение состояния в игре или логике. События используются для реакции на происходящее, например: начало сканирования вышки, получение данных с нее и т. д.

function onTowerScan(towerData) -- Событие срабатывает каждый раз, когда вышка
                                -- ГОТОВИТСЯ к сканированию. 
    print("chat", "Вышка начала сканирование!", towerData.Location:find_players(15))
end

В этом примере событие onTowerScan срабатывает автоматически, когда система сообщает, что вышка готовится к сканированию. Переменная towerData содержит данные, связанные с текущим событием (например, позицию вышки, радиус действия и т. д.).

Отмена событий

Некоторые события поддерживают возможность отмены. Если вы хотите предотвратить стандартное действие, достаточно вернуть из обработчика строку "CANCELLED".

function onTowerScan(towerData)
    print("chat", "Вышка не может сканировать сейчас!", towerData.Location:find_players(15))
    return "CANCELLED" -- Отменяем событие, чтобы скан не происходил
end

После возврата "CANCELLED" система прерывает выполнение связанного действия (например, сканирование не произойдёт).

События

onTowerScan

Срабатывает ДО сканирования вышки.

Это событие можно отменить

local towerData = {
    ShieldsMode = true/false -- Включены ли щиты
    Sounds = true/false -- Включены ли звуки
    PingEffects = true/false -- Включены ли эффекты пингов
    DangerMode = true/false -- Включен ли аварийный режим
    Location = location -- Локация компьютера вышки
    PingLocation = location -- Локация пинга вышки (обычно сверху)
}

onTowerScanResults

Срабатывает ПОСЛЕ сканирования вышки, когда результаты уже подготовлены к выводу.

local towerData = {
    ShieldsMode = true/false -- Включены ли щиты
    Sounds = true/false -- Включены ли звуки
    PingEffects = true/false -- Включены ли эффекты пингов
    DangerMode = true/false -- Включен ли аварийный режим
    Location = location -- Локация компьютера вышки
    PingLocation = location -- Локация пинга вышки (обычно сверху)
    Frequency = number -- Частота
    Results = {
        Players = list -- Игроки
        Entities = list -- Сущности
        Dangers = list -- Угрозы
    }
    Buttons = {
        Sound = element -- Кнопка звука (как нажимаемый текст в чате)
        Reload = element -- Кнопка перезагрузки (как нажимаемый текст в чате)
        Ping = element -- Кнопка пингов (как нажимаемый текст в чате)
    }
}

onTowerMessage

Срабатывает, когда система посылает какую-либо ошибку или сообщение, например сообщение об ошибках, обновлениях или заблокированных пакетов.

local towerData = {
    Message = element -- Сообщение, которое передает система
    Location = location -- Локация компьютера вышки
    PingLocation = location -- Локация пинга вышки (обычно сверху)
}

onAnchorPings

Срабатывает, ДО пинга якорей.

local towerData = {
    Sounds = true/false -- Включены ли звуки
    PingEffects = true/false -- Включены ли эффекты пингов
    DangerMode = true/false -- Включен ли аварийный режим
    Location = location -- Локация компьютера вышки
    PingLocation = location -- Локация пинга вышки (обычно сверху)
    Anchors = [
        location, -- Локация якоря
        location, -- Локация якоря
        ...    
    ]
}

onAnchorPingResults

Срабатывает ПОСЛЕ пинга якорей, когда результаты уже подготовлены к выводу.

local towerData = {
    Sounds = true/false -- Включены ли звуки
    PingEffects = true/false -- Включены ли эффекты пингов
    DangerMode = true/false -- Включен ли аварийный режим
    Location = location -- Локация компьютера вышки
    PingLocation = location -- Локация пинга вышки (обычно сверху)
    Anchors = [
        { Location = location -- Локация якоря
          Cracked = true/false -- Сломан ли якорь
          Code = number -- Код активации. Недоступен, если якорь включен
          Shift = number }, -- Сдвиг кода. Недоступен, если якорь включен
        ...    
    ]
}