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

Розыск и нарушители

Исходники: systems/wanted/, config/states/sh_wanted.lua. Розыском и реакциями управляет сервер; клиент получает записи и рисует HUD/подсветку.

Серверная cvar По умолчанию Назначение
bgn_enable_wanted_mode 1 Включает розыск; изменение очищает существующие записи.
bgn_wanted_time 30 Базовая длительность розыска, секунды.
bgn_wanted_level 1 Разрешает рост уровня (до 5).
bgn_wanted_level_up_period 60 Секунды между автоматическими повышениями уровня разыскиваемого NPC/актора (не игрока); нужна bgn_wanted_level; 0 выключает.
bgn_wanted_police_instantly 1 Включает обработку немедленной реакции полиции.
bgn_wanted_impunity_limit 5 Порог безнаказанности для обработчиков розыска.
bgn_wanted_impunity_reduction_period 10 Секунды между уменьшениями безнаказанности.

Убийства, свидетели, вызовы полиции и отказ от ареста участвуют в розыске. Игнорируемые/арестованные игроки и акторы из residents/medics исключаются из новых записей. При смене тела DV идентичность розыска сохраняется. Пока любой житель ближе 600 единиц к цели или видит её в пределах bgn_wanted_detection_radius, таймер сбрасывается каждую секунду и не идёт — и для игроков, и для акторов; машина, в которой сидит цель, при проверке видимости считается целью. Разыскиваемый не-игрок, который 15 секунд находится вне поля зрения всех игроков либо дальше половины bgn_spawn_radius_visibility (препятствия не учитываются), снимается с розыска; это отдельно от истечения розыска игрока и удаления популяции.

Жители и полиция с общей командой не становятся врагами из-за обычного попадания или убийства. Союзный удар не запускает страх, помощь, арест или сообщение о преступлении; bgn_team_damage управляет только потерей здоровья. AddWanted отклоняет акторов из residents, регулярная очистка удаляет их устаревшие записи розыска. SetTeam/AddTeam сразу согласуют взаимные списки врагов; вступление в residents снимает розыск, а вступление в команду ведущего полицейского снимает арест этого актора.

Ничто в моде не снимает у жителя команду residents. Транспортные столкновения не исключение: наезд на жителя и таран полицейского или полицейской машины не делают водителя нарушителем. Полиция в машине игнорирует таран водителя-жителя и не получает от него урона; для тарана актором не из жителей сохраняется шанс реакции 10%. См. мозги и арест.

Интеграция

Серверная проверка обнаружения требует живого Actor и валидной текущей сущности. Сидящий наблюдатель, ожидающий замены тела, не обновляет таймер розыска до восстановления сущности; одного Actor:IsAlive() недостаточно, чтобы гарантировать её наличие в движке.

Получайте local wanted = bgNPC.Modules.Get('wanted') после загрузки систем; до этого либо в другом окружении возможен nil. Запросы: wanted:HasWanted(entity), GetWanted(entity), GetAllWanted(). Изменяйте на SERVER через AddWanted(entity, time), RemoveWanted(entity); повторное добавление не сбрасывает и не продлевает таймер. Для защищённого актора residents/medics AddWanted возвращает nil. Возвращённая запись поддерживает UpdateWanted(time), SetLevel(level), LevelUp(), LevelDown(); неположительный SetLevel снимает розыск, значения выше 5 ограничиваются.

Хуки: BGN_AddWantedTarget, BGN_RemoveWantedTarget, BGN_WantedLevelUp, BGN_WantedLevelDown. При BGN_PlayerReady сервер передаёт уже действующие записи. Клиентские настройки HUD не отключают серверную систему.

Память конфликта и свидетели

