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

Сравнение с 1.13 (Classic)

Дата аудита: 2026-11-12. Сравнивались релиз Classic 1.13.7 (тег 1.13.7, нужна SLibrary) и текущая ветка dev на da58946d (в рабочем дереве версия 2.4.0, публикация в Workshop не проверялась). Сравнение статическое: исходники читались бок о бок, пробелы не учитывались. В игре не проверялось. Проценты ниже считают неизменённые строки, а не одинаковое поведение.

1.13.7 Сейчас
Lua-файлов в background_npcs_core 212 298
Строк Lua (с компилированными маршрутами) ~20 500 ~36 000
Зависимость SLibrary нет
Файлов в sound/materials/models/resource 47 981

Итог. Внешний контракт (конфигурация, cvar, хуки, команды, сохранённые данные) почти не изменился. Внутри мод переписан. По умолчанию тело — по-прежнему HL2 NPC (bgn_actor_body npc), мозг — FSM (bgn_brain fsm), но поведение в игре отличается из-за новых систем и изменённых правил спавна, навигации и розыска.

Не изменилось

  • Конфигурация: config/sh_main.lua, sh_config.lua, sh_player.lua, примеры custom_modules/*, модули денег и дверей DarkRP совпадают с точностью до пробелов.
  • Точки расширения: custom_modules/config|preload|postload, bgNPC.cfg.*, bgNPC.cfg:SetActor/SetActorData, адаптер старого конфига (config/sh_oldconfig.lua).
  • Хуки: все 54 хука BGN_*, которые вызывала 1.13, вызываются и сейчас с теми же аргументами (отличаются только имена локальных переменных). Исключение по смыслу — BGN_WantedLevelDown, см. ниже.
  • Методы актора: все 116 старых методов есть; StopStaticSequence — псевдоним ResetSequence.
  • Глобальный API: все 85 методов bgNPC:* есть, напрямую или через псевдонимы совместимости в api/compat/sh_legacy.lua.
  • Команды: все старые консольные команды на месте, кроме bgn_cl_draw_chunks_reload (система чанков удалена) и cmd_bgn_spawnmenu_default_spawner (закомментирована ещё в 1.13).
  • Данные: background_npcs/nodes/*.dat|json, citizens_points/, seats/, spawn_area/, custom.dat. Старые файлы маршрутов конвертируются в новый граф при загрузке и не удаляются; см. навигацию. Встроенные compile-файлы карт пишут формат маршрутов 1.2.
  • Инструменты и интеграции: все старые Tools, сущности DV и модули ULX.

Изменилось частично (логика та же, код переписан)

Область Неизменённых строк
FSM-состояния walk, idle, fear, retreat, run_from_danger, steal, killer, impingement, dyspnea, сидение на стульях, zombie 57–92%
Состояния defense / arrest 68% / 66%
Ядро спавнера / спавн акторов / зоны спавна / спавн машин DV 58% / 49% / 77% / 82%
Класс розыска / логика розыска (имена сетевых сообщений сохранены, SNet заменён) 57% / 66%
Отношения / team parent / реакции на урон и выстрелы 54% / 77% / 35–59%
Спавнменю, звуки окружения 76–85%, 77%

Большая часть отличий — замена вызовов SLibrary на bgNPC.*. Конфиги акторов по содержанию изменились только так: у горожан getting_weapon_chance 30 → 10 и carry_items; у банд respawn_delay = 30; веса dialogue.

Изменилось сильно

  • Ядро: classes/, global/, actions/ заменены одним циклом обновления акторов с LOD, адаптерами тела (HL2 NPC / NextBot) и мозгами (FSM / GOAP); см. архитектуру и поведение.
  • Навигация: свои узлы и «динамическая сетка» заменены провайдерами (bgn_nav_provider auto: сохранённый маршрут → navmesh → nodegraph → свой генератор). Удалены cvar bgn_dynamic_nodes_type, bgn_dynamic_nodes_alternative, bgn_enable_dynamic_nodes_only_when_mesh_not_exists, bgn_chunk_*.
  • Диалоги: bgNPC.cfg.dialogues (фразы HL2 vo/*) заменён на bgNPC.cfg.conversations со своей озвучкой; см. разговоры.
  • Тактические группы: новая реализация (строй колонна/клин/линия, лидер, раненые сзади), включена по умолчанию. bgNPC:GetTacticalGroupGetFirstEnemy / GetTacticalGroupGetNearEnemy удалены без псевдонима.
  • Банды: gangster выключен; две банды по 5% с войнами (bgn_gang_war_chance 0.5) и ходьбой группами; см. банды.
  • Новые системы: медики и тела (до 4), сценические сцены (bgn_scenic 1, до 4), предметы в руках (5% горожан), удержание и выбивание дверей с временным ragdoll, взлом машины при аресте, правонарушители, пауза между стычками акторов, фоновая толпа (выключена), подбор оружия (выключен).
  • Интерфейс: панели tool_options/* заменены окном настроек; старые панели частично доступны через bgn_classic.

Изменённые значения по умолчанию

Cvar 1.13.7 Сейчас
bgn_spawn_radius_visibility 2500 2000
bgn_module_replics_language english auto
bgn_module_tactical_groups 0 1

Добавлено около 50 cvar. Удалённые (bgn_chunk_*, опции динамических узлов выше, bgn_optimize_no_think_*) больше ни на что не влияют.

Что может сломать поведение 1.13

  1. Перестановка акторов. 1.13 переставляла актора только дальше bgn_spawn_radius или дальше радиуса видимости, если его не видели. Теперь любого актора, которого игроки не видели bgn_actor_unseen_time (30 с), можно переставить, даже рядом за стеной (spawner/sv_actor_remover.lua).
  2. Карты без маршрутов, но с navmesh. Генерация точек вокруг игрока заменена участками navmesh; HL2 NPC идут к ним через SCHED_FORCED_GO. Распределение спавна и маршрутов другое; на карте с navmesh, но без nodegraph .ain, HL2 NPC могут плохо ходить к дальним участкам.
  3. Частота обновления состояний. Старый автомат вызывал update почти каждый кадр. Теперь мозг работает раз в 0,2 с рядом с игроками и раз в 1 с вдали; дальние безоружные акторы чередуют 2 с паузы и 1 с работы (1.13 полностью замораживала их дальше 500 юнитов). Сторонние состояния через SetStateAction, рассчитанные на частый update, реагируют медленнее.
  4. defense в классическом режиме: горожанин оставляет бой полиции (fear); разыскиваемый актор отступает, если враг дальше 300 юнитов и здоровье ниже 50%; бойцы могут захватывать машины; при тактических группах движением управляет отряд; самоисцеление больше не выдаёт оружие тем, у кого есть getting_weapon_chance.
  5. Розыск: разыскиваемого NPC (не игрока) снимают с розыска через 15 с вне поля зрения игроков; его уровень растёт раз в 60 с; медики и арестованные не попадают в розыск; LevelDown() на 1-м уровне теперь снимает розыск (в 1.13 ничего не делал); второй аргумент BGN_WantedLevelDown теперь уровень, а не счётчик убийств. Сам мод LevelDown не вызывает, затронуты только внешние аддоны. См. розыск.
  6. Свои диалоги в bgNPC.cfg.dialogues молча игнорируются.
  7. Язык реплик. В 1.13 язык игры был важнее cvar; теперь серверный bgn_module_replics_language перекрывает всё, и сервер с сохранённым english навязывает английский русским игрокам. Сервер выбирает номер фразы по английской таблице, поэтому в своём языковом файле число фраз должно совпадать. См. голоса.
  8. Население: две банды и войны вместо gangster, плюс медики, сцены и отряды меняют и состав, и частоту перестрелок. Отключение gangster по имени типа оставляет банды активными.
  9. Синтетический OnNPCKilled: actor/components/sh_vehicle.lua вызывает OnNPCKilled для актора, убитого в машине; сторонние счётчики убийств и денег могут получить неожиданное или лишнее событие.

Внутренние идентификаторы hook.Add / net (около 60, например BGN_ThinkProcess) исчезли; это не публичный контракт.

Запуск ядра 1.13 Classic

Ядро Classic (1.13.7) входит в этот аддон: lua/background_npcs_legacy/, вместе с урезанной копией SLibrary (отдельный аддон SLibrary не нужен). Какое ядро грузится, выбирает команда bgn_loader core|legacy (автодополнение, суперадмин или консоль сервера). Выбор хранится в data/background_npcs/loader.txt; клиентам его передаёт сервер через служебный реплицируемый ConVar bgn_loader_active:

Значение Что грузится
core (по умолчанию) background_npcs_core (текущее)
legacy background_npcs_legacy (Classic 1.13.7)

Выполните bgn_loader legacy и перезапустите карту: до этого смена ничего не меняет. Оба ядра используют общие настройки bgn_*, файлы маршрутов и скомпилированные данные карт. У Classic свои сущности (bgn_legacy_dv_police, bgn_legacy_dv_passenger) и инструменты (bgn_legacy_*); инструменты неактивного ядра скрыты из меню. Не перенесены страницы опроса и проверки обновлений Classic. Проверено: оба загрузчика стартуют на gm_construct без ошибок Lua и спавнят актёров; игровой процесс Classic целиком не проходился.

Ограничения аудита

Не проверялось: поведение в игре; смысловая эквивалентность каждого псевдонима совместимости сверх имени; модули DV и DarkRP глубже уровня файлов. Главные риски — пункт 1 (перестановка) и пункт 2 (источник навигации).