KAZIK/docs/HEIST_AND_UNDERWORLD.md

23 KiB
Raw Blame History

Подполье Казино и Великое Ограбление (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. Первоначальный вариант ограбления собственного казино с вертолётом заменён этим сценарием.


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.
  • Бар: в главном зале 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. Оставшаяся работа

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