86 lines
10 KiB
Markdown
86 lines
10 KiB
Markdown
# До отбоя — Godot 3D prototype v0.1
|
|
|
|
## Запуск Windows-билда
|
|
|
|
Откройте `builds/Windows/DoOtboy.exe`. Godot и интернет для игры не нужны.
|
|
В архиве Windows лежит тот же исполняемый файл. Перед запуском распакуйте архив.
|
|
|
|
## Управление
|
|
|
|
- ЛКМ по полу — пройти к точке с обходом мебели.
|
|
- ЛКМ по светлой метке предмета — подойти и взаимодействовать.
|
|
- WASD / стрелки — ходьба напрямую.
|
|
- E — взаимодействовать с ближайшим предметом.
|
|
- J — открыть память: факты и найденные исходы.
|
|
- Esc — закрыть разговор. Это **не пауза**.
|
|
- R — предложить перезапуск петли с сохранением фактов.
|
|
- M — включить или выключить звук.
|
|
|
|
Игра начинается после нажатия «Начать вечер». Петля длится **420 реальных секунд**: от 21:42 до 21:49. Диалоги, дневник, потеря фокуса окна и низкая частота кадров не останавливают таймер. Если свернуть игру, при возврате она учтёт прошедшее время.
|
|
|
|
На нуле — вспышка, звук удара и исход. Без выбранного решения — возврат к началу. Выбранный план нельзя заменить внутри текущей петли; сначала появляется подтверждение. Завершённые исходы можно переигрывать.
|
|
|
|
Факты, счётчик петель и открытые исходы сохраняются между запусками в `user://profile/memory.cfg` (Windows: `%APPDATA%/Godot/app_userdata/До отбоя/profile/memory.cfg`). Запись не зависит от прав на папку EXE. При первом запуске обновления старый профиль рядом с EXE или в `DoOtboy/profile/` переносится автоматически, если нового ещё нет. Для новой игры закройте игру и переименуйте новый файл. Поля профиля проверяются; неизвестные факты, неверные типы и отрицательный счётчик игнорируются. Запись идёт через временный файл с последующей заменой.
|
|
|
|
## Расписание петли
|
|
|
|
| Время | Что становится доступно |
|
|
| --- | --- |
|
|
| 21:42:08 | Звонок Кати и проверка маршрута |
|
|
| 21:42:45 | Диспетчер и журналистка (при наличии документов) |
|
|
| 21:43:50 | Отключение питания: ноутбуку нужны щиток или аккумулятор |
|
|
| 21:45:00 | Тамара и сосед у домофона; обмен требует аккумулятор |
|
|
| 21:46:00 | Голосовое Миши и решения, требующие его местонахождения |
|
|
| 21:47:30 | Водитель «Берег»: одно место для Миши или Кати |
|
|
| 21:48:30 | Потеря связи: новые звонки и выезды закрыты |
|
|
| 21:49:00 | Удар и результат принятого решения |
|
|
|
|
Знания сохраняются, но не отменяют расписание текущей петли. Открытые меню обновляются при смене этапа. Подтверждение повторно проверяет срок, знания и предметы: оставить окно открытым и подтвердить после дедлайна нельзя. Принятый вовремя план сохраняется после потери связи. В ванной можно укрыться до самого удара. Выключенный телефон не принимает звонки и сообщения; сирена и стук снаружи по-прежнему слышны. Забрать один аккумулятор дважды за петлю нельзя.
|
|
|
|
## Что реализовано
|
|
|
|
- 3D-квартира без крыши из примитивов: кухня, гостиная, прихожая, мамина комната, ванная.
|
|
- Ортографическая камера сверху с небольшим наклоном.
|
|
- Героиня из примитивов с анимацией ходьбы и физическими коллизиями.
|
|
- Поиск пути через дверные проёмы с обходом препятствий.
|
|
- 11 интерактивных точек, 10 сохраняемых фактов.
|
|
- Разговоры, условия доступа к решениям, подтверждение необратимого выбора.
|
|
- 10 мрачных текстовых исходов из сценария.
|
|
- Отключение света, восстановление питания, стук в дверь, звонки, сирена, удар.
|
|
- Оригинальные синтезированные звуки без сторонних аудиоассетов.
|
|
|
|
Это первый играбельный прототип. Персонажи за пределами квартиры и последствия решений представлены текстом. Нет озвучки, внешних локаций, полноценных NPC и финальных кинематографических сцен. Модель квартиры создаётся кодом в `scripts/apartment.gd` во время запуска; в редакторе до F6/F5 будет виден только корневой узел.
|
|
|
|
## Открыть исходники
|
|
|
|
Импортируйте `do-otboy/project.godot` в Godot **4.3 или новее** и нажмите F6/F5. Используется стандартный GDScript и Compatibility renderer, плагины не требуются.
|
|
|
|
- `scripts/game.gd` — события, реальное время, взаимодействия, сохранение.
|
|
- `scripts/apartment.gd` — геометрия, свет, интерактивные точки, навигационная сетка.
|
|
- `scripts/player.gd` — физическое перемещение и героиня.
|
|
- `scripts/interface.gd` — интерфейс, диалоги, дневник, экраны исходов.
|
|
- `scripts/story.gd` — факты, требования решений, десять концовок.
|
|
- `scripts/profile.gd` — проверка и запись профиля.
|
|
- `scripts/qa.gd` — сценарии прохождения через интерфейс и регрессии.
|
|
|
|
## Пересобрать
|
|
|
|
`build.ps1 -GodotPath "C:\путь\к\godot_console.exe"`
|
|
|
|
Если в `tools/templates` есть Windows release template 4.3, он будет использован. Иначе установите соответствующие Windows export templates в Godot; скрипт временно отключит локальный custom template. Для других версий Godot используйте соответствующие им шаблоны экспорта.
|
|
|
|
## Проверка
|
|
|
|
`godot_console.exe --path do-otboy -- --qa`
|
|
|
|
Режим QA не загружает и не перезаписывает игровой профиль. Сначала он проходит все 11 предметов с обычной скоростью CharacterBody3D. Затем каждый из десяти исходов проверяется с пустыми знаниями: персонаж физически подходит к нужным предметам через обычный обработчик перемещения, тест активирует существующие видимые кнопки сигналом `Button.pressed`, подтверждает решение и получает экран исхода через штатный удар. Прямых вызовов `choose_plan`, `commit_plan`, `finish_ending` в тесте нет. Это автоматизация UI внутри Godot, без имитации системного курсора.
|
|
|
|
Для сокращения прогона после проверки всех проходов скорость ходьбы в QA увеличена; время петли подставляется через стартовую отметку. Тест не ждёт десять раз по семь минут. Проверяются границы доступности, обновление открытых меню, протухшее подтверждение, запрет замены плана, выключенный телефон, завершение удара при 10 FPS, сброс предметов и сохранение знаний между петлями. Отдельный временный профиль проходит запись, повторную загрузку, замену и проверку повреждённых типов; пользовательское сохранение не используется.
|
|
|
|
Итог — `QA_UI_ENDING` для каждого исхода, `QA_RESULT`, файл `result.json` в каталоге снимков и код возврата. JSON доступен и в release-EXE без консольного вывода. При графическом запуске также сохраняются изображения начала игры и всех десяти экранов исходов в `qa/` исходного проекта или `captures/` рядом с Windows-билдом. Проверку внешнего вида запускайте без `--headless`.
|
|
|
|
|
|
## Авторские материалы
|
|
|
|
Весь сюжет, геометрия и звуки этого прототипа созданы для проекта. Godot распространяется по MIT; уведомление об авторских правах — `GODOT_LICENSE.txt`. Игра не использует ассеты Twelve Minutes.
|