Read this manual in English

Сообщения о столкновениях

Когда два объекта сталкиваются, движок передает сообщения всем компонентам обоих объектов:

Реакция на столкновение

Сообщение "collision_response" посылается всем объектам столкновения. У него имеются следующий набор полей:

other_id

идентификатор экземпляра объекта столкновения, с которым произошло столкновение (hash)

other_position

позиция в пространстве мира объекта столкновения, с которым произошло столкновение (vector3)

other_group

группа столкновения другого объекта столкновения (hash)

Само по себе сообщение collision_response имеет смысл только для принятия решений по столкновениям, в которых вы не хотите знать деталей о реальном пересечении объектов, например, если вы хотите определить, поразила ли пуля врага. В каждом кадре только по одному сообщению такого вида посылается для каждой пары столкнувшихся объектов.

function on_message(self, message_id, message, sender)
    -- проверка сообщения
    if message_id == hash("collision_response") then
        -- предпринимаем действие
        print("I collided with", message.other_id)
    end
end

Реакция точки контакта

Сообщение "contact_point_response" посылается, когда одна из групп столкновения динамическая или кинематическая. В нем содержится следующий набор полей:

position

позиция точки контакта в пространстве мира (vector3).

normal

вектор нормали точки контакта в пространстве мира, который указывает от другого объекта к текущему (vector3).

relative_velocity

относительная скорость объекта столкновения наблюдаемая со стороны другого объекта (vector3).

distance

длина проникновения между объектами, неотрицательное число (number).

applied_impulse

результирующее значение импульса при контакте (number).

life_time

(не используется в данный момент!) время жизни контакта (number).

mass

масса текущего объекта столкновения в килограммах (number).

other_mass

масса другого объекта столкновения в килограммах (number).

other_id

идентификатор экземпляра объекта, с которым объект столкновения находится в контакте (hash).

other_position

позиция другого объекта столкновения в пространстве мира (vector3).

group

группа столкновений другого объекта столкновений (hash).

Для игры или приложения, где необходимо идеально отделить объекты, сообщение "contact_point_response" дает всю необходимую для этого информацию. Однако, стоит заметить, что для любой пары столкновения, каждый кадр могут присылаться несколько сообщений "contact_point_response", в зависимости от природы столкновения. За подробностями обращайтесь к руководству по разрешению столкновений.

function on_message(self, message_id, message, sender)
   -- проверка сообщения
    if message_id == hash("contact_point_response") then
        -- предпринимаем действие
        if message.other_mass > 10 then
            print("I collided with something weighing more than 10 kilos!")
        end
    end
end

Реакция триггера

Сообщение "trigger_response" посылается, когда столкнувшийся объект имеет тип “trigger”.

В столкновении с триггером посылаются сообщения "collision_response". Дополнительно, триггеры также посылают специальные сообщения "trigger_response", когда коллизия начинается и заканчивается. Сообщение содержит следующие поля:

other_id

идентификатор экземпляра, с которым столкнулся объекта столкновения (hash).

enter

true — если взаимодействие было вхождением в триггер, false — если это был выход из него (boolean).

function on_message(self, message_id, message, sender)
    -- проверка сообщения
    if message_id == hash("trigger_response") then
        if message.enter then
            -- предпринимаем действие для входа
            print("I am now inside", message.other_id)
        else
            -- предпринимаем действие для выхода
            print("I am now outside", message.other_id)
        end
    end
end