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