SERVER хранит одну направленную запись на пару участников в существующем модуле first_attacker. Запись создаёт только подтверждённый положительный урон; машина приводится к водителю. Ответный удар обновляет время, не меняя инициатора. Защищавшийся может начать отдельный конфликт с кем-то ещё. Союзные ACTOR и существующая добровольная кулачная драка исключены. Residents/police не обвиняют отвечающую жертву, если она уже не представляет угрозу их команде. Игрок, атакующий стороннего NPC/NextBot с Disposition(player) == D_HT, защищается от этой сущности; отсутствие Disposition обрабатывается безопасно.

До обвинения инициатора каждый ACTOR применяет правило общего противника: если пострадавший уже находится в списке врагов этого наблюдателя, попадание не делает нападающего его врагом. Исключение запрещено, если наблюдатель и нападающий уже числят друг друга врагами хотя бы в одном направлении либо между ними есть D_HT в любом направлении (настроенные отношения, отношения тел и доступные методы сущностей Disposition). Постоянный союз не создаётся, существующие враги не удаляются. Например, нейтральный гангстер, стреляющий в игрока, которого полиция уже считает врагом, не обвиняется за первое попадание даже без розыска игрока. Фактический инициатор пары по-прежнему запоминается; последующее нападение на непричастного союзника — отдельное нарушение. IsEnemyOfTeam учитывает собственный список врагов наблюдателя наряду с союзниками.

Свидетель урона должен видеть нападающего в радиусе 2500 через LOS; для нападающего ACTOR также нужен FOV. Видимость одной жертвы или известный розыск это не заменяют. Другие команды защищают союзников; residents/police также разбирают конфликты посторонних. Назначение врага и розыск — отдельные решения. CallForHelp передаёт угрозу союзникам в радиусе 1000, видящим зовущего, без требования видеть врага и без FOV; периодическая передача сохраняет свои командные/бандитские правила.

Записи забываются через 60 секунд без урона и LOS между участниками (в любом направлении, без FOV). Смерть, завершённый арест и снятие розыска очищают все записи с участником в любой роли. Замена тела DV переносит обе роли и счётчик безнаказанности. Память существует только на сервере, не в клиентском снимке.

Первоначальное назначение розыска

При включённом розыске вне мирного режима игрок и ACTOR, сейчас не входящий в residents, используют общий порог замеченных убийств в основном обработчике убийств (>= bgn_wanted_impunity_limit, 0 отключает), уменьшаемый на единицу каждые bgn_wanted_impunity_reduction_period секунд (0 отключает уменьшение). Считаются убитые ACTOR. Мгновенный розыск за убийство полицейского ACTOR дополнительно требует другого живого полицейского, видящего убийцу через LOS и FOV в радиусе 2500; погибающий офицер и убийца свидетелями не считаются. Для обычного порога также нужен свидетель с LOS/FOV.

Сторонняя сущность (не игрок и не ACTOR) получает розыск без свидетеля за убийство любого residents/police ACTOR либо за Disposition(actor) == D_HT к любому живому residents/police ACTOR. Враждебность опрашивается раз в секунду; bgn_ignore_another_npc отключает опрос. Для локального обнаружения врага нужны радиус 2500 и LOS, без FOV. Отношения стороннего NPC к обычным телам ACTOR сохраняются, а не заменяются отношениями к игрокам; существующий адаптер отношений NextBot по игрокам остаётся. У сущностей без Disposition враждебность не угадывается.

Завершённые звонки свидетелей и полицейское подкрепление остаются основаниями розыска. Защита жителей/медиков и исключения игнорируемых/арестованных сохраняются. Эскалация описана на странице ареста. Назначение розыска по-прежнему сразу информирует всю полицию.

Дерево поведения

Опциональная реакция на оружие в руках — отдельный вход SERVER без урона:

Актор убит → проверить последний урон и активное оружие убийцы
├─ Взрыв / урон транспортом / убийство игроком из машины → не обучаться
└─ Тот же нападающий + валидное оружие + новый класс → кеш и перезапись DATA (даже без чекбокса)

