Сравнение с 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 → свой генератор). Удалены cvarbgn_dynamic_nodes_type,bgn_dynamic_nodes_alternative,bgn_enable_dynamic_nodes_only_when_mesh_not_exists,bgn_chunk_*. - Диалоги:
bgNPC.cfg.dialogues(фразы HL2vo/*) заменён на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.13 переставляла актора только дальше
bgn_spawn_radiusили дальше радиуса видимости, если его не видели. Теперь любого актора, которого игроки не виделиbgn_actor_unseen_time(30 с), можно переставить, даже рядом за стеной (spawner/sv_actor_remover.lua). - Карты без маршрутов, но с navmesh. Генерация точек вокруг игрока заменена участками navmesh; HL2 NPC идут к ним через
SCHED_FORCED_GO. Распределение спавна и маршрутов другое; на карте с navmesh, но без nodegraph.ain, HL2 NPC могут плохо ходить к дальним участкам. - Частота обновления состояний. Старый автомат вызывал
updateпочти каждый кадр. Теперь мозг работает раз в 0,2 с рядом с игроками и раз в 1 с вдали; дальние безоружные акторы чередуют 2 с паузы и 1 с работы (1.13 полностью замораживала их дальше 500 юнитов). Сторонние состояния черезSetStateAction, рассчитанные на частыйupdate, реагируют медленнее. defenseв классическом режиме: горожанин оставляет бой полиции (fear); разыскиваемый актор отступает, если враг дальше 300 юнитов и здоровье ниже 50%; бойцы могут захватывать машины; при тактических группах движением управляет отряд; самоисцеление больше не выдаёт оружие тем, у кого естьgetting_weapon_chance.- Розыск: разыскиваемого NPC (не игрока) снимают с розыска через 15 с вне поля зрения игроков; его уровень растёт раз в 60 с; медики и арестованные не попадают в розыск;
LevelDown()на 1-м уровне теперь снимает розыск (в 1.13 ничего не делал); второй аргументBGN_WantedLevelDownтеперь уровень, а не счётчик убийств. Сам модLevelDownне вызывает, затронуты только внешние аддоны. См. розыск. - Свои диалоги в
bgNPC.cfg.dialoguesмолча игнорируются. - Язык реплик. В 1.13 язык игры был важнее cvar; теперь серверный
bgn_module_replics_languageперекрывает всё, и сервер с сохранённымenglishнавязывает английский русским игрокам. Сервер выбирает номер фразы по английской таблице, поэтому в своём языковом файле число фраз должно совпадать. См. голоса. - Население: две банды и войны вместо
gangster, плюс медики, сцены и отряды меняют и состав, и частоту перестрелок. Отключениеgangsterпо имени типа оставляет банды активными. - Синтетический
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 (источник навигации).