Режим тестирования¶
Регрессии инженерного аудита Core¶
python tools/test_core_audit.py запускает 21 изолированный LuaJIT/lupa-тест из
tests/sv_engineering_audit.lua; SERVER bgn_selftest загружает тот же файл по запросу без живых сущностей.
Проверяются изменение списка задач, постоянные службы, механики, UID/снимки после reload, удаление на клиенте,
неверные/частичные сетевые данные, навигация, GOAP, внешность и права/учёт спавна gamemode,
регенерация, IO spawnmenu, LOD строковых UID и клиентская загрузка сидений. Дополнительные случаи проверяют
принудительный и заблокированный выход, смертельный урон без визуальной сущности DV и наблюдателей розыска,
ожидающих замены сущности. Повторная проверка добавила отсутствие тела при регенерации, фоновых голосах,
опросе отношений и уступке бюджета сканирования. Все 21 падают на исходном dev
с --baseline и проходят после исправлений. Вызовы движка моделируются; это не нативная проверка игры.
См. решения аудита и оставшиеся ограничения.
Для интерактивной проверки scenic и дверей GOAP используйте админский Tool «Отладка сцен».
tools/scenic_tool.lua проверяет настоящий серверный Tool, обычный Undo, освобождение стула, диагностику моделей
и один цикл взаимодействия с дверью на телах NPC и NextBot через временный одиночный мост. Нужен отдельный стенд
gm_bigcity_improved с NavMesh. Отчёт: data/bgn_scenic_tool_lab/tool.json.
Оставьте включёнными задачи автоудаления акторов и обслуживания scenic: проверки очистки подтверждают,
что тест сохраняется, а обычный контрольный актор удаляется при bgn_enable 0; затем настройка восстанавливается.
tools/door_hold.lua — опциональный сценарий для отдельной одиночной сессии gm_bigcity_improved через временный
Lua-мост, не autorun аддона. Проверяет реальный выбор GOAP для удерживания/выбивания во всех четырёх сочетаниях
тел NPC/NextBot и при четырёх поворотах двери, физическое отбрасывание, сохранение актора/сущности/здоровья,
восстановление настроек двери, заблокированный подъём, запрет принудительной смены состояния, удаление удерживающего
или регдолла и урон/смерть лёжа.
Отчёт: data/bgn_door_lab/doors.json. Создаёт стандартные тестовые модели и двери, временно перемещает наблюдателя,
приостанавливает автоматический спавн, затем удаляет свои объекты и восстанавливает задачи и наблюдателя.
Запускать на стенде, а не в текущей игровой сессии.
tools/seating_lab.lua проверяет 32 случая посадки на обоих типах тела: два штатных пропа-стула с четырьмя
поворотами, ближний и дальний подход, пользовательские места на скамейках BigCity, сценические стулья/скамейки
и обе позы уступа на мужской и женской моделях. Проверяются опора под тазом, направление к перепаду высоты,
неподвижность и восстановление физики/освобождение места после выхода. Запускать только на отдельном одиночном
стенде с портом 27025; отчёт: data/bgn_seat_lab/seating.json.
Дополнительные сценарии через тот же временный мост одиночного стенда:
| Сценарий | Проверки в движке | Отчёт в data/bgn_scenic_overhaul_lab/ |
|---|---|---|
tools/scenic_poses.lua |
Позы NPC/NextBot, контакт со стеной/дверью, отклонение улицы, оба пола на диванах, целостность пары и уступы из brush-геометрии | poses.json |
tools/carry_items.lua |
Tool/обычный спавн: кейс HL2 без оружия/смены активности, ходьба NextBot с пайком/чемоданом/газетой, скрытый паёк, убирание, бросок/удаление | carry.json |
tools/ghost_carry.lua |
Отдельный запуск на SERVER и CLIENT: отсутствие предметов у обоих видов призраков и после превращения в NPC/NextBot | ghost-server.json, ghost-client.json |
tools/ragdoll_identity.lua |
Тот же актор/сущность, последнее здоровье/максимум, оружие/магазин, входящие/исходящие отношения и запись розыска после подъёма | identity.json |
Для повторяемости используются штатные модели с анимациями. Сценарии удаляют свои сущности и возвращают
изменённые настройки; они не подтверждают совместимость каждой сторонней модели или сетевой игры.
scenic_poses проверяет уступ на настоящей BSP-геометрии, не подменяя результаты трассировки.
tools/carry_alignment.lua — опциональная CLIENT-проверка в кадре отрисовки на отдельном одиночном стенде. Измеряет привязку нижнего хвата газеты к пальцам, наклон наружу на 15 градусов и вертикальную ручку кейса относительно хвата указательного пальца. Нужны также снимки спереди/сбоку мужской и женской моделей в ожидании и при реальной ходьбе; измерения не заменяют визуальную проверку. Отчёты: data/bgn_paper_lab/alignment-idle.json и alignment-walk.json.
Проверки вне игры (lupa): python tools/test_regressions.py, python tools/test_scenic.py, python tools/test_carry_items.py.
Минутная проверка, которая отвечает фактами на «ничего не спавнится» и «я админ, но не могу менять настройки». Откройте Настройки → Инструменты → Тестирование (для админов) или введите команду в консоли:
| Команда | Кому | Что делает |
|---|---|---|
bgn_test |
админам | Полный тест (ниже). |
bgn_test_settings |
всем | Только проверка прав и изменения настроек. Запустите её первой, если настройки не меняются. |
bgn_test_report |
всем | Снова открывает результаты последнего теста. |
bgn_test_stop |
запустившему тест, админам | Останавливает тест. |
Что проверяет полный тест¶
| Проверка | Как |
|---|---|
| Аддон и карта | bgn_enable, провайдер навигации и число точек. |
| Права администратора | Что сервер и клиент знают о вашей группе (IsAdmin, IsSuperAdmin, группа). |
| Изменение серверных настроек | Клиент меняет тестовый cvar bgn_test_server_value так же, как любая строка настроек, сервер должен его получить; затем сервер меняет значение сам, и клиент должен его увидеть. |
| Изменение клиентских настроек | Тестовый cvar bgn_cl_test_value меняется и читается обратно. |
| Актёры появляются сами | Актёры уже есть, или обычный спавнер создаёт хотя бы одного за 15 с. Если нет, называется вероятная причина: аддон выключен, нулевые лимиты, нет навигационных точек, нет места вне поля зрения, другой аддон. |
| Актёры появляются по запросу | По одному актёру каждого активного типа создаётся на свободных местах рядом с вами, мимо лимитов и правил видимости. Типы, которые появляются только при розыске, пропускаются. |
| Машины | Загружен Decent Vehicle, на карте есть его маршруты, модели машин из конфига установлены; создаётся водитель с машиной, и он должен сесть. Отсутствие Decent Vehicle это предупреждение, а не ошибка. |
| Актёры не исчезают | Созданные актёры и машины должны существовать через 12 с. Актёр, созданный сверх лимита своего типа, штатно удаляется (лог это отмечает). |
| Состояния актёров | У каждого актёра есть сущность и известное состояние, он стоит внутри мира, идущие действительно двигаются, а принудительная смена idle / walk принимается. |
| Где находятся актёры | Актёры ближе 700 единиц друг к другу образуют группу. Камера пролетает над четырьмя самыми большими, обводит актёров и отмечает место лучом и сферой. Пробел пропускает показ. На это время вы заморожены и неуязвимы. |
Тестовые актёры и машины удаляются в конце, изменённые cvar'ы возвращаются.
Кнопка «Исправить»¶
Если причина очевидна и лечится настройкой, админ видит в строке кнопку Исправить: аддон выключен, нулевой общий лимит, выключены все типы актёров, радиус появления без точек, радиусы блокировки и видимости не оставляют свободных мест, выключена поддержка машин. Кнопка возвращает значения по умолчанию только у этих консольных переменных (лог их перечисляет) и предлагает запустить тест снова. Для прав, отсутствующих аддонов и карт без навигации кнопки нет: настройкой это не исправить.
Окно результатов¶
Оно выглядит как окно настроек, с тем же переключением светлой и тёмной темы, и содержит строку на каждую проверку:
значок (пройдено, предупреждение, ошибка) и короткое понятное предложение. Копировать лог кладёт в буфер полный
технический отчёт (он также сохраняется в data/background_npcs/test_report.txt, а консоль сервера его выводит).
Вставьте его в сообщение об ошибке. Предложения следуют языку интерфейса, лог всегда на английском.
Примечания¶
- В одиночной игре и на listen-сервере клиент и сервер используют общие консольные переменные, поэтому проверка серверных настроек может пройти и без прав администратора; тогда она заканчивается предупреждением. Запускайте её на настоящем сервере.
- Полный тест доступен только администраторам; у остальных
bgn_testвыполняет только проверку настроек. - Два тестовых cvar'а есть и ползунками в Инструменты → Тестирование: меняйте их вручную, чтобы увидеть, как работает обычная строка.
- Исходники:
lua/background_npcs_core/debug/(sv_diag.luaвыполняет проверки,cl_diag.luaотвечает за камеру и окно). Проверка это функция, вызывающаяSection(id),Log(...)иResult(status, phrase, ...); фразы лежат вresource/localization/<lang>/bgn_diag.properties.
Отладочное отображение и регрессии¶
Отладка доступна администраторам при bgn_debug 1 (SERVER). Настройки CLIENT меняют только отображение наблюдателя.
Инспектор записывает существующие решения: не запускает сенсоры, не выбирает реакции заново, не продвигает планы
и не меняет правила стелса.
Страница отладки в Spawnmenu¶
Откройте Q → Options → Background NPCs → Отладка либо Инструменты → Background NPCs: Отладка → Инспектор актёров. Выберите актёра из обновлённого списка или под прицелом. Выбор хранится по UID, включая замену тела. Закрепление запрещает ЛКМ инструмента инспекции менять выбор; явный выбор в меню остаётся доступен. Основной режим — один актёр и его связи; обзор ближайших включается отдельно.
Инструменты → Background NPCs: Редактор содержит точки маршрутов, зоны спавна и сиденья. Background NPCs: Отладка содержит инспектор, поиск пути, перемещение актёра, сцены и предметы в руках. Идентификаторы Tools сохранены; внутренний спавнер актёров остаётся скрытым.
| Cvar CLIENT | По умолчанию | Назначение |
|---|---|---|
bgn_cl_debug_mode |
0 | 0: экранный HUD; 1: карточки в мире (3D2D); 2: только геометрия. |
bgn_cl_debug_inspector |
1 | Экранный HUD выбранного актёра. |
bgn_cl_debug_bounds / bgn_cl_debug_labels |
1 / 1 | Габариты / текст карточек в мире. |
bgn_cl_debug_summary |
1 | Время сбора/отрисовки и число отрезков внизу HUD. |
bgn_cl_draw_npc_path |
0 | Существующий путь выбранного актёра с SERVER. |
bgn_cl_debug_targets |
1 | Связи с известными врагами: память, а не текущая видимость. |
bgn_cl_debug_vision |
0 | Записанные игровые проверки зрения и препятствия. |
bgn_cl_debug_signals / bgn_cl_debug_history |
1 / 1 | Сигналы команды / последние события. |
bgn_cl_debug_text_scale |
1 | Масштаб текста 0,75–2; учитывает высоту экрана, 20 px при 900p. |
bgn_cl_debug_distance / bgn_cl_debug_geometry_distance |
800 / 1500 | Независимые дальности текста / геометрии в HU, каждая 100–5000. |
bgn_cl_debug_wh / bgn_cl_debug_overview |
0 / 0 | Геометрия сквозь стены / обзор ближайших актёров. |
bgn_cl_debug_related / bgn_cl_debug_cards |
16 / 8 | Лимит связей 1–64 на список / видимых карточек 1–16. |
bgn_cl_debug_rate |
5 | Частота снимков выбранного актёра, 2–10 Гц. |
bgn_cl_debug_seconds / bgn_cl_debug_life |
30 / 2 | Окно истории 1–30 с / время линий 0,2–10 с. |
bgn_cl_debug_blockers / bgn_cl_debug_markers |
1 / 1 | Препятствия зрения / маркеры сцен и рук. |
bgn_cl_debug_marker_size |
12 | Размер маркеров 2–48 HU. |
bgn_cl_debug_team_filter, type_filter, state_filter, event_filter |
пусто | Поиск подстроки; все четыре имени имеют префикс bgn_cl_debug_. Фильтр событий ищет по виду события. |
bgn_cl_debug_freeze / bgn_cl_debug_technical |
0 / 0 | Заморозка данных отладки / технические имена на HUD. |
Редкие настройки находятся в Ограничения и фильтры. Карточки масштабируются с расстоянием и подавляются при наложении; текст переносится, длинные отчёты доступны для копирования. Обновление списка сохраняет выбор и камеру. Зафиксировать снимок останавливает отображаемые данные, но не игру и не живую камеру.
Компактный HUD показывает здоровье, состояние, реакцию, известных врагов/цели, розыск, движение, зрение и события. Открыть подробности добавляет исходное имя/группу состояния, отказ от боя, модель/анимацию, предмет в руках, веса реакций, время последнего наблюдения известных целей и сохранённый план/факты GOAP. У FSM плана GOAP нет. Взвешенный выбор реакции — кандидат, а не подтверждение разрешения последующими хуками. Попытка урона записывается до отмены; событие реакции не подтверждает фактическую потерю здоровья.
Зрение берётся из настоящих вызовов HasLineOfSight / CanSeeEntity. Каналы различают свидетеля урона/выстрела,
память врага, обмен между союзниками, помощь, розыск и группу. Зелёный — успешная проверка, красный — неуспешная
с точкой попадания и препятствием, включая геометрию карты; фиолетовый — память о враге, жёлтый — сигнал.
Отклонённый сигнал красный. Нет проверки — неизвестно. Конус появляется только после настоящей проверки
направления, использует записанный вектор взгляда и тот же порог скалярного произведения, что Util.IsInView;
длина 100 HU условная. Обычный LOS не ограничен поворотом головы. Известный враг может быть сейчас невидим.
Обнаружение вблизи по розыску и радио не означают успешную трассировку. Отладчик не добавляет луч к игроку.
События команды показывают отправителя → получателя и обсуждаемую цель. Помощь, обмен, радио и группа записывают итоговое наличие врага; запрет реакции свидетеля отмечается отдельно. У рассылки розыска нет актёра-отправителя. Это ограниченный журнал подключённых участков, а не запись всех отклонённых ветвей ИИ.
SERVER собирает выбранные снимки с заданной частотой и переиспользует результат одинаковых подписок внутри одного такта. Список запрашивается явно, не чаще 1 Гц; обзор обновляется в 2 Гц в пределах 5000 HU. Автоматического потока всех актёров нет. На наблюдаемый UID: до 256 событий и 64 записей зрения; путь ограничен 256 точками, список — 128 актёрами, клиентская геометрия — 1024 отрезками. Ограничения отмечаются в HUD. CLIENT строит текст и цветной mesh линий при снимке/настройке и рисует готовый пакет каждый кадр; маркеры сцен/рук обновляются в 2 Гц. Покадрового поиска актёров и отладочных трассировок зрения нет. Время в HUD измеряет сбор и клиентскую отрисовку, а не весь кадр или передачу по сети.
Вид от лица актёра следует за глазами. F6, Escape или Вернуться к своему виду освобождает камеру.
SERVER добавляет камеру в PVS администратора и блокирует движение/атаки. Тело игрока остаётся уязвимым.
Смерть/удаление, смерть наблюдателя, потеря прав, очистка карты, отключение отладки или потеря подписки
освобождают камеру. Продление — раз в секунду, срок подписки — 3 с; незамороженная геометрия старше 2 с скрывается.
SERVER передаёт положение глаз относительно тела NPC/NextBot; CLIENT следует за интерполяцией тела.
Отрисовка только наблюдаемого тела временно подавляется и восстанавливается при выходе; серверный NoDraw сохраняется.
Особенности Tools:
bgn_path_finder: ЛКМ — начало, ПКМ — назначение, R — сброс. Использует активную навигацию SERVER; маркеры концов и число точек относятся к запрошенному пути, отдельно от текущего пути актёра.bgn_actor_mover: ЛКМ — актёр, ПКМ — назначение, R/смена инструмента — освобождение. Настраиваются шаг/бег и допуск прибытия. Управляет один владелец; прежние флаги debugger/eternal/блокировки и данные состояния возвращаются при освобождении. Этот инструмент намеренно меняет движение и не является пассивной инспекцией.bgn_scenic_debug: сохранены размещение, осмотр, тест двери GOAP и удаление своих объектов/Undo. Предпросмотр переиспользует проверки размещения, показывает габариты участников и причины отказа, ничего не создаёт. Использует минимальную группу без RNG; спавн может выбрать иной размер/поворот/вариант модели.bgn_carry_debug: сохранены проверки выдачи/снятия. Оси костей, габариты предмета, совместимость модели/анимации и расстояние от ручки кейса до пальца помогают проверить привязку; число геометрическое, не оценка качества рига. Оба специальных инструмента имеют общие дальности, WH, размер маркеров и копируемый отчёт.
Команды: bgn_debug_select [uid], bgn_debug_details, bgn_debug_tool_details, bgn_debug_watch,
bgn_debug_watch_stop, bgn_debug_clear, bgn_debug_pin, bgn_debug_freeze.
python tools/test_actor_debug.py (lupa) проверяет права/параметры, снимки без изменения ИИ, ограниченную историю,
препятствия карты, записанный взгляд, жизненный цикл камеры, ключи EN/RU и восстановление после перемещения.
В одиночной игре на gm_bigcity_improved (1280×720, 1600×900, 1920×1080) проверены категории, настоящий урон/зрение/препятствие и обмен
врагом, HUD/3D2D и дальность, камера NPC/NextBot, обновление/заморозка, предпросмотр/удаление сцен, выдача/снятие
предмета и кеширование mesh. Замеры на 30/60/100 актёрах покрывают инспекцию и дополнительный обзор;
это не гарантия общего FPS. Мультиплеер, сторонние камеры и произвольные риги требуют отдельной проверки.
python tools/test_regressions.py (требуется lupa) проверяет Lua-логику вне GMod: безопасные методы здоровья актора на сервере и клиенте, порядок регистрации ареста, урон и свидетелей в машинах, направление взгляда пассажира, выход возле сиденья или заданного выхода модели, запрет пересечений и переход на свободную сторону. Эти проверки не подтверждают физику в игре и расположение выходов у всех моделей транспорта.
Проверка осады помещения разработчиком¶
bgn_selftest включает tests/sv_siege.lua: изолированные проверки одного выхода, обходных/входящих связей,
отклонения улицы, требований класса/анимаций, вероятности удара и запасного жеста, общего резервирования
спецсредства, безопасности гранаты и таймеров ожидания/повторения. Они не подтверждают физику или полноту навигации карты.
tools/siege.lua — ручной SERVER-сценарий для отдельной single-player сессии gm_bigcity_improved,
комната возле setpos -748.617798 -4298.178223 -11071.968750. Создаёт восемь акторов и проверяет операторов
метрокоп/комбайн с телами NPC и NextBot, в том числе против игрока. Проверяет общий выход из двух створок,
отказ без анимации, пять ближних/три дальних участника, тихое ожидание, одно настоящее спецсредство,
его попадание в комнату, настоящий урон/его источник по целям-NPC, отмену при выходе/уроне и восстановление
возможностей NPC. Временно перемещает/вооружает наблюдателя,
приостанавливает задачи населения, убирает свои сущности и восстанавливает своё состояние. Запускать через
временный локальный SERVER-мост, не как autorun и не на публичном сервере.
Результаты: garrysmod/data/bgn_siege_lab/verification.json.
Проверка транспорта DV разработчиком¶
Новая логика применяется только к созданным BGN машинам (isBgnVehicle), исходный DV остаётся зависимостью. Полицейская принадлежность сохраняется в bgnPoliceVehicle: водителем и пассажиром может быть только актёр команды police. Игроку по-прежнему доступна пустая машина.
Пешеходы сохраняют сторону и точки обхода до завершения манёвра. 30% игнорирования осторожности перед дорогой не отключает навигацию вокруг твёрдого препятствия. Поиск транспорта выполняется не чаще раза в 0,5 секунды; спящие по LOD актёры его не выполняют.
Застрявший транспорт сначала ждёт и сигналит, затем ищет ограниченный местный манёвр вперёд/назад, включая встречную полосу или тротуар. Проверяются корпус и опора. Поиск работает в планировщике с бюджетом; управление остаётся частым. Штатная остановка, красный свет и ожидание пассажира не считаются затором. При отсутствии пути остаются ожидание и существующая очистка невидимых машин (bgn_vehicle_cleanup_time, по умолчанию 120 секунд).
Сценарии в tools/ запускаются через временный локальный файловый мост только в одиночной игре на gm_bigcity_improved. Сам мост не входит в автозагрузку аддона. dv_lab.py server <сценарий.lua> отправляет сценарий уже запущенной игре; результаты записываются в garrysmod/data/bgn_dv_lab/.
dv_stage1.lua: доступ к полицейскому транспорту.dv_headings.lua: направление корпуса и осей колёс четырёх моделей.dv_stage2.lua: обход NPC;BGNDVStage2Body='bgn_nextbot'выбирает NextBot.dv_stage3.lua: преграда;BGNDVStage3Scenario='turn'выбирает поворот,BGNDVStage3Baseline=true— исходный DV для сравнения.dv_guards.lua: красный свет, ожидание такси, штатная остановка, физически замкнутое пространство.dv_duel.lua: встречный разъезд.dv_benchmark.lua: неподвижные машины,BGNDVBenchCount=10|30|60,BGNDVBenchBaseline=trueдля сравнения. Это замер датчиков, а не дорожного поведения. Полеticks_per_second— серверные тики, не FPS отрисовки.
Запускайте сценарии по одному в тестовой сессии; они создают сущности и перемещают наблюдателя. Для Python-регрессий: python tools/test_regressions.py (нужен lupa). Геометрия локального автомобильного поиска рассчитана на преимущественно ровные улицы; нестандартные оси и крутые рампы требуют отдельной калибровки.
Полиция выходит при близком противнике либо критическом повреждении машины; нейтральный наблюдатель больше не вызывает выход и не запрещает возвращение. Прежний экипаж может занять свободные пассажирские места после посадки водителя. dv_return_lane.lua проверяет возврат полиции и физический переход на другую полосу в отдельной тестовой сцене. После двух неудачных поисков/манёвров обычный трафик пробует до трёх соседних дорожных сегментов с другим направлением: проверяются группы DV, высота дороги, габариты, опора и резервирование пути. Успешный манёвр передаёт управление DV на новом сегменте. Целевые поездки и погони сохраняют маршрут. Прогресс резервного перехода измеряется приближением к следующей точке, а не любым перемещением машины.
Резервный переход учитывает заднюю ось четырёхколёсных simfphys, тормозит и пересчитывает путь из фактической позиции при смене хода, пропускает неудачные съезды на 30 с. Его поиск ограничен 640 узлами; обычный объезд сохраняет 160 узлов и прежнее управление относительно центра кузова. Конечная дорожная точка должна быть впереди по направлению своего сегмента. В критически повреждённую полицейскую машину экипаж не возвращается. Сценарий фиксирует сам вызов переключения маршрута: опрос PrevWaypoint может пропустить его, если DV сразу проходит следующую точку. BGNReturnLaneOnly=true запускает только автомобильную часть.
Частота DoTrace остаётся штатной: свободная трасса продлевает StopByTrace лишь на 0,1 с, поэтому интервал проверки 0,2 с вызывает ложное торможение. Объезд включается при скорости ниже 25 HU/s и наличии препятствия либо отклонении курса более 60 градусов. Во время манёвра датчики обновляются, а освобождение пути возвращает управление DV. Неудачный манёвр заново запускает обычную паузу ожидания. Переопределения скорости актёра сохраняют штатные коэффициенты замедления DV; абсолютные лимиты остаются в HU/s.
dv_damage_horn.lua проверяет тишину на свободной дороге, короткий сигнал перед физическим препятствием (0,15 с, пауза 8–14 с), выход живых NPC/NextBot и появление ragdoll при смертельном уроне в машине. Отчёт: damage_horn.json. Сигнал требует почти неподвижной машины и попадания переднего датчика в сущность; геометрия карты его не вызывает. Точки выхода с перепадом более 96 единиц от позиции машины отклоняются: пассажир остаётся в салоне вместо выхода на другой уровень дороги. Тела погибших в салоне учитываются движком в лимите ragdoll.
Пассажиры и водитель сохраняют тот же объект актёра и UID в реестре населения. При посадке настоящий NPC/NextBot и его оружие удаляются; актёра представляет уже существующая anim-сущность DV. При выходе исходный тип тела, внешность, здоровье и снаряжение восстанавливаются в свободной точке с проверкой габаритов. При перекрытом выходе актёр остаётся в машине. Удаление машины удаляет экипаж, в том числе при прямом Remove сущности. Для внутренних данных сторонних NPC нужен обработчик BGN_ActorEntityChanged(actor, old, new).
dv_lifecycle.lua проверяет одновременную посадку, удаление и восстановление NPC/NextBot, сохранение UID/численности/целей, здоровья и оружия, перекрытый выход, повторную посадку и прямое удаление машины. dv_lifecycle_guards.lua — потерю и неудачное создание контроллера, заполненные места, сохранение розыска/истории убийств и очистку через провайдер. Отчёты: lifecycle.json и lifecycle_guards.json. Оба сценария убирают свои тестовые сущности.
Админский Tool Отладка предметов в руках (bgn_carry_debug) выдаёт выбранный кейс, еду или газету по ЛКМ и убирает по ПКМ. Цель — живой безоружный актор вне машины в спокойном состоянии; совместимость тела/модели проверяется. Проверяйте кейсы у мужчин/женщин NPC и NextBot при мирных действиях, беге и бое: физический кейс появляться не должен.
Клиентская модель предмета теперь перемещается вместе с родителем вместо отдельной мировой точки отрисовки: кейс или газета не остаются отсечёнными в прежней точке после телепортации актёра.
bgn_selftest также запускает tests/sv_conflicts.lua: изолированные модули/хуки проверяют направление/сброс/перенос/забывание инициатора, начало ареста по фактическому урону, видимость нападающего и зовущего, внешнюю враждебность, уникальных жертв при аресте, строгие пороги здоровья/дистанции, неподчинение и общий порог розыска игрока/ACTOR. Живые сущности не создаются; тесты не подтверждают порядок хуков движка, трассировки и физику машин.
tests/sv_pursuit.lua проверяет устойчивость и приоритет нападающего/групповой цели, наблюдение всех врагов, исходное время переданной памяти, подход к скрытой цели без удержания дистанции, укрытие только при видимости, колонну скрытой цели и включительную границу боевого радиуса. Для проверки в игре нужны обычные, не вечные акторы и включённое удаление населения: увидеть цель через открытую дверь, закрыть её, затем добавить подкрепление без ручного заполнения памяти. Проверить преследование/осаду и сохранение внутри радиуса, затем удаление за его пределами; отдельно проверить защиту NextBot от телепортации при застревании.
Регрессии боевого аудита¶
bgn_selftest загружает эти SERVER-тесты по запросу, без создания живых сущностей:
| Файл | Проверяемое взаимодействие |
|---|---|
tests/sv_pursuit.lua |
Настоящий NPC-адаптер с моделью обновления движковой памяти: поиск заканчивается спустя более 60 с, а реальное наблюдение его продлевает; настоящий Rebind переносит скрытую позицию/время и приоритеты в обеих ветвях окружения; оружие следует выбранному врагу с запасным выбором цели ареста; обе настоящие функции телепорта NextBot запрещают его в бою при 1000 и разрешают при 1000.1, сохраняя защиту осады. |
tests/sv_siege.lua |
hold_fire переговоров запрещает начало осады и присоединение ведомого. |
tests/sv_negotiation.lua |
Возможности оружия снимаются и восстанавливаются, возможности дверей сохраняются. |
tests/sv_conflicts.lua |
Дружественный урон манхака блокируется при обоих порядках хуков владельца/реакции, включая владельца только через inflictor; недопустимый владелец не подставляется. |
Внешний запуск LuaJIT/lupa после исправлений прошёл 36 тестов конфликтов, опасного оружия, переговоров, преследования, осады и планировщика GOAP. Шесть затронутых проверок падали на прежней реализации. Внешняя среда моделирует API движка и не является нативным запуском bgn_selftest. Мультиплеер, физика транспорта/дверей, реальное время движковой памяти и scripts reload во время этих действий требуют отдельной проверки.
tests/sv_team_damage.lua выполняет 10 изолированных регрессий с настоящими модулями команд, врагов, урона, розыска, ареста и транспортной реакции: союзные попадания NPC/NextBot при командном уроне выкл./вкл.; отказ помощи/сообщения; рассылку розыска и очистку устаревшей записи; обычные убийства; очистку SetTeam/AddTeam; повторный таран пешего полицейского или полицейской машины и наезд на пешехода оставляют водителя в residents. tools/test_police_force.py также проверяет, что дальнее союзное попадание не создаёт угрозу стрелка. Вызовы движка моделируются; это не проверка настоящей физики.