Раз в секунду: bgn_react_to_lethal_weapon = 1, режим не мирный
├─ Живой игрок/NPC/NextBot держит оружие с классом из кеша
└─ Живой наблюдатель residents/police; не сама цель, не союзник, не известный враг
   ├─ Игрок игнорируется / дружелюбный режим для игрока / дальше 800 / вне FOV / нет LOS → пропустить
   └─ Выбрать реакцию at_damage
      ├─ ignore/none или отказ AddEnemy → нет нового состояния
      └─ Враг принят → сохранить реакцию; если спокоен, очистить цели и сменить состояние
         └─ Убирание оружия/выключение не очищает врагов; действует обычная память

Этот вход напрямую не назначает розыск. Штатные звонки полиции и передача врагов могут распространить угрозу.

Это реализованное дерево SERVER локальной реализации 2.5.1, ветка dev; публикация в Workshop этим не подтверждается. CLIENT получает записи розыска, но не определяет виновность. O — наблюдатель, A — нападающий, V — пострадавший. LOS проверяет препятствия; FOV свидетеля урона требует, чтобы нападающий находился строго впереди относительно глаз/направления наблюдателя, включая тела NextBot.

Попытка нанести урон
├─ Определить владельца спецсредства осады (нападающий, затем inflictor) до реакций/командных проверок
│  └─ Затем действуют штатные правила водителя транспорта; порядок хуков не выбирает команду
├─ Общая команда → нет боевой реакции; потеря здоровья зависит от bgn_team_damage
├─ Существующие личные/командные/режимные/защитные хуки могут отменить урон
│  └─ Личная реакция жертвы может произойти здесь, до изменения здоровья
└─ Фактический положительный урон (движок или виртуальное здоровье пассажира)
   ├─ Недопустимый участник/игнорируемый нападающий, урон себе, общая команда или добровольная драка
   │  └─ Это уведомление не продолжается
   ├─ Живая пара (кроме союзных ACTOR) → записать первый A → V или обновить время
   │  └─ Ответ V → A никогда не переворачивает сохранённые роли
   ├─ Дружелюбный режим с участием игрока → отдельное переопределение реакций
   ├─ A уже арестуют → сначала проверить эскалацию по фактическому урону
   └─ Вызвать BGN_ConfirmedDamage
      ├─ Обработчик полиции → попытка начать/продолжить арест
      ├─ Обработчик свидетелей → локальный выбор врага и реакции
      └─ Обработчик розыска → обновить уже действующий таймер

Последние три ветки — подписчики, а не гарантированный порядок выполнения обработчиков хука. Запись пары и пороги уже идущего ареста проверяются до уведомления. Смертельный удар может не создать новую запись живой пары; смерть и розыск имеют отдельные пути. См. дерево ареста.

Свидетель урона O
├─ O сам является A/V, мёртв, дальше 2500 или не видит A через LOS → пропустить
├─ A является ACTOR и находится вне FOV наблюдателя → пропустить
│  └─ Для игрока/внешней сущности FOV не требуется
├─ Обе стороны союзны O → пропустить
├─ Обе стороны посторонние, а O не residents/police → пропустить
└─ Свидетель допущен
   ├─ Если только A является союзником, поменять A/V местами для выбора врага
   │  └─ Видимость выше проверялась по настоящему нападающему до перестановки
   ├─ ResolveEnemy(O, V, A) не выбрал сторону → нет нового врага/реакции за удар
   └─ Сторона выбрана
      ├─ Пауза защиты / запрет хука → нет врага
      ├─ Спокойный O выбрал ignore/none → нет врага
      └─ Выбрать настроенную реакцию и запросить AddEnemy
         └─ Итоговые запреты могут отказать: мирный режим, команда, механики,
            игнорирование, защита ареста/медиков или другой хук

При прямом вызове ResolveEnemy значения A/V — переданные стороны; перестановку свидетеля сама функция не выполняет. Срабатывает первое подходящее правило:

