Бункер — браузерная игра

Браузерная социальная игра на выживание по мотивам настольного формата «Бункер».

Возможности

• Добавление от 2 до 12 игроков
• Онлайн-комнаты: создание и вход по коду через PHP API
• Синхронизация списка игроков между участниками комнаты в реальном времени (polling)
• Случайная катастрофа и описание бункера
• Приватный просмотр карточки игрока в его ход
• Контролируемое раскрытие атрибутов (1 раскрытие за ход, отдельное правило для 1-го раунда)
• Раунды голосования с обработкой ничьей
• Итоговый экран с выжившими и выбывшими

Структура проекта

• index.html — главная страница приложения
• css/style.css — стили интерфейса
• js/data.js — игровые данные (карты, катастрофы и т.д.)
• js/rooms.js — клиент онлайн-комнат
• js/game.js — игровая логика и работа интерфейса
• api/rooms.php — PHP API для создания/входа/выхода из комнат
• api/data/rooms/ — хранилище состояний комнат (JSON)

Локальный запуск

Сборка не требуется.

Для онлайн-комнат нужен запуск через PHP-сервер (чтобы работал api/rooms.php).

Вариант 1 (с онлайн-комнатами):

• Убедитесь, что установлен PHP 8+.
• Из корня проекта запустите:

php -S localhost:8000

• Откройте в браузере http://localhost:8000.

Вариант 2 (без онлайн-комнат):

• Можно открыть index.html напрямую в браузере.

Вариант 3:

• Запустите любой статический сервер.
• Например, используйте расширение Live Server в VS Code.
• Этот вариант подходит только для офлайн-режима (без PHP API).

Примечания

• Для онлайн-комнат сервер хранит JSON-файлы в api/data/rooms/.
• При деплое дайте веб-серверу права записи в api/data/rooms/.
• Не храните в репозитории секреты и приватные ключи
• Если в репозитории есть симлинки, для Pages лучше использовать публикацию через GitHub Actions