Навмеш и столкновения

Навмеши определяют проходимое пространство для поиска пути и ограничений перемещения.

Навмеши определяют проходимые области в вашем мире. Используйте их для:

• Привязки появляющихся объектов к достижимой земле
• Ограничения игроков/NPC проходимыми регионами

Коллайдеры также можно использовать для вырезания навмешей в редакторе.

Компоненты (краткий обзор)

• Навмеш: запечённая навигационная сетка, которую вы запрашиваете и перестраиваете
• Navmesh_Loop: петли полигонов, определяющие границы проходимости (и отверстия)
• Коллайдеры: Box_Collider, Circle_Collider, Edge_Collider, Polygon_Collider

Для движения/поиска пути (Movement_Agent) см. Агенты движения/NPC.

Справочник API навмеша

Navmesh :: class : Component {
    // Спроецировать точку на этот навмеш.
    // triangle_hint — это подсказка для ускорения, которую можно переиспользовать для близких запросов.
    try_find_closest_point_on_navmesh :: method(
        to_point: v2,
        result: ref v2,
        triangle_hint: ref s64
    ) -> bool;

    // Пропустить луч через навмеш. Возвращает конечную точку и сообщает, успешен ли запрос.
    try_raycast :: method(position: v2, direction: v2) -> v2, bool;

    // Поставить перестроение в очередь для обычного обновления навмеша.
    mark_for_rebuild :: method();

    // Перестроить сейчас, когда запрос в том же кадре требует новую геометрию.
    rebuild_immediately :: method() -> bool;

    // Включать только коллайдеры на этой сущности и её потомках.
    child_colliders_only: bool;

    // Обнаруживать изменения ввода и перестраивать автоматически.
    enable_automatic_rebuilds: bool;
}

Настройка в редакторе (создание навмеша)

1. Создайте сущность и добавьте Навмеш компонент.
2. Создайте дочерние сущности с Navmesh_Loop компонентами, чтобы определить проходимые полигоны.
3. Для каждого Navmesh_Loop:

   • Добавьте точки, чтобы задать форму петли
   • Расположите точки внешней границы против часовой стрелки
   • Переключите Поменять внутри и снаружи чтобы сделать отверстие/препятствие вместо проходимого пространства
4. Используйте отладочные параметры навмеша в инспекторе, чтобы визуализировать треугольники.

По умолчанию, Navmesh_Loop определяет проходимую область. Переключите это в "пробить отверстия" (непроходимые островки) в существующем навмешe.

Направление обхода петли определяет, какая сторона каждого ребра считается внутренней. Обход против часовой стрелки — нормальное направление для проходимой внешней границы. Обход по часовой стрелке меняет этот результат на противоположный. Используйте Поменять внутри и снаружи умышленно для отверстий, а не полагайтесь на случайно перевёрнутый порядок точек.

Коллайдеры и петли навмеша

Коллайдеры также могут вносить петли через параметры инспектора коллайдера (например, "Make Navmesh Loop" / "Flip Navmesh Loop").

Важные оговорки:

• С Включить автоматическое перестроение, навмеши обнаруживают изменения петель, коллайдеров, тайлмапа и дочерних навмешей и ставят перестроение в очередь.
• Включите Только дочерние коллайдеры чтобы игнорировать неродственные коллайдеры в других местах сцены.
• Если автоматическое перестроение отключено, вызывайте mark_for_rebuild() после изменения входных данных.
• Вызывайте rebuild_immediately() только перед запросом в том же кадре, которому требуется изменённая геометрия.

Появление на навмешe (ограничить до достижимой земли)

Используйте try_find_closest_point_on_navmesh чтобы спроецировать желаемую позицию на ближайшую допустимую точку на навмешe:

spawn_on_navmesh :: proc(navmesh: Navmesh, desired_position: v2) -> Entity {
    spawn_pos: v2;
    triangle_hint: s64; // 0 = ещё не задан

    if navmesh.try_find_closest_point_on_navmesh(desired_position, ref spawn_pos, ref triangle_hint) {
        e := Scene.create_entity();
        e.set_local_position(spawn_pos);
        return e;
    }

    return null;
}

Переиспользуйте triangle_hint для повторяющихся запросов в одной и той же области (спавнеры добычи, волновые спавны и т. д.). Это может значительно ускорить проекцию.

Немедленное перестроение навмешей

Большинство изменений геометрии подхватываются автоматически. Используйте это только когда нужно принудительно задать момент:

• rebuild_immediately(): перестраивает сейчас (используйте только если вам обязательно нужен обновлённый меш в том же кадре)

ok := navmesh.rebuild_immediately();
if !ok {
    log_info("Не удалось перестроить навмеш", {});
}

Родительские навмеши обновляются после дочерних, поэтому сшитые родительские меши автоматически подхватывают изменения входных данных дочерних мешей.

Рейкаст через навмеш

try_raycast идёт по направлению к границе навмеша. Второй результат сообщает, успешен ли запрос.