Приоритет Условие Результат выбора
1 Неподдерживаемый тип участника либо ACTOR A и V имеют общую команду Нет выбора.
2 Обе стороны союзны O Нет выбора.
3 Только V является союзником O A.
4 Только A является союзником O V.
5 V уже враг O; между A и O нет вражды по спискам и D_HT в любом направлении; V не сам O Нет выбора: исключение общего противника.
6 O из residents/police, V первым атаковал A Если A — угроза команде O, выбрать A; иначе выбрать V.
7 Игрок A атакует стороннего NPC/NextBot V V, если доступный Disposition(A) этой сущности равен D_HT; иначе A.
8 Внешний неигровой A атакует игрока V A.
9 A в розыске, иначе V в розыске Сначала A, иначе V.
10 O из residents/police, A первым атаковал V A.
11 V представляет угрозу команде O, иначе A Сначала V, иначе A. Учитываются собственные враги O и имеющиеся сведения о командном конфликте.
12 ACTOR A не считает V врагом, иначе ACTOR V не считает A врагом Сначала V, иначе A.
13 Участвует игрок и для пары сохранён инициатор Сохранённый инициатор.
14 Ни одно правило не подошло Нет выбора.

D_HT запрещает исключение общего противника, но не заставляет выбирать A раньше всех последующих правил. Исключение не очищает существующие списки врагов. Личная реакция жертвы, рассылка розыска, помощь и скриптовые назначения — отдельные входы, которые этот выбор врага глобально не фильтрует.

Другие способы узнать врага
├─ Внешняя сущность имеет прямой D_HT к живому ACTOR
│  ├─ В пределах 2500 + LOS, без FOV → запрос локального врага/реакции
│  └─ Этот ACTOR из residents/police → запрос розыска без свидетеля
│     (опрос раз в секунду; мирный режим/игнорирование чужих NPC останавливают его)
├─ CallForHelp → живые союзники до 1000, видящие зовущего, без FOV
│  └─ Механика помощи, запрет ареста, пауза защиты и запреты AddEnemy сохраняются
├─ Периодическая передача → существующие правила источника, команды/банды и LOS
└─ Рассылка розыска / полицейское подкрепление → отдельное оповещение полиции
Первичный запрос розыска от встроенного поведения
├─ Неподчинение/побег/урон/убийство при аресте → дерево ареста
├─ Завершённый звонок свидетеля → сообщить о допустимых известных врагах
│  └─ Полиция уже знает врага или он уже в розыске / запрет хука / неудавшийся звонок → нет нового сообщения
├─ Полицейское подкрепление → свои существующие условия
└─ Убит ACTOR
   ├─ Мирный режим, розыск отключён или убийца недопустим → выйти из этого обработчика
   ├─ Убийца всё ещё ACTOR из residents → выйти; обычное убийство не снимает команду
   ├─ Убийца уже в розыске → обновить таймер / проверить повышение уровня
   ├─ Убийца не игрок и не ACTOR
   │  └─ Жертва из residents/police → розыск без свидетеля
   └─ Убийца — игрок / другой ACTOR
      ├─ Нет другого живого ACTOR, видящего убийцу через LOS + FOV до 2500 → выйти
      ├─ Мгновенный розыск включён + жертва-коп + свидетель-коп → розыск
      ├─ Достигнут включённый порог безнаказанности (>=, по умолчанию 5) → розыск
      └─ Иначе → сохранить число замеченных убийств, если их подсчёт включён

Новые записи проходят исключения AddWanted для игнорируемых/арестованных сущностей и ACTOR из residents/medics. Назначение сообщает всей полиции; это не означает, что каждый коп видел преступление. Ручные вызовы API и сторонние хуки не входят в это дерево встроенных оснований.

Следствия порядка проверок

