Перейти к содержанию

Сценические сцены

Постановочные сцены, которые сами появляются на карте: очередь за едой, полицейский стучит в дверь, пара на диване, человек на стуле, арест у стены. Всего 28 определений сцен, 23 включено в автоматический спавн; все данные в config/states/sh_scenic.lua. Участники — обычные акторы (bgNPC:SpawnActor), поэтому работают и с телом NPC, и с телом NextBot.

Квар (сервер) По умолчанию Смысл
bgn_scenic 1 сцены вкл / выкл
bgn_scenic_max 4 сцен одновременно
bgn_scenic_period 30 секунд между попытками

Меню: страница Спавн, раздел «Сценические сцены», и шаг мастера «Сценические сцены» (в режиме «Новый» включён, в «Классическом» выключен). Консоль: bgn_scenic_clear убирает все сцены, bgn_scenic_spawn <id> (админ) создаёт одну рядом. Для дверных сцен наведитесь на полностью закрытую дверь: команда использует тот же поиск позиции, что и автоматический спавн. Для стука замок не требуется: подходят и незапертые, и запертые двери. Сценка не запирает дверь; как только она начинает открываться, актор прекращает позу и возвращается к обычному поведению. Ручное размещение администратором разрешает спавн рядом и на глазах, сохраняя проверки пола, свободного места, условий сцены и моделей акторов. Автоматический спавн по-прежнему требует скрытых позиций. У каждой автоматической сцены есть отдельный чекбокс на странице «Спавн» (также в классических настройках), связанный с bgn_scenic_<id>; он влияет на будущий автоспавн, но не на существующие сцены и ручное создание Tool. У sky_watch, door_brace, luggage, ration и newspaper установлен weight = 0: они остаются ручными. Предпросмотры создают одного ходящего актора: паёк/газета требуют NextBot, чемодан у HL2 NPC становится клиентским кейсом; обычным жителям предметы назначаются через конфиг актора.

Tool «Отладка сцен»

Откройте Q → Инструменты → Background NPCs → Отладка сцен (только для администраторов). В панели доступны все 28 ID сцен, включая пять ручных предпросмотра, и тест GOAP: удерживание, выбивание, подъём.

Управление Действие
ЛКМ Создать выбранную сцену на указанном полу/стене, у полностью закрытой двери или на подходящем свободном стуле.
ПКМ по актору или временному регдоллу Осмотреть UID, фактический класс тела, состояние, здоровье, модель, анимацию и связанную дверь. Подробности GOAP также выводятся в вашу консоль.
ПКМ по пустому месту Вернуться к сводке последней сцены и сообщениям об отсутствующих анимациях/неподходящих моделях.
R Удалить последний тест, созданный этим Tool, включая акторов, которые уже вернулись к обычному поведению.
Undo / Z Отменить создание через Tool или bgn_scenic_spawn. Существующие двери и стулья карты сохраняются.

Для стены цельтесь ближе к полу, чтобы поиск нашёл землю; сценам с наблюдением за небом нужно открытое небо. При отказе показывается причина. Если у штатно выбранной модели нет нужной анимации, HUD показывает модель и запрошенные анимации; модель не подменяется. Удаление теста на стуле освобождает его для немедленного повтора. Для дверной сцены цельтесь прямо в полотно двери. Ошибки отдельно сообщают о неверной цели, открытой/движущейся двери и нехватке места на полу; прицел на полу рядом с дверью её не выбирает.

Тест двери начинается у закрытой незапертой распашной двери со свободным местом по обе стороны. Создаются житель и полицейский с обычным выбором моделей и текущим типом тела сервера. Только этой паре назначается GOAP, здоровье удерживающего снижается до 25%, чтобы он искал укрытие, затем дверь открывается. Житель закрывает и удерживает её, полицейский выбивает, житель падает и встаёт. После одного удара полицейский прекращает бой. Наблюдайте фазу и состояния на HUD; затем удалите пару через R или Undo. Отсутствие doorbracer_* у модели или недоступную позицию Tool покажет как проблему, а не исправит подменой модели или обходом перемещения ИИ.

Для сравнения тел переключите bgn_actor_body npc / bgn_actor_body nextbot в обычных настройках сервера и создайте новый тест; NextBot нужна NavMesh. Tool не меняет глобальные настройки тела и мозга. Окружающий ИИ остаётся активным, поэтому выбирайте спокойное место. Создание и диагностика выполняются на сервере, клиент только выбирает сцену и отображает отчёт. Тесты принадлежат создателю и удаляются при его отключении. Акторы из этого Tool или bgn_scenic_spawn исключены из автоматического удаления/перемещения и очистки сцен по расстоянию/видимости/времени жизни, даже после выхода из позы. R, Undo, явная очистка и смерть работают.

