# Подполье Казино и Великое Ограбление (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. Оставшаяся работа Личные задания вербовки пока не сделаны: команда нанимается за фишки, с указанными ролями. Текущая самостоятельная вылазка — одна карта с базовыми патрулями, камерой, ограниченным подкреплением и простыми напарниками прикрытия; сложные тактические команды, пейджеры, заложники и несколько контрактов пока не реализованы. Анализ в покере показывает текущую комбинацию, а не вероятность победы; энергетик ускоряет ходьбу. Конфискация коллекторами касается фишек, а не купленных артефактов.