ssa/hexo

Fork 0

Files

sokol ed27ca93ab Update documentation for all recent features

2026-02-22 11:08:02 +03:00

9.1 KiB

Raw Permalink Blame History

HEXO

Учебный проект. Игра, клон DiceWars

Запуск игры

npm run serve    # Запустить веб-сервер (http://localhost:8080)
npm test         # Запустить тесты (88 тестов)
npm start        # Консольная версия карты

Экран запуска

При запуске игры открывается экран настройки:

Выберите количество игроков: 2, 3 или 4
Выберите размер карты:
- Small (10×10) — Быстрая игра на маленькой карте
- Medium (15×15) — Сбалансированный размер
- Large (20×20) — Стандартный размер (по умолчанию)
- Extra Large (25×25) — Большая карта для длительных игр
Настройте тип каждого игрока:
- Human — управление человеком (клики мышью)
- AI Bot — управление компьютером
Нажмите Start Game для начала игры

Комбинации игроков

Можно создавать любые комбинации:

Все игроки — люди (Hotseat)
Все игроки — AI боты (наблюдение за игрой ИИ)
Смешанный режим (например, P1-Human, P2-AI, P3-Human, P4-AI)

Цвета игроков

Игрок	Цвет	HEX
P1	🟢 Зелёный	`#4ecca3`
P2	🔴 Красный	`#e94560`
P3	🟡 Жёлтый	`#f9ed69`
P4	🔵 Бирюзовый	`#00adb5`

AI Bot

Как работает

AI бот автоматически играет за выбранного игрока:

Анализ поля — бот оценивает все возможные ходы
Приоритеты ходов:
- 🎯 Атака слабого противника (высокий шанс победы) — приоритет 100+
- 📈 Захват пустых клеток (расширение территории) — приоритет 50+
- 💪 Укрепление позиций (перемещение к сильным клеткам)
Задержка мышления — 1000 мс перед каждым ходом для естественности геймплея
Несколько ходов за turn — AI делает все возможные ходы подряд, затем завершает ход

Индикаторы AI

В карточке игрока отображается метка (AI)
Во время хода AI в панели действий показано: "AI is thinking..."
Кнопки управления отключены во время хода AI

Логика принятия решений

movePriority(move) {
  let priority = 0;

  // Атака слабого врага (высший приоритет)
  if (move.type === 'attack') {
    if (move.attackStrength > move.defenseStrength) {
      priority += 100; // Высокий шанс победы
      priority += move.attackStrength - move.defenseStrength;
    } else {
      priority -= 50; // Рискованная атака
    }
  }

  // Расширение на пустые клетки (средний приоритет)
  if (move.type === 'expand') {
    priority += 50;
    priority += move.attackStrength;
  }

  // Бонус за сильную позицию
  priority += move.attackStrength * 0.5;

  return priority;
}

Правила игры

1. Карта

Гексагональная сетка 10×10, 15×15, 20×20 или 25×25 ячеек
Каждая ячейка может быть:
- Проходима (пустая или принадлежит игроку)
- Непроходима (заблокирована, серый цвет, ~15% карты)

2. Игровые единицы

Кубик: 6-гранный, значения 1-6
На поле может быть до 8 кубиков на клетку
Сила юнита: F = (cnt-1) × 6 + current_dice
- cnt — количество кубиков
- current_dice — значение верхнего кубика

Примеры расчёта силы:

Кубики	Сила
[4]	4
[6]	6
[6, 1]	7
[6, 6, 2]	14
[6, 6, 6, 6, 6, 6, 6, 6]	48 (максимум)

3. Ход игры

Перемещение/Атака

Можно ходить, если сила > 1
На целевую клетку переходит сила-1, на исходной остаётся 1
При атаке оба игрока бросают кости:
- Атакующий: attack_roll = rnd(1..сила-1)
- Защищающийся: defense_roll = rnd(1..сила)

Результат боя

Условие	Результат
`attack_roll > defense_roll`	Атакующий побеждает, занимает клетку с `attack_roll-1`. На исходной клетке остаётся 1
`attack_roll <= defense_roll`	Атака отбита. Атакующий уменьшается до 1. Защитник остаётся с `defense_roll - attack_roll` (мин. 1)

Снабжение

После хода игрок получает снабжение:

Снабжение = размер наибольшей непрерывной территории
Непрерывная территория — связанные между собой клетки игрока
Если территория разорвана врагом — считается только наибольший кусок
Снабжение распределяется по 1 единице случайным клеткам (не максимальным)
Максимум на клетке: 48 (8 кубиков × 6)

4. Победа

Последний игрок, оставшийся с клетками на карте, побеждает.

Управление

Действие	Управление
Выбрать клетку	Клик на свою клетку с кубиками
Атаковать	Клик на соседнюю вражескую/пустую клетку
Отменить выбор	Кнопка Cancel или клик на ту же клетку
Завершить ход	Кнопка End Turn
Вернуться в меню	Кнопка Main Menu

Индикаторы на экране

Выделенная клетка — красная подсветка
Доступные цели — зелёная подсветка соседних клеток
Лог боёв — правая панель с историей действий
Инфо о клетке — сила и количество кубиков выбранной клетки

Настройки игры

Игра поддерживает:

2-4 игрока (любая комбинация людей и AI)
4 размера карты: 10×10, 15×15, 20×20, 25×25
Случайная генерация карты при каждом запуске
Случайные стартовые позиции для игроков

Стартовые позиции

Игроки размещаются в углах карты (позиции масштабируются с размером карты):

Игрок	Позиция	Описание
P1	(offset, offset)	Верхний-левый угол
P2	(size-1-offset, size-1-offset)	Нижний-правый угол
P3	(offset, size-1-offset)	Нижний-левый угол
P4	(size-1-offset, offset)	Верхний-правый угол

offset = max(1, floor(size / 10))

Каждый игрок начинает с силой 8 на своей стартовой позиции.

Тестирование

Проект покрыт 88 тестами, проверяющими:

Динамические размеры карт (10×10, 15×15, 20×20, 25×25)
HexCell: создание, расчёт силы, максимальная сила, добавление кубиков
HexMap: генерация, соседи, снабжение, владение
Логика выбора целей: атака врагов, захват пустых клеток, блокировка своих клеток
AIBot: поиск ходов, приоритеты, выполнение ходов, завершение хода
Интеграционные тесты: 4 AI бота одновременно, разные размеры карт

npm test

Все тесты проходят успешно ✅

9.1 KiB Raw Permalink Blame History Unescape Escape