Агенты движения/NPC

Используйте Movement_Agent для перемещения объектов с поиском пути и ограничениями navmesh.

Агенты движения

Movement_Agent — это вспомогательный компонент для движения, используемый для управления и поиска пути.

Чаще всего его используют для:

• Запроса пути к цели (set_path_target)

• Ограничения сущности проходимым пространством (прикрепление к Навмэш)

На этой странице рассматриваются движение и поиск пути. Для построения/запроса navmesh см. Navmesh и столкновения.

справку по API Movement_Agent

Movement_Agent :: class : Component {
    Set_Path_Target_Result :: struct {
        success:        bool;
        next_point:     v2;
        move_direction: v2;
    }

    // Запрос пути к цели с заданной скоростью.
    set_path_target :: method(target: v2, speed: float) -> Set_Path_Target_Result;

    // Ограничить этот агент navmesh (прикреплять к нему каждый кадр).
    // Передайте null, чтобы очистить.
    set_navmesh_to_lock_to :: method(navmesh: Navmesh);

    // Общая настройка/состояние
    movement_speed:   float;
    friction:         float;
    velocity:         v2;
    input_this_frame: v2;
}

Сущности, использующие агенты движения, также должны иметь Rigidbody.

Поиск пути (задать цель)

Вызывайте set_path_target каждый кадр (или всякий раз, когда цель меняется).

follow_target :: proc(agent: Movement_Agent, target_pos: v2) {
    result := agent->set_path_target(target_pos, agent.movement_speed);

    if result.success {
        // result.next_point: следующая контрольная точка
        // result.move_direction: нормализованное направление движения (полезно для разворота/анимации)
    }
}

set_path_target обрабатывается позже в кадре параллельно с другими агентами, поэтому в первый кадр после задания новой цели может не вернуться success == true.

Ограничение движения navmesh (оставаться в проходимом пространстве)

Если сущность не должна покидать проходимое пространство, привяжите её к navmesh:

agent->set_navmesh_to_lock_to(navmesh);

Вызовите это с null чтобы очистить.

Создание движущихся NPC

Это минимальный NPC «следуй за игроком» с использованием агента движения:

Follower_NPC :: class : Component {
    agent: Movement_Agent @ao_serialize;
    target: Entity @ao_serialize;

    ao_update :: method(dt: float) {
        if !#alive(target) return;

        result := agent->set_path_target(target.world_position, agent.movement_speed);
        if result.success {
            // Необязательно: повернуть в сторону / установить флаги анимации
            // dir := result.move_direction;
        }
    }
}