endpoint, ok := navmesh.try_raycast(start, direction);
if ok {
    // конечная точка находится на границе навмеша.
}

Триггеры коллайдера

Коллайдер с is_trigger == true может сообщать, когда другой коллайдер входит, остаётся внутри или выходит. Колбэки триггера работают на неподвижных и движущихся коллайдерах; Movement_Agent не требуется.

Используйте коллайдеры экономно. Добавляйте их только к поверхностям, критичным для игрового процесса: границам карты, платформам, на которые должен приземлиться игрок, ключевым препятствиям и намеренным зонам триггеров. Не добавляйте коллайдеры к декоративным сущностям (деревья, кусты, фоновые объекты и т. д.). У большинства сущностей в сцене не должно быть коллайдера.

Trigger_Listener :: class : Component {
    ao_start :: method() {
        trigger_collider := entity.get_component(Circle_Collider);
        trigger_collider.is_trigger = true;

        trigger_collider.on_trigger_start = proc(self: Collider, other: Collider) {
            log("ПЕРЕСЕЧЕНИЕ НАЧАЛО: %", {other.entity.get_name()});
        };

        trigger_collider.on_trigger_stay = proc(self: Collider, other: Collider) {
            log("ПЕРЕСЕЧЕНИЕ ПРОДОЛЖАЕТСЯ: %", {other.entity.get_name()});
        };

        trigger_collider.on_trigger_end = proc(self: Collider, other: Collider) {
            log("ПЕРЕСЕЧЕНИЕ КОНЕЦ: %", {other.entity.get_name()});
        };
    }
}

Проверки близости и пользовательская логика попаданий

Для зон триггера, которые используют запросы по радиусу вместо колбэков коллайдера, подбора предметов, проверок снарядов или другой пользовательской логики попаданий, используйте:

• Scene.get_all_components_in_range / Scene.get_closest_component_in_range
• Простые проверки расстояния (in_range) чтобы определить «внутри», «подобрано», «попадание» и т. д.

Помощники запросов сцены

Scene :: struct {
    get_all_components_in_range :: proc(position: v2, range: float, results: ref [..]$T);
    get_closest_component_in_range :: proc(position: v2, range: float, $T: typeid) -> T, bool;
}

Наносите урон, подбирайте предметы и начисляйте очки по обычному общему игровому пути. Не защищайте предсказанный геймплей с помощью Game.is_server().

Объём триггера (вход / пребывание / выход)

Чтобы имитировать зону триггера, храните список тех, кто был внутри в прошлом кадре, и сравнивайте его с результатами текущего кадра.

contains_id :: proc(list: []u64, id: u64) -> bool {
    for x: list if x == id return true;
    return false;
}

Trigger_Zone :: class : Component {
    radius: float @ao_serialize;
    last_inside: [..]u64;

    ao_update :: method(dt: float) {
        center := entity.world_position;

        players: [..]Player;
        Scene.get_all_components_in_range(center, radius, ref players);

        current_inside: [..]u64;

        for p: players {
            if in_range(p.entity.world_position, center, radius) {
                current_inside.append(p.entity.id);

                if !contains_id(last_inside, p.entity.id) {
                    // on_enter
                    Notifier.notify(p, "Игрок вошёл в зону!");
                }
                else {
                    // on_stay
                }
            }
        }

        for id: last_inside {
            if !contains_id(current_inside, id) {
                // on_exit (вам может понадобиться собственный поиск id.player)
            }
        }

        last_inside.clear();
        for id: current_inside {
            last_inside.append(id);
        }
    }
}

Этот ручной шаблон триггера всё ещё полезен, когда вы не хотите добавлять объём триггера на коллайдере. Если что-то телепортируется/удаляется между обновлениями, вы можете не получить чистый «выход», если не обработаете очистку.

Подбор предметов (ближайший в радиусе)

try_pickup_near_player :: proc(player: Player) {
    pos := player.entity.world_position;

    pickup, ok := Scene.get_closest_component_in_range(pos, 1.5, Pickup);
    if ok && pickup != null {
        if in_range(pickup.entity.world_position, pos, 1.5) {
            pickup.claim(player); // ваша собственная логика (выдать + уничтожить)
        }
    }
}

Быстрые «попадания» при движении (простое подшагивание)

Если вы двигаетесь быстро (рывок, снаряд), можно промахнуться по узким целям, проверяя только конечную позицию. Простое решение — подшагивание: семплировать несколько точек между прошлой и новой позицией и выполнять те же запросы по радиусу.

hit_check_move :: proc(last_pos: v2, new_pos: v2) {
    steps := 4;
    for i := 1; i <= steps; i += 1 {
        t := (i.(float)) / (steps.(float));
        p := lerp(last_pos, new_pos, t);

        enemies: [..]Enemy;
        Scene.get_all_components_in_range(p, 1.0, ref enemies);
        for e: enemies {
            if in_range(e.entity.world_position, p, 1.0) {
                // применить попадание один раз, запустить кулдаун и т. д.
            }
        }
    }
}