Ситуация Текущий результат
Нейтральный гангстер попал в игрока, уже находящегося во врагах наблюдателя Нет нового врага или ареста только за этот удар; розыск игрока необязателен. Другой наблюдатель без этих сведений может решить иначе.
Гангстер уже враждебен наблюдателю Исключение недоступно; действуют обычные приоритеты. Существующий враг не прощается.
Ранее защищённый стрелок атаковал непричастного союзника Новая пара разбирается заново; общий противник не дал постоянного иммунитета.
Невраждебный подозреваемый ранил известного врага ведущего копа при аресте Исключение из неполицейских порогов здоровья/числа жертв; убийство отдельно вызывает эскалацию.
Память инициатора забыта Удаляются сведения о паре, а не все списки врагов или действующий розыск. У них отдельные сроки жизни.

Исходники: api/sv_combat.lua, actor/events/sv_self_damage.lua, actor/events/sv_damage_reaction.lua, systems/sv_first_attacker_found.lua, systems/sv_relationship.lua, systems/wanted/sv_wanted_actions.lua, systems/wanted/sh_wanted_class.lua. Сбросы — память конфликта, выбор оружия — арест.

Боевые решения после добавления врага

Этот SERVER-путь следует за описанными выше входами. FSM исполняет состояние; GOAP может планировать уже начатый бой. Полные ограничения тактик описаны в мозгах.

Враг принят
├─ Наблюдать всех видимых известных врагов; передавать позиции с исходным временем наблюдения
│  ├─ Обычный скрытый враг: больше 60 с без наблюдения/донесения → забыть
│  │  └─ Записи преследования в движок не продлевают срок; исключения wanted/always-visible сохраняются
│  └─ Тело заменено → перенести позицию/время, боевую цель и недавнего нападающего
├─ Выбрать цель: нападающий за 5 с → осада → группа → прежняя цель → ближайший живой враг
│  ├─ Оружие метрокопа следует этой цели; нет боевого врага → цель ареста
│  ├─ Нет видимости → замеченная позиция / колонна; нет позиции → остановка
│  └─ Есть видимость → боевое движение; GOAP может выбрать укрытие, подкрепление, взлом или осаду
├─ Полиция удерживает огонь на переговорах → нельзя начать осаду или присоединиться
│  └─ Уже в осаде → переговоры не получают управление возможностями оружия
└─ Бой и живой известный враг в пределах 1000 включительно
   ├─ Обычная переработка населения/respawn → запрет
   └─ Телепорт NextBot через HandleStuck / PullOut → запрет; движение/попытки прыжка доступны

Это взаимодействующие состояния/таймеры, не единый атомарный тик. Существующие хуки перехода и административная очистка/смерть сохраняются. Переговоры используют прежний критерий заложника по радиусу/испугу/относительному расстоянию, без LOS и проверки линии огня.

Завершение звонка в полицию

SERVER запрещает новый звонок без допустимого выбранного врага или если полиция уже знает его (включая действующий розыск). Выбор реакции на урон/защиту также проверяет врага из события до AddEnemy, поэтому новый нападающий в розыске не обходит проверку входа. Реакция заменяется на fear.

После начала calling_police потеря LOS, получение целью розыска и принадлежность цели к полиции не прерывают отсчёт 7–15 секунд. Причина отмены из-за угрозы — дистанция строго меньше 300 единиц до выбранной цели GetEnemy(); ровно 300 не отменяет звонок. Союзный CallForHelp может добавить сведения о враге, не меняя состояния звонящего, а GOAP оставляет начатый звонок FSM. Отсутствие врагов/недопустимая цель и отключение розыска по-прежнему безопасно завершают состояние. Условия входа сохраняются: не более двух звонящих рядом с игроком, полиция ещё не знает выбранного врага, режим розыска включён. При завершении исключаются союзники, список врагов фильтруется по осведомлённости полиции и BGN_PreCallingPolice, затем обычно включается fear; завершённая анимация не гарантирует новую запись розыска.