История версий и база документации¶
Версия 2.6.0 (version.txt и bgNPC.VERSION; публикация не проверена) включает все изменения после тега 2.5.1 (a7f2d9da) до 463d21ca. Записи ниже с пометкой «2.5.1» относятся к 2.6.0. Также добавлен необязательный пропуск трассировки укрытия для точек появления (bgn_spawn_no_visibility_trace, по умолчанию 0), медики оживляют только акторов, невиновных перед жителями, а бандиты больше не союзники банд. См. настройки.
Локальное исправление диалогов 2.5.1 (публикация не проверена): случайные реплики состояния и фоновый кашель больше не перебивают участников разговора, включая сбор и реакцию на вмешательство игрока. См. разговоры.
Локальное исправление 2.5.1 после аудита (публикация не проверена): выход из машины и смертельный урон допускают уже удалённую сущность пассажира DV; проверка розыска пропускает живых акторов без валидной текущей сущности. Сохранены идентичность/здоровье персонажа и обычные проверки препятствий при выходе. См. транспорт и регрессии.
Локальный инженерный аудит 2.5.1 (публикация не проверена): исправлены выключенные механики, постоянные службы, изменение списка задач, счётчики идентичности/снимков после reload, пустые запросы и выбор областей навигации, планирование GOAP, выбор внешности, регенерация и клиентские приёмники. Убрано чтение конфига spawnmenu при каждом создании сущности; спавн игрока использует hooks прав/учёта gamemode. Введены явные границы сетевых загрузок. Архитектура и defaults сохранены; см. аудит и ограничения проверок.
Локальное изменение 2.5.1 (публикация не проверена): необязательные паника и поиск угрозы (bgn_threat_search, по умолчанию выключено). Союзник, видевший убийство, но не убийцу (трасса от жертвы, без конуса обзора), паникует (жители) или прочёсывает место, где стоял убийца (полиция, банды), идя шагом ближе 1000 единиц к убийце; спавнер их в это время не утилизирует. Любой с классом оружия убийцы, замеченный 3 проверки подряд в пределах 500 единиц в поле зрения, становится врагом. См. поведение.
Локальная оптимизация SERVER 2.5.1 (публикация не проверена): поиск объектов для BGN_ActorVisibleAtObject/BGN_ActorLookAtObject идёт в радиусе 100 юнитов вокруг актёра вместо 1000 (встроенные обработчики реагируют в пределах 80 юнитов), а трассировка взгляда делается один раз за проход. Ежесекундная проверка враждебности чужих NPC сначала отсеивает сущности, не являющиеся NPC, а контроллер статичных анимаций вызывает IsAlive только для анимируемых актёров. Поведение не изменилось.
Локальное исправление звонка в полицию 2.5.1 (публикация не проверена): реакции на урон/защиту запрещают звонок о враге в розыске или уже известном полиции до добавления врага; вход в звонок также требует допустимого выбранного врага. Правила завершения начатого звонка не изменены. См. звонки в полицию.
Локальное изменение переноса 2.5.1 (публикация не проверена): задержка появления — 0, лимит переносов — 10 в секунду. Перенос вместо удаления остаётся включённым (1). Настройка быстрой проверки удалена: SERVER всегда делает одну уступку планировщику перед проверкой каждого актора для удаления или переноса. Сохранённые значения остальных cvar не перезаписываются. См. настройки.
Локальное изменение командной защиты 2.5.1 (публикация не проверена): транспортное исключение для нарушителей (bgNPC.OffenderFromRamming, systems/sv_offender.lua) удалено. Наезд на жителя и таран полиции больше не переводят водителя-жителя из residents в offenders; полиция в машине игнорирует таран водителя-жителя. См. розыск.
Локальное исправление жителей/полиции 2.5.1 (публикация не проверена): союзные попадания не запускают страх и реакции подтверждённого конфликта; жителей нельзя объявить в розыск. Смена команды согласует цели/розыск/арест. Нарушителем становится только водитель при подтверждённом транспортном столкновении: наезде на жителя либо повторном таране полиции с минимумом 3 секунды и прежним шансом реакции 10%. См. правила розыска и дерево поведения.
Локальные исправления аудита 2.5.1 (публикация не проверена): запись преследования в движковую память NPC больше не продлевает 60-секундный срок поиска актора; смена тела сохраняет память позиции и приоритет цели; оружие полиции следует выбранному врагу. Полицейские на переговорах не начинают осаду и не вступают в неё, владелец спецсредства определяется до реакций на урон, обе ветки телепортации застрявшего NextBot соблюдают боевой радиус. См. обновлённое дерево решений и проверки разработчика.
Локальное изменение 2.5.1 (публикация не проверена): устойчивый приоритет боевой цели, преследование скрывшейся цели по последней замеченной позиции, передача памяти наблюдения, укрытие только при видимости и защита бойцов от удаления/телепортации (фиксированный радиус 1000). См. поведение.
Локальное изменение 2.5.1 (публикация не проверена): радиореплики полиции для осад (позиции, вскрытие, граната, манхак, итог), упавшей или потерянной цели и переговоров с заложником; осада больше не глушит голоса; цель в розыске — известная позиция даже вне видимости. См. мозги.
Локальное изменение 2.5.1 (публикация не проверена): GOAP-осада помещений с одним выходом, общее распределение ближних/дальних групп, манхаки метрокопов и гранаты комбайнов при наличии анимаций, вероятностное выбивание/открывание дверей. Тактика на основе NavMesh и ограничения описаны в поведении.
Локальное изменение 2.5.1 (публикация не проверена): опциональная реакция жителей/полиции на летальное оружие в руках, по умолчанию выключена; LOS/FOV проверяются раз в секунду в пределах 800 единиц. Обучение продолжается при выключенной настройке, исключает взрывы/убийства транспортом и сохраняет новые классы в серверный кеш/файл DATA. См. поведение и дерево решений.
Сверено с Git до тега 2.3.0 (2258b49) и текущей 2.3.1 dev (7459c3c7, 2026-11-10). В version.txt и bgNPC.VERSION указана 2.3.1. Между тегом и базой — 48 коммитов. Номер версии не подтверждает публикацию в Workshop.
Локальные исправления Animator после базы: dance запускается после очистки состояния, активные анимации донора синхронизируются готовым игрокам при входе в PVS, остановка снимает установленную Animator заморозку NPC, клиентские копии сохраняют внешность при запуске. См. анимации от модели-донора. Публикация не проверена.
До 2.3.0 включительно¶
| Период | Изменения и актуальный раздел |
|---|---|
| 1.x | Исходные NPC/состояния, редактор/компиляция маршрутов, настройка популяции/команд, розыск/арест, голоса, интеграции. Старые маршруты и совместимость API всё ещё важны; примеры SLibrary/SNet устарели. |
| 2.0.0–2.0.1 | Переписанное ядро со своими классами/сетью/планировщиком, опциональные NextBot и GOAP, провайдеры навигации, меню, фоновая толпа; исправления идентичности/сущностей толпы. Обязательная SLibrary удалена. Архитектура, мозги, толпа. |
| 2.1.0–2.1.2 | Развитие поведения/настроек; стартовые окна только владельцу одиночной игры/listen-сервера; возвращены NPC/FSM по умолчанию, исправлена смерть в анимации. Старт. |
| 2.2.0 | Классические страницы spawnmenu, административная команда bgn_classic и чат-алиасы; очистка тел по умолчанию выключена и не мешает внешней очистке. |
| 2.2.1–2.2.2 | Восстановление/конверсия старых маршрутов и дубликаций, порядок сохранения/загрузки, сохранность существующих точек и больших графов, циклические данные акторов, экспорт маршрутов Workshop; удержание позы арестованного. Навигация. |
| 2.3.0 | Нарушители и передача врагов видимым союзникам; анимации безоружного NextBot/опция прыжка/выход из машины; движение/жесты/анимации; избегание медиками места убийства коллеги; розыск после отказа от ареста; удержание огнестрела полицией; синхронизация диалогов/голоса/состояния, защита ареста от союзников. |
Исторические исправления объясняют текущие контракты; это не отдельные API для восстановления. Текущие значения по умолчанию: тело npc, мозг fsm.
После 2.3.0: текущая ветка 2.3.1¶
| Область | Актуальное поведение / раздел |
|---|---|
| Спавн/отладка | Атомарные проверки видимости/места, оверлей администратора, рециклинг невидимых акторов, отдельный радиус машин, скрытый корпус машины и догоняющее подкрепление; укрытие должно перекрывать луч взгляда не ближе 40 единиц до точки спавна, собственная машина игрока укрытием не считается. Навигация, тестирование. |
| Машины | Измерение направления simfphys, обход пешеходами, ограниченный поиск манёвра/другой полосы, очистка; исходный интервал сенсоров DV сохранён; возврат водителя/пассажиров полиции, доступ к служебным машинам. Транспорт. |
| Персонаж | Стабильные Actor/UID при замене сущности DV, безопасное здоровье, выход у сиденья с проверкой hull, сохранение посадки при блокировке; урон пассажиру через реакции/свидетелей. Actor API. |
| Полиция | Исправлен порядок регистрации ареста; сдача не возобновляет бой; офицеры удерживают арест, пока не атакованы; стреляют по врагу в машине; актёра в неподвижной машине взламывают и арестовывают как игрока (полицейские у дверей больше не мешают его вытащить); выстрелы по машине любой базы бьют сидящих полностью, а через bgn_police_car_kill_time секунд полиция убивает водителя; безоружный актёр вне боя сдаётся полиции с шансом 30% за попадание. Арест. |
| Банды | «Чёрный Ворон»/«Красный Волк», лёгкие/тяжёлые бойцы, модели/оружие, начальный состав стычки, войны, движение группой; жертва прямого удара отвечает вне лимита. Банды. |
| Частота боя | Региональная пауза защиты 60 с только между акторами; атаки игрока/чужого NPC не задерживаются, полиция — никогда; текущая стычка и самозащита сохраняются. Полиция в машине получает общих врагов и замечает враждебных NPC/NextBot рядом с машиной, после чего выходит. Бандиты возрождаются через 30 с. Банды. |
| Медики/тела | Вердикт безнадёжности, осмотр/очистка тел, освобождение вызовов; наезд спасается с обычным шансом; защита медиков/скорых. Медики и тела. |
| NextBot/урон | Выход из застревания на свободную точку, без телепорта в машину; исправлены пользовательские сиденья. Мозги, транспорт. |
| GOAP | Завершённые действия (укрытие, подкрепление) продвигают план, а не блокируются; нет бесконечного цикла укрытия; полицейский с арестом заставляет план ждать; выбор реакции не запускает сдачу. GOAP планирует только бой, начатый FSM (defense/retreat); реакции снова берутся броском конфига, сам по себе враг бой не начинает. Полицейский в меньшинстве уходит в укрытие и вызывает подкрепление, объявляя врагов в розыск; один вооружённый враг подкрепление больше не вызывает. Мозги. |
| Розыск | Как в 1.x, таймер стоит полным, пока жители видят цель, в том числе актора (а не только когда он дерётся); цель в машине видна сквозь корпус машины. Разыскиваемый NPC получает уровень каждые bgn_wanted_level_up_period секунд. Разыскиваемый NPC снимается с розыска через 15 с вне поля зрения всех игроков либо дальше половины bgn_spawn_radius_visibility (препятствия не учитываются); запрет появления транспорта перед игроком перенесён в bgn_vehicle_spawn_visibility_radius. Розыск, меню. |
| Очистка | Тела актёров без живого зарегистрированного актёра удаляются через 3 с независимо от здоровья (застывшие тела, убитые во сне LOD), в том числе при bgn_enable 0. Мозги. |
Исправление в рабочем дереве после этой базы (строка версии 2.4.0, публикация не проверена): дверные сцены используют
только полностью закрытые двери, стук направлен на полотно, а открытие/удаление связанной двери возвращает участников
обычному ИИ. Админская команда спавна тоже использует поиск позиции у двери. См. сценические сцены.
Пять требующих контекста сцен (оба дивана, радист, наблюдение за небом и удерживание двери) сначала оставили только
для ручного спавна; модели всех сценических акторов назначаются обычным спавнером и его хуками без подмены сценой.
GOAP-акторы в безнадёжном бою могут закрыть и удерживать открытую распашную дверь; полиция выбивает её ногой,
отбрасывая удерживающего временным регдоллом без дополнительного урона. Подъём сохраняет исходного актора/сущность
и здоровье, требует свободного места и возвращает прежнее боевое поведение/бегство. См. мозги.
Админский Tool «Отладка сцен» добавляет видимое ручное размещение, осмотр моделей/состояний/анимаций, удаление своих
тестов/Undo и один цикл проверки двери GOAP. Консольный спавнер использует тот же путь размещения и Undo.
Стулья освобождаются при удалении сценических тел; прежняя посадка завершается до размещения сцены.
См. отладку сцен.
Ошибки Tool различают промах мимо двери, открытую/движущуюся дверь и нехватку места на полу. Тестовые акторы
исключены из автоудаления/перемещения популяции и очистки сцен по времени жизни/расстоянию.
Переработка scenic возвращает диваны/радиста в автоспавн только внутри помещений, убирает испуганных у стены,
отделяет настенную усталость от напольных поз, добавляет сидение на уступах и одиночные варианты поз; пара на диване
создаётся только целиком. Чекбоксы сцен и carry_items в конфиге актора управляют будущим спавном. У жителей общий
шанс предмета 5%. Последующее исправление оставляет двуручные позы пайка/газеты только NextBot и визуальным
призракам; HL2 NPC сохраняют обычную ходьбу с клиентским кейсом на кости правой руки. Штатная газета заменяет
скрытый паёк, управляющий позой, и следует обеим кистям; извлечённые или новые игровые ассеты не поставляются. Маленькие предметы убираются. Кейсы на обоих типах тела остаются прикреплёнными до боевого состояния, не бросаются физическими объектами и не требуют анимаций багажа. Админский Tool отладки предметов позволяет принудительно выдать предмет спокойному безоружному актору.
Прямой нападающий без общей команды теперь добавляется во враги с первого попадания, в том числе во время идущего боя. Полиция больше не удерживает двери; выбивание дверей остаётся доступным.
Посадка на пропы теперь завершает ближний подход после остановки маршрута. Сидящие сценические NextBot больше не поднимаются и не скользят под действием физики; для уступа дополнительно проверяется опора непосредственно под тазом.
Предметы у призраков удалены в обоих режимах; при превращении серверного призрака автоматический выбор предмета запрещён. Кейс висит вертикально на хвате пальца; нижний край газеты следует за пальцами, текст ориентирован прямо, верх отклонён от лица на 15 градусов. Границы отрисовки учитывают положение рук, чтобы предметы не исчезали крупным планом.
Прогрев кэша сущностей при первом появлении игрока возвращён: BGN временно создаёт NPC и машины из конфига для прогрева их ресурсов. Отношения к NextBot теперь выбираются по самому частому отношению стороннего NPC к игрокам сервера, с нейтралитетом при равенстве, вместо скрытых NPC-проб. Для обычных тел NPC HL2 сохраняются прежние правила отношений. См. мозги.
Локальное изменение поведения банд после указанной базы: ходьба группами до трёх; вместо ограниченного случайного состава боя — помощь всем видимым союзникам своей банды, включая подошедших позже. bgn_gang_help_chance больше не используется; интервал помощи задаёт bgn_enemy_share_period. См. банды.
Локальное дополнение отладки: в Spawnmenu Options появилась страница «Отладка» с отдельными отображениями, серверным инспектором актора для администратора (состояния/реакции, веса и сохранённый план/факты GOAP), визуализацией LOS/FOV и камерой с автоматическим выходом. См. управление отладкой. После проверки в игре увеличен и масштабируется текст отладки, добавлены переносы строк инспектора, исправлен сброс камеры при обновлении списка; отображения, видимость, пути, урон, GOAP и камера проверены в одиночной игре. Визуальная проверка также выявила камеру у ног NextBot (метод глаз только на сервере) и голову внутри камеры; исправлены передачей серверного положения глаз и временным подавлением отрисовки наблюдаемого тела.
Локальная переработка отладки: Tools редактора и отладки разделены. Инспекция по UID по умолчанию показывает одного актёра, записывает настоящее восприятие и сигналы команды; добавлены ограниченная история, HUD/3D2D, дальности, WH, фильтры и заморозка. Готовые mesh линий заменяют отдельные немедленные проходы. Предпросмотр сцен и маркеры рук используют общие настройки; перемещение возвращает прежние флаги/состояние. Игровые правила стелса не меняются. Проверка в игре также выявила и исправила отсечение модели предмета в старой точке после телепортации актёра. См. управление отладкой.
Аудит текущей ветки против 1.13.7 от 2026-11-12 (что осталось, что изменилось, что может сломать старое поведение) — в сравнении с 1.13.
Повторить сравнение¶
git log --reverse --no-merges --oneline 2.3.0
git log --reverse --oneline 2.3.0..7459c3c7
git diff --stat 2.3.0 7459c3c7 -- lua docs
Перед изменением контракта читайте реализацию и вызывающих: название коммита само по себе не доказывает поведение. Правила сопровождения.
Локальное изменение: дальняя логика актёров использует настраиваемые паузы/окна работы со сдвигом; см. LOD.
Локальное изменение оружия: одиночные/короткие серии пистолета NextBot, личная память полиции о пострадавших, сброс сведений и арест с наведённым основным оружием. См. поведение.
Локальное изменение сети: PVS-синхронизация актора отправляет идентичность (сущность, тип, поколение, класс, модель, имя, пол) только при первом появлении или перепривязке, иначе — только изменившуюся часть состояния; не больше 8 отправок за тик. См. архитектуру.
Локальное исправление транспорта: при захвате машины принудительная высадка использует исходных пассажиров вместо глубоких копий их акторов. Восстановленные тела сохраняют регистрацию и AI, а не замирают с последующим удалением как бесхозные. См. транспорт.
Локальное исправление транспорта 2: актор, выходящий из едущей машины (полиция, приехавшая на погоню), 3 секунды не получает урон от этой же машины, поэтому быстрая машина больше не убивает офицера при выходе, после чего безжизненное тело стояло на месте и удалялось. См. транспорт.
Локальное изменение рабочего дерева 2.5.1 (публикация не проверена): память конфликтов по подтверждённому урону, свидетели видят нападающего, помощь по видимости зовущего, общие пороги розыска игрока/ACTOR, розыск внешних угроз и эскалация ареста у ведущего офицера. См. розыск и арест.
Локальное уточнение: атака известного врага наблюдателя не обвиняет невраждебного нападающего; существующая вражда и D_HT в любом направлении запрещают исключение. Оно применяется до выбора по инициатору, также при начале ареста и подсчёте урона неполицейским. IsEnemyOfTeam теперь учитывает собственных врагов наблюдателя. См. конфликты.
Локальное уточнение: начатый звонок полиции больше не требует непрерывного LOS и не отменяется из-за розыска/полицейской команды цели. Прерывание из-за угрозы — строго ближе 300 единиц. Союзная помощь и перепланирование GOAP сохраняют звонок; условия входа и фильтры завершения остаются. См. розыск.