Как подбирается место

  1. Задача bgn_scenic (systems/scenic/sv_scenic_spawner.lua) выбирает сцену по весу; у сцены, не нашедшей место, растёт пауза (20 с, удваивается до 600 с).
  2. sv_scenic_finders.lua берёт точки по place сцены: точки навигации в кольце спавна (floor, sky, wall, ledge) или двери и стулья из индекса сущностей, кэш 30 с (door, chair).
  3. Поиск проверяет точку: ровный пол, место под хитбокс, открытое небо (sky), ровная стена (wall), закрытая дверь со свободной стороной (door, открывающиеся и закрывающиеся двери не подходят), свободный стул (chair) или широкий уступ с перепадом высоты до колена (ledge).
  4. Plan проверяет пол, уровень и место для каждого участника. Сцены держатся в 400 юнитах друг от друга и вне поля зрения игроков (IsHiddenSpawnPosition).

Актёры

Участники играют зацикленную анимацию в состоянии scenic_npc (группа calm). Спокойные состояния их не выводят; реакция на опасность (выстрел, урон, розыск) выводит — дальше это обычные акторы. Разговоры их пропускают. Дверные сцены (door_knock, door_brace, entrance_block) также прекращаются для каждого участника, когда связанная дверь начинает открываться или удаляется. Сервер останавливает анимацию и возвращает актора обычному ИИ; актор остаётся жив и больше не удаляется вместе со сценой. door_knock учитывает боковую ориентацию исходной анимации, чтобы поднятая рука попадала по полотну двери. Автоматическая сцена удаляется через ttl секунд (по умолчанию 60), когда на неё никто не смотрит, даже внутри радиуса появления: ни один игрок не ближе bgn_spawn_block_radius и не смотрит в её сторону при свободной линии до сцены (трассировка по миру). Проверка идёт раз в 5 с.

Проверки позиции и жизненного цикла дверных сцен вне игры: python tools/test_scenic.py (нужна lupa).

Добавить сцену

Добавьте запись в bgNPC.cfg.scenic; поля описаны в начале sh_scenic.lua. Если у модели нет анимации, играется следующая из списка; сцена, анимаций которой нет ни у одной модели, пропускается. Модели, скины и бодигруппы назначает обычный спавнер акторов с учётом конфига и хуков моделей. Сцены не подменяют модели (members.models игнорируется); участник без подходящей анимации пропускается, а не получает другую модель. weight = 0 оставляет сцену только для ручного спавна.

Не перенесено: сцены с собственными звуками, спуск по тросу, БТР, бинокли и персонажи оригинального аддона.

Правила размещения и поз

Оба дивана и стол радиста снова участвуют в автоспавне с indoors = true. Нужны твёрдый потолок в пределах 384 единиц и стены в четырёх горизонтальных направлениях в пределах 512 единиц, а также сухой ровный пол. Потолок-sky, открытые дворы и мебель, чьи повёрнутые габариты пересекают геометрию карты, отклоняются. Эта консервативная проверка может отклонить настоящую комнату с открытым проёмом/окном; она действует и для Tool.

ground_sit создаёт одного жителя с доступной позой из списка. Простые стоячие сцены (plaza, tired) удалены: их позы (plazastand*, idle_subtle, d2_coast03_postbattle_idle02) теперь входят в состояние idle. Поза усталости с поднятой рукой вынесена в tired_wall, лицом к опоре. ledge_sitting требует ровного края шириной от 32 единиц, опоры на 28 единиц позади, места для вставания и перепада высоты 24–56 единиц впереди. Короткие лучи вниз дополнительно проверяют опору непосредственно под тазом и в 10 единицах по обе стороны; актор смотрит в сторону нижней поверхности. Узкие перила, обычные ступени и глубокие обрывы отклоняются. У сидящих NextBot временно останавливается движение, отключаются маска столкновений и гравитация, чтобы физика не выталкивала их над стулом, пользовательским местом на скамейке или уступом. Остановка тела сбрасывает заданную и текущую скорость; при выходе восстанавливаются исходные маска и гравитация.

Смещение pos.z участника и отдельные seq_offsets анимаций сохраняются; спавн использует отдельную безопасную позицию для стояния. Выход из позы возвращает туда актора, чтобы сидячая анимация со смещённым корнем не оставляла его внутри пола или уступа. Для дивана используется одна откалиброванная модель мебели; модели акторов по-прежнему выбираются обычным спавнером. У сцены с atomic = true (пары на диване) отсутствие подходящей позы у любого участника отменяет всю постановку.