KAZIK/docs/HEIST_HQ.md

48 lines
8.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Вылазка в штаб конкурирующей сети
Статус: сохранённый необязательный прототип. Доступен со стола подготовки в клубе, не требуется для основного прохождения. Развитие отдельного FPS пока отложено в пользу казино.
Наше казино — база. Цель операции находится на отдельной карте: административный штаб владельцев конкурирующей сети, с охраной, архивом, терминалом безопасности и закрытым хранилищем. После задания команда возвращается в подпольный клуб нашего казино.
## Подготовка и найм
В подвале Сидорович сохранил собственную мастерскую. В конце мастерской, ближе к лестнице, открыт боковой проход налево. За стеной находится отдельный подпольный клуб: бега, Семён и стол подготовки задания.
На столе нажми **E**. Участники нанимаются клавишами **1–4**: бармен-водитель $1000, прикрытие $2000, наводчик $1500, специалист по доступу $3000. Бармена также можно нанять клавишей **7** у стойки. Повторный найм бесплатен, состав сохраняется с профилем. Личные квесты найма пока не сделаны; сейчас это контракт за фишки. Портреты бармена, певицы и гадалки взяты из их существующих игровых сцен.
Клавиша **5** переключает начальный подход: **стелс** или **штурм**. **Enter** запускает поездку, когда команда собрана. Игрок видит дорогу из пассажирского кресла, водителя в маске и своё оружие. Поездка автоматическая, длится шесть секунд.
## Задание от первого лица
- **WASD** — движение, **мышь** — обзор, стрелки влево/вправо также поворачивают камеру.
- **Ctrl** — присесть и двигаться медленнее; обнаружение растёт медленнее.
- **Shift** — бег.
- **1** — пистолет с глушителем; **2** — карабин.
- **ЛКМ / Space** — стрелять; **R** — перезарядка из ограниченного резерва.
- **E** — терминал, документы, дверь хранилища, сейф, эвакуация у машины.
- **F** — напарникам ждать / следовать; при тревоге они начинают прикрывать игрока.
- **Esc** — отступить на базу без награды; в интерфейсе сейфа возвращает к движению по штабу.
С парадного входа начинается лобби со стойкой, по боковому пути слева можно попасть в помещение охраны. Патрули проверяют направление взгляда и видимость через карту, постепенно заполняя шкалу обнаружения. Камера в центральном коридоре также обнаруживает игрока. Полная шкала или выстрел из карабина включает тревогу. Через 15 секунд прибывает ограниченная группа подкрепления. Выстрелы и перемещение блокируются стенами; напарники поддерживают огнём при тревоге.
**Тихий путь:** обойти здание слева, пробраться в охрану, подойти к терминалу и нажать **E**. Взлом занимает 1,5 секунды, требует оставаться рядом, отключает камеру и открывает дверь хранилища. Пистолет с глушителем может нейтрализовать отдельного охранника без глобальной тревоги. Патрули и прямую видимость всё равно нужно учитывать.
**Силовой путь:** выбрать штурм при подготовке или открыть огонь из карабина. У двери хранилища **E** начинает десятисекундный взлом с тревогой. Можно также захватить терминал. Если отойти от двери или терминала, действие отменяется.
В кабинете владельцев лежат документы; **E** рядом с ними раскрывает комбинацию **24–71–45**. Их можно пропустить и искать цифры по звуковым щелчкам. В хранилище **E** у сейфа открывает панель поверх вида от первого лица: **A/D** или стрелки поворачивают лимб, **Space** фиксирует цифру, **Esc** закрывает панель. Охрана продолжает действовать, поэтому перед взломом нужно обеспечить безопасность. На попытку даётся 120 секунд; истечение времени поднимает тревогу.
## Добыча и возвращение
Открытие сейфа даёт сумку с добычей, без выплаты на баланс. Нужно самостоятельно вернуться через здание к машине во дворе и нажать **E**. Затем проходит обратная поездка, восстанавливаются карта и точная исходная позиция в нашем клубе. Только тогда начисляются **$1000000** и золотая рубашка. Награда однократная для профиля.
Смерть, отмена или выход до эвакуации не выдают награду и не списывают основной банк. Найм команды сохраняется для новой попытки. Наше казино не становится картой штурма, и охрана штаба не переносится на базу.
## Ресурсы и проверка
Весь игровой код — MASM: `heist_hq_data.inc`, `heist_hq.inc`, `heist_hq_render.inc`, карта `heist_hq_map.inc`. Скрипт `tools/generators/pack_heist_hq.py` используется только офлайн: компилирует утверждённые PNG и карту в игровые ресурсы.
Исходники ImageGen: `assets/sprites/hall/heist-{van,actors,weapons,props}-v1.png`. Полные промпты: `assets/sprites/hall/prompts-heist-hq-v1.json`. ANM1-паки, включая материалы улицы, находятся в `assets/animations/hall/`. Городские материалы переиспользованы из существующего оформления игры.
`python tools/tests/check_underworld.py` запускает реальные обработчики и рендер без пользовательских профилей. Проверяются выезд, оба подхода, урон и стены, обнаружение, терминал, документы, сейф без ранней выплаты, эвакуация с однократной наградой, возвращение на исходную карту и позицию, смерть и отмена. Кадры настоящего framebuffer находятся в `build/underworld/hq-*.png`, отдельный клуб — `club.png` и `club-semyon.png`.
Это первая самостоятельная миссия с базовыми патрулями и напарниками прикрытия. Несколько заданий, личные квесты вербовки, полноценная система заложников/пейджеров и сложные тактические команды пока не реализованы.