KAZIK/docs/HEIST_AND_UNDERWORLD.md

205 lines
23 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.

# Подполье Казино и Великое Ограбление (Underworld & The Grand Heist)
Дизайн-документ и техническая спецификация для пяти взаимосвязанных систем:
1. **Подпольные крысиные / тараканьи бега** (`Rat Races`) в подвале.
2. **Ростовщик «Семён» и система долгов** (`Loan Shark & Debt`).
3. **Охрана и детектор шулерства** (`Pit Boss & Heat Level`).
4. **Интерактивный Бар с напитками-баффами** (`Interactive Bar & Buffs`).
5. **Квест «Ограбление Вегаса»** (`The Grand Heist`) — секретная сюжетная концовка в стиле *Payday 2* и *Иллюзии обмана*.
---
## 1. Синергия систем (Игровая петля)
```
+---------------------------------------------+
| Интерактивный Бар |
| - Баффы к удаче, концентрации и зрению |
| - Снижение шкалы Heat |
| - Слухи и вербовка Бармена |
+---------------------+-----------------------+
|
+---------------+---------------+
| |
v v
+------------------------+ +------------------------+
| Шулерство за столом | | Подпольные бега |
| - Подмена карт | | в темном подвале |
| - Кража фишек | | - Быстрый куш |
| - Рост Heat (Охрана) | | - Стук по столу |
+------------+-----------+ +------------+-----------+
| |
v v
+------------------------+ +------------------------+
| Охрана и Pit Boss | | Ростовщик «Семён» |
| - Допрос / Взятка | | - Кредит при банкроте |
| - Побег / Конфискация | | - Стычка в переулке |
+------------+-----------+ +------------+-----------+
\ /
\ /
v v
+---------------------------------------------+
| Квест «Ограбление Вегаса» |
| - 4 сообщника: Бармен, Гадалка, Певица, |
| Хакер |
| - Отвлечение зала феерическим шоу |
| - Проникновение в хранилище через подвал |
| - Взлом сейфа и эвакуация на крышу |
+---------------------------------------------+
```
---
## 2. Подпольные тараканьи / крысиные бега (Rat Races)
### Локация
Подвал казино (координаты около темного угла лестницы к гадалке). Деревянный стол с ограждением, подвешенная тусклая лампа накаливания, толпа шепчущихся NPC.
### Геймплей
* Клавиша **E** у стола открывает отдельный 2D экран тотализатора.
* Деревянный желоб на 4 дорожки (длина 70 клеток).
* 4 участника с уникальными именами и повадками:
1. **Шустрый ASM** (высокая базовая скорость, но 15% шанс застыть от испуга).
2. **Турбо-Маховик** (медленный старт, но ускоряется на второй половине дистанции).
3. **Пьяный Боцман** (хаотичные прыжки, непредсказуемый темп).
4. **Генерал Зарин** (стабильный танк, фаворит с коэффициентом 1.8x).
* **Случайные модификаторы забега**:
- `TURBO_RUSH` — рывок вперед на 3–5 клеток.
- `PANIC` — паническое метание на месте на 0.5 сек.
- `SLEEPY` — замедление шага.
* **Интерактив «Стук по столу»**:
- Клавиша **Пробел** один раз за забег позволяет игроку резко ударить кулаком по деревянному столу.
- Раздается громкий стук, экран на миг вздрагивает, и все участники получают случайную реакцию (кто-то пугается и ускоряется, кто-то впадает в ступор).
* **Ставки**:
- На победу (Win): выигрыш от x2.0 до x8.0.
- Топ-2 (Place): выигрыш от x1.4 до x3.0.
---
## 3. Ростовщик «Семён» и система долгов (Loan Shark & Debt)
### Триггер появления
Если баланс игрока опускается ниже $50 (или полный 0), в баре или около выхода из зала появляется NPC в кепке и кожаной куртке — Семён.
### Условия займа
* **Пакет «Новичок»**: $500 (вернуть $700 за 20 раундов).
* **Пакет «Игрок»**: $2,500 (вернуть $3,750 за 35 раундов).
* **Пакет «Ва-Банк»**: $10,000 (вернуть $16,000 за 50 раундов).
### Механика таймера
* Каждая сыгранная раздача (покер, блэкджек, дурак), бросок костей или спин слотов уменьшает счетчик оставшихся раундов на 1.
* В верхнем правом углу экрана пульсирует красная строка:
`ДОЛГ: $3,750 [ОСТАЛОСЬ: 12 РАУНДОВ]`
* При досрочной выплате через разговор с Семёном долг закрывается без последствий.
### Просрочка и Коллекторы
Если счетчик дошел до 0, а денег для выплаты нет:
* При смене локации экран гаснет, играет тревожный звук, игрок оказывается в глухом переулке за казино перед двумя громилами.
* **Варианты развития**:
1. **QTE Драка / Уклонение**: мини-игра на реакцию (вовремя нажимать стрелки / пробел). Победа дает отсрочку на 15 раундов.
2. **Русская рулетка на долг**: заряжается 1 патрон. Выстрел в воздух/пустой камор — долг полностью списан за смелость. Осечка с выстрелом — сброс профиля в банкротство.
3. **Конфискация**: если игрок сдается, громилы отбирают купленные талисманы и рубашки карт в счет уплаты.
---
## 4. Охрана и детектор шулерства (Pit Boss & Heat Level)
### Шкала подозрения (Heat: 0–100%)
* Использование шулерских трюков увеличивает Heat:
- Подглядывание закрытой карты: **+15%**
- Подмена карты из рукава: **+30%**
- Сдвиг фишек / кража со стола: **+25%**
* Естественное снижение:
- Честная игра: **-2%** за каждый раунд без фокусов.
- Покупка коктейлей в баре: **-15% .. -30%**.
### Градации опасности
* `0% - 40%`: Зеленый статус, охрана расслаблена.
* `41% - 79%`: Желтый статус. Крупье подозрительно косится, в строке состояния горит `[ВНИМАНИЕ ОХРАНЫ]`.
* `80% - 99%`: Оранжевый статус. Сзади игрока вырастает спрайт охранника с рацией.
* `100%`: Красный статус! Звучит свисток, крупье кричит *«Шулер!»*, игра останавливается.
### Комната допроса
Экран переносит игрока в служебное помещение охраны:
1. **Взятка**: отдать 40% текущего выигрыша и разойтись миром.
2. **Диалог / Блеф**: если у игрока куплен статус «VIP» или «Легенда казино», можно наехать на начальника охраны и заставить его извиниться.
3. **Побег**: скилл-чек на реакцию (опрокинуть стол, выбить дверь и скрыться в вентиляции). При провале — конфискация всех фишек за сессию и 10-минутный запрет на вход за карточные столы.
---
## 5. Интерактивный Бар с напитками-баффами
Интерактивная стойка на 1 этаже рядом с кабаре и джукбоксом.
### Меню напитков
1. **Виски «Двойной блеф» ($50)**:
- *Эффект*: Полное подавление пульса и стресса на 10 минут. Прицел в дартсе не дрожит.
- *Побочный эффект*: Легкое покачивание камеры при ходьбе в 3D.
2. **Коктейль «Холодный расчет» ($100)**:
- *Эффект*: В блэкджеке и покере отображается точный математический шанс победы текущей руки в процентах.
3. **Энергетик «Кибер-Панч» ($75)**:
- *Эффект*: Замедляет шкалы времени в скилл-чеках (DbD hook, дартс, взлом замков) на 25%.
4. **Шот «Хамелеон» ($150)**:
- *Эффект*: Мгновенный сброс шкалы подозрения охраны (`Heat`) до 0 (бармен забалтывает охрану).
5. **Коктейль «Счастливый Клевер» ($300)**:
- *Эффект*: Повышает вероятность выпадения победных комбинаций на слотах CloverPit на 15 спинов.
---
## 6. Вылазка в штаб владельцев конкурирующей сети
Наше казино остаётся базой. Игрок нанимает команду, выбирает стелс или штурм, едет в машине от первого лица и попадает на отдельную карту чужого административного здания. Там можно проникнуть через служебный маршрут, отключить камеру и открыть хранилище через терминал либо взламывать дверь под огнём. Добычу нужно вынести к машине. После обратной поездки игрок возвращается в исходную точку нашего казино; только тогда выдаётся награда.
Подробное описание текущей миссии, вербовки и управления: [HEIST_HQ.md](HEIST_HQ.md). Первоначальный вариант ограбления собственного казино с вертолётом заменён этим сценарием.
---
## 7. План поэтапной реализации в MASM32
| Этап | Модуль | Файлы данных и кода | Описание |
|---|---|---|---|
| **Этап 1** | Интерактивный Бар | `src_graphics/bar_data.inc`, `src_graphics/bar_scene.inc` | Меню напитков, баффы таймеров, эффекты стресса/подозрения. |
| **Этап 2** | Ростовщик Семён | `src_graphics/debt_data.inc`, `src_graphics/debt_scene.inc` | Логика займа при 0 баланса, тикающий счетчик раундов, стычка с коллекторами. |
| **Этап 3** | Охрана и Heat | `src_graphics/security_data.inc`, `src_graphics/security_scene.inc` | Шкала подозрения, интеграция с шулерством, допрос у начальника охраны. |
| **Этап 4** | Подпольные бега | `src_graphics/rat_race_data.inc`, `src_graphics/rat_race.inc` | 2D трек на 4 полосы, физика рывков, стук по столу пробелом. |
| **Этап 5** | Великое Ограбление | `src_graphics/heist_data.inc`, `src_graphics/heist_mission.inc` | Дневник квеста, диалоги 4 сообщников, взлом сейфа, финал на крыше. |
---
## 8. Как открыть новые активности
Запусти обновлённый `poker.exe` из корня проекта или `dist/Assembler Casino.exe`. Если старая игра уже открыта, сначала закрой её: второй запуск передаёт фокус существующему процессу.
В главном зале найди стальную дверь подвала, нажми **E** и пройди через открытый проём и лестницу. Внизу пройди в боковой проход слева ближе к лестнице: за стеной находится отдельный подпольный клуб с Семёном, бегами и планированием. Сидорович остался в собственной мастерской. Подходи и поворачивайся к объекту, пока не появится подсказка **E**.
- **Семён:** **1–3** — заём; при активном долге **5** — возврат; **4/Esc** — уйти. Условия: $500 → $700 / 25 раундов, $2500 → $3750 / 40 раундов, $10000 → $16000 / 60 раундов. При просрочке коллекторы встречают игрока после возвращения в режим ходьбы. Драка: последовательность **W A D S**, по 1,5 секунды на клавишу; победа даёт 20 раундов отсрочки. Рулетка: риск проиграть всё 1/6. Сдача закрывает долг ценой всех фишек.
- **Крысиные бега:** **1–4** — участник, стрелки **вверх/вниз** — ставка $25–500, **P** — победа или топ-2, **Enter** — старт. Победа оплачивается по коэффициенту участника, топ-2 — x1,5; коэффициенты включают возврат ставки. **Space** один раз за гонку пугает или ускоряет случайных крыс. После результата **Enter** начинает новую ставку, **Esc** возвращает в подвал.
- **План ограбления:** **1–4** нанимают участников за $1000/$2000/$1500/$3000, **5** выбирает стелс/штурм, **Enter** запускает выезд в штаб конкурента. Управление на задании: WASD, мышь, ЛКМ, **1/2** оружие, **R** перезарядка, **Ctrl** присесть, **F** команда, **E** действия. Выплата $1000000 и золотая рубашка выдаются однократно после возвращения с добычей к машине и обратной поездки. Подробнее: [HEIST_HQ.md](HEIST_HQ.md).
- **Бар:** в главном зале **E** у стойки; **1–6** — напитки, **7** — найм бармена. Мышь выбирает те же строки. Виски убирает дрожание прицела дартса, анализ даёт вероятность взять карту без перебора в одиночном блэкджеке и текущую комбинацию в покере, энергетик увеличивает скорость ходьбы, хамелеон сбрасывает подозрение, клевер даёт 15 спинов с дополнительным 15% шансом удачного исхода. Временные эффекты действуют десять минут.
- **Охрана:** **P** во время своего хода в покере/блэкджеке раскрывает скрытые карты на текущую раздачу, добавляя 30% подозрения один раз за руку. Обычные победы не повышают подозрение; завершённые раунды снижают его на 2%. При 100% допрос начинается после выхода из оплаченной игры. Варианты: взятка 40% баланса, блеф с шансом 50%, побег по шкале реакции.
## 9. Реализованный этап
Рабочие сцены и интерфейс остаются на MASM. ImageGen создал три новых прозрачных атласа:
- `assets/sprites/hall/underworld-portraits-v2.png`: 11 портретов и предметов.
- `assets/sprites/hall/underworld-world-v2.png`: три позы Семёна, коллектор, два стола и закрытый/открытый сейф.
- `assets/sprites/hall/rat-race-v2.png`: четыре согласованных беговых цикла по четыре кадра.
Игровые паки: `underworld-portraits-v2.bin`, `underworld-world-v2.bin`, `rat-race-v2.bin` в `assets/animations/hall/`. Три позы Семёна анимируются в подвале; крысы имеют разные темпы, рывки и остановки. Закрытый/открытый сейф и портрет коллектора подготовлены как ресурсы; текущий взлом использует отдельный лимб.
Для совпадения персонажей слотам бармена, певицы и гадалки присвоены изображения из их существующих игровых сцен. Пропорции Семёна и крыс исправлены; поза Семёна меняется по состоянию долга, без бессмысленного перебора жестов.
Офлайн-компилятор `tools/generators/pack_underworld_v2.py` разрезает утверждённые листы, сохраняет общий масштаб и точку опоры кадров, создаёт ANM1 BGRA и GIF-превью. Полные промпты находятся в `assets/sprites/hall/prompts-underworld-v2.json`. Старый процедурный генератор v1 не используется для новых игровых паков.
Долг, подозрение, нанятые участники, оставшиеся спины клевера и флаг однократной награды сохраняются рядом с выбранным профилем в файле с суффиксом `.underworld`. Формат имеет контрольную подпись; запись идёт через временный файл и замену. Старые основные сохранения не меняют формат. Активные игровые экраны не прерывают незавершённую ставку допросом или коллекторами.
`build.bat` обновляет корневой EXE, `build/graphics/poker.exe`, `bin/poker.exe` и контрольную сумму лаунчера.
Проверка: `python tools/tests/check_underworld.py`. Она собирает настоящий ASM с отдельной точкой входа, проверяет заём и возврат, QTE, отложенные переходы, подглядывание, расчёт безопасной карты, найм и награду, 100 оплаченных гонок при четырёх частотах кадров, загрузку прогресса, подходы к трём объектам и создаёт 10 снимков настоящего framebuffer. Существующие профили проверяются на неизменность. Дополнительно проверяются выезд, оба подхода, стены и стрельба, обнаружение/урон, терминал и доступ в хранилище, сейф без ранней выплаты, эвакуация с однократной наградой, смерть/отмена и точное возвращение на базу. Сняты 19 кадров настоящего игрового framebuffer. Кадры и GIF находятся в `build/underworld/`.
## 10. Оставшаяся работа
Личные задания вербовки пока не сделаны: команда нанимается за фишки, с указанными ролями. Текущая самостоятельная вылазка — одна карта с базовыми патрулями, камерой, ограниченным подкреплением и простыми напарниками прикрытия; сложные тактические команды, пейджеры, заложники и несколько контрактов пока не реализованы. Анализ в покере показывает текущую комбинацию, а не вероятность победы; энергетик ускоряет ходьбу. Конфискация коллекторами касается фишек, а не купленных артефактов.