Skip to content

Latest commit

 

History

80 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Z.H.O.P.A. ALIFE 2.3

English | Список изменений | Архитектура | Справочник функций

DeepWiki

Zone Hostile Operations & Population AI - модульное расширение ALife для S.T.A.L.K.E.R. Anomaly 1.5.3 + Modded Exes.

Z.H.O.P.A. делает жизнь Зоны более связной: отряды получают осмысленные задачи, преследуют движущиеся цели, собирают добычу и артефакты, торгуют, занимают базы и реагируют на сюжетные события. При этом перемещение, smart jobs, online/offline-переходы, pathfinding и основная боевая логика остаются под управлением игры.

Возможности

Подсистема Что меняется
Задачи отрядов Сталкеры исследуют Зону, заселяют smart terrains, патрулируют, отдыхают, охотятся, мстят, ищут артефакты, ходят торговать и выполняют заказы торговцев. Мутанты используют отдельный набор задач.
NPC-квесты Торговцы публикуют задания на документы, зачистку, занятие базы, охоту и доставку. Отряды реально идут к квестодателю и цели, используют предметы задания и возвращаются за наградой; контур работает онлайн и оффлайн.
Баланс задач Валидные пары «задача - цель» получают вес по силе отряда, фракционной обстановке и необязательным лорным предпочтениям. Сюжетные и защитные задачи остаются вне этого случайного выбора.
Охота и месть Цель отслеживается по фактическому положению отряда, включая переходы между локациями. Месть против игрока делает враждебным только назначенный отряд, а не всю группировку.
Диалоги и путешествия Командир управляемого отряда рассказывает о текущей и предыдущей задаче, включая тип NPC-квеста, и показывает карточку локации/смарта. Если отряд движется, игрок может отправиться с ним к фактической цели с пропуском времени, опциональной платой и сюжетными ограничениями пси-зон.
Лутинг Онлайн-контур дополняет ванильный подбор и защищен от циклов на неподбираемых предметах. Оффлайн-добыча хранится как ограниченный виртуальный груз без расходования object IDs.
Экономика Лидер торгует за весь отряд, продает реальные и виртуальные товары, объединяет деньги участников и закупает базовые припасы.
Артефакты Поддерживаются реальные и виртуальные оффлайн-артефакты, привязка к подходящим smart terrains и онлайн-подбор выбранным NPC с анимацией детектора.
Базы и сервисы Мод отслеживает вакансии баз и назначает существующих местных NPC торговцами, техниками, медиками и поварами/барменами; новых NPC не создаёт.
Сюжетные события В сюжетном режиме работают пси-зомбирование отрядов и северная миграция после отключения Выжигателя. Во фриплее эти системы не запускаются.

Текущие задачи: REST, EXPLORE, FORCE_EXIT, POPULATE, BASE_CAMPING, PATROL, NIGHT_REST, ARTEFACT, TRADE, QUEST, HUNT, REVENGE, STORY_NORTH_MIGRATION.

Guard Refill

Опция «Сервис-филлер: восполнять охрану» включена по умолчанию. После заполнения торговцев, техников, медиков и поваров/барменов всей базы филлер переводит подходящих NPC из пришедших отрядов в постоянную охрану. Владелец имеет приоритет; затем допускаются невраждебные фракции. Живые штатные охранники сохраняются, посты не дублируются. Отделённые NPC не участвуют в роуме и не занимают квоту BASE_CAMPING; оставшийся отряд продолжает свои задачи. Выброс и бой не отменяют постоянного назначения. Выключение Guard Refill прекращает только новые назначения; полное выключение ZHOPA возвращает назначенных NPC в обычные отряды. Для диагностики: zhopa2_guard_refill.audit_level().

Торговля и экономика

  • Онлайн-сделка проходит через ванильную trade customer job и SISKI-derived axr_trade_manager.script.
  • Фактического продавца выбирает сама smart job через npc_info.job.seller_id; ZHOPA не подменяет его заранее выбранным NPC.
  • Торговыми провайдерами считаются только торговцы и бармены. Медики, техники и лидеры группировок не используются как обычные продавцы.
  • Поход к технику может запустить только настоящий предмет категории i_upgrade, находящийся у NPC. Обычная торговая закупка не создает искусственный tech intent.
  • Оффлайн-сделки продают сериализуемый виртуальный груз и используют виртуальный баланс отряда.
  • Множитель дохода NPC от продажи задается параметром npc_sell_price_multiplier; значение по умолчанию - 0.2.
  • Квестовое обращение к торговцу использует ту же customer job и анимацию, но завершается до денежной сделки. После любого service-result NPC немедленно получает штатный перевыбор работы и остаётся под наблюдением service doctor.

Заселение сервисных баз

Составные базы из нескольких смартов описаны в gamedata/configs/zhopa2_base_clusters.ltx. Их владелец и население общие, а места для отрядов и сервисные работы остаются привязаны к конкретным смартам. Филлер может взять донора на соседнем смарте той же базы. Состав поддерживает ванильные локации и три карты New Levels; отсутствующие карты пропускаются.

Роум-задачи учитывают населённость всей локации: живых сталкеров всех фракций и направленные туда отряды. Среди близких и дальних достижимых целей менее населённые локации получают больший вес, а дальность и опасность сохраняют значение. Множитель населённости ограничен диапазоном от 0,5 до 2. Настройка MCM «Баланс фракций и населённости локаций» включает этот баланс.

Service Filler учитывает живого локального игрока на ближайшей базе с сервисными местами как одного представителя его настоящей фракции. После зачистки можно остаться в радиусе базы и дождаться подходящих отрядов: филлер отделит от них NPC для свободных сервисных мест. Выброс больше не требуется. Уход игрока до проверки назначения снимает его присутствие; маскировка не меняет фракцию владения.

Пустые и малонаселённые сервисные базы получают повышенный вес для EXPLORE, POPULATE и патрулей; при выборе ночного отдыха бонус влияет на расстояние между одинаково загруженными вариантами. Пустая база открыта всем сталкерским фракциям, занятая — своим и не враждебным владельцу. Вместимость и идущие туда отряды учитываются.

NPC-квесты отрядов

zhopa2_npc_quests поддерживает пять типов заказов: поиск документов, зачистку базы, занятие базы, уничтожение конкретного отряда и доставку. Квестодатель публикует до трёх доступных заказов по своему профилю; отряд сначала ищет работу на текущем уровне, затем у торговцев прямых соседних уровней.

Онлайн командир подходит к торговцу и отыгрывает настоящую service-анимацию. Если подход безопасно выполнить нельзя или уровень оффлайн, используется минутный симуляционный fallback на смарте. Документы и посылки являются реальными отдельными предметами ZHOPA: онлайн их физически получает командир, оффлайн та же стадия завершается серверной логикой. Награда начисляется один раз в общий виртуальный баланс отряда и позже участвует в обычной экономике.

Лутинг

Онлайн-лутинг использует ванильные схемы подбора там, где они способны завершить действие. ZHOPA добавляет целевой подбор, анти-stall и очистку памяти после отклоненного или завершенного лута, чтобы NPC не возвращались к одному трупу или предмету бесконечно.

После оффлайн-боя добыча записывается в ограниченный виртуальный ledger. Она продается через экономику или материализуется только в контролируемом сценарии, например при смерти NPC в онлайне. Это предотвращает переполнение пула engine object IDs на длинных прохождениях.

Артефакты

Реальные артефакты регистрируются в runtime-индексе и принадлежат ровно одному подходящему smart bucket. Если доступен реальный артефакт, он имеет приоритет перед виртуальным. Виртуальные артефакты создаются по настройкам аномальных зон только для оффлайн-экономики и не уменьшают реальный спавн.

Требования

  • S.T.A.L.K.E.R. Anomaly 1.5.3.
  • Актуальные Modded Exes для Anomaly 1.5.3.
  • MCM необязателен: без него используются значения из gamedata/configs/zhopa2_settings.ltx.

Установка

Mod Organizer 2

  1. Отключите или удалите старые версии REZNYA, SISKI и ZHOPA.
  2. В MO2 выберите Файл -> Установить мод....
  3. Выберите архив Z.H.O.P.A. ALIFE 2.3 и подтвердите установку.
  4. Убедитесь, что мод расположен ниже конфликтующих модов, если нужно использовать поставляемый axr_trade_manager.script.

Вручную

Скопируйте каталог gamedata в корень Anomaly и проверьте наличие файлов в gamedata/scripts, gamedata/configs, gamedata/configs/text и gamedata/textures.

Настройки

Настройки находятся в MCM -> ZHOPA ALIFE 2 и дублируются в gamedata/configs/zhopa2_settings.ltx.

Основные разделы MCM:

  • основные системы;
  • экономика и вспомогательные системы;
  • сюжетные события;
  • симуляция сталкеров и мутантов;
  • веса, баланс и длительность задач;
  • бой, маршруты и сопровождение целей;
  • отдельные веса и включатели задач по группировкам;
  • отладка.

Баланс задач включен по умолчанию. Числовые параметры, переопределения уровней, силу отрядов и фракционные профили следует настраивать в gamedata/configs/zhopa2_population_profiles.ltx. Вкладка MCM Веса группировок по умолчанию использует общие настройки; её master switch включает отдельные включатели и веса QUEST, EXPLORE, POPULATE, PATROL, NIGHT_REST, HUNT, ARTEFACT и TRADE для каждой человеческой группировки. Мутанты и зомбированные сохраняют собственные общие настройки.

Диалоги и совместные путешествия включаются параметром squad_dialogue_enabled. Скорость пропуска времени задаётся только в LTX через squad_travel_minutes_per_100m; значение по умолчанию — 10 игровых минут на 100 метров. Платное путешествие включено по умолчанию через squad_travel_paid_enabled: базовая цена равна 1000 руб. за километр, а MCM-множитель squad_travel_price_multiplier регулируется от 0.1 до 10.

NPC-квесты отрядов включаются npc_quests_enabled; их относительный шанс задаёт stalker_quest_weight. Профили, набор типов, число слотов и диапазоны наград находятся в zhopa2_npc_quests.ltx; торговый smart можно исключить записью smart_name = disabled.

Управляемый онлайн-лутинг экспериментальный и по умолчанию выключен. Оставьте его выключенным, чтобы использовать более предсказуемый ванильный лутинг в больших сборках; задания на артефакты продолжают использовать отдельный целевой контур подбора. После обновления мода перед изменением настроек нажмите в MCM Сбросить по умолчанию, чтобы применились актуальные рекомендуемые значения.

Совместимость

Статус Моды и сборки
Проверено Vanilla Anomaly 1.5.3, G.A.M.M.A. 0.9.4/0.9.5, Anthology 2.1
Совместимо ZCP, семейство REDONE, New Levels
Несовместимо Alife Plus
Требует проверки Моды, полностью заменяющие sim_squad_scripted, smart_terrain, sim_board, xr_gather_items, xr_corpse_detection, axr_trade_manager или связанные callback-и

Дополнительные замечания:

  • Ограничители NPC-лутинга, включая NPC Loot Claim, NPC Stop Looting Dead Bodies и опцию Useful Idiots «только компаньоны могут обыскивать тела», уменьшают объем работающей экономики. Вместо удаления ZHOPA можно отдельно отключить ее лутинг или экономику в MCM.
  • xcvb's Guards Spawner не блокирует работу мода, но может писать в лог сообщения о своих отрядах после того, как их начинает обслуживать ZHOPA.
  • Боевые AI-моды обычно безопаснее, пока не заменяют SIMBOARD, smart terrain и основные lifecycle callbacks.

Сохранения и удаление

ZHOPA умеет корректно выйти из работающей игры и подготовить следующее сохранение к удалению мода:

  1. Загрузите сохранение, пока ZHOPA установлена и включена.
  2. Откройте MCM и отключите Работа ZHOPA ALIFE 2.
  3. Дождитесь сообщения об успешной очистке. Если очистка сообщила об ошибке, не удаляйте мод: перезапустите игру и повторите попытку.
  4. После успешной очистки создайте новое ручное сохранение.
  5. Выйдите из игры и только затем отключайте или удаляйте мод в MO2.

Переключатель немедленно отменяет управляемые задачи, возвращает пересаженных NPC в обычные отряды и удаляет старые заспавненные сервисные отряды, очищает поля ZHOPA у отрядов и в скриптовом хранилище, снимает коллбэки и восстанавливает пропатченные функции там, где их после ZHOPA не заменил другой мод. Пока переключатель выключен, ZHOPA не работает; повторное включение заново строит рантайм по текущему состоянию мира.

Очистка не может отменить уже произошедшие изменения мира: смерти, появление или подбор предметов, отношения, измененные другими системами, зомбирование и завершенную миграцию. Она не переносит сохранения SISKI/ZHOPA1. После сообщения BusyHands не продолжайте текущую сессию: перезагрузите сохранение или выйдите в главное меню.

Проверка и отладка

Включите debug_hud_enabled в MCM. На карте КПК появятся маркеры управляемых отрядов; подсказка показывает задачу, цель, smart, причину и последний результат. Этот режим предназначен для диагностики и может раскрывать скрытую работу симуляции.

Дополнительные диагностические скрипты находятся в debugscripts. Они не входят в обычную пользовательскую установку и запускаются только для проверки конкретных контуров.

Аудиты сервисников zhopa2_service_recruitment.audit_level() (также zhopa2_recruit_trader_probe.audit_level()) и охраны zhopa2_guard_refill.audit_level() входят в релиз и доступны без debug-пакета.

Документация

Для разработчиков

Перед изменением поведения сначала ищите ванильную точку расширения. Новые подсистемы должны уважать общий барьер готовности, самостоятельно регистрировать и снимать коллбэки, поддерживать очистку при отключении мода, избегать широких сканов в горячих путях и хранить в сейве только сериализуемые значения. Новый рантайм-патч обязан сохранять исходную функцию и уметь корректно сниматься. Полный override допустим только при документированной необходимости; axr_trade_manager.script является текущим осознанным исключением.

Лицензия

MIT, Copyright (c) 2026 qkff99.

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages