Вся партия
Главное меню, настройка сценария и случайной карты, хотсит, сохранение и загрузка, карта приключений, города, найм, обмен, бои и осады, повышения, экран итогов.
Зачем
Герои — стратегия с длинным горизонтом: экономика, разведка, бои, карта, которую берут неделями. Одним удачным ходом её не выиграть, поэтому из неё выходит честный бенчмарк стратегического мышления агентов — в одиночку, против человека или в команде с ним.
Идеи и принципы
Всё началось с идеи матчей между разными нейросетями. Цель выросла шире: программный игрок, который занимает место живого — против агента, против человека, в союзе с ним, по просьбе «поиграй за меня» или «развивайся до Капитолия», в полностью автономной партии.
- Настоящая игра. Агент играет в установленную у вас HotA, а не в копию или симулятор. Человек смотрит, участвует и в любой момент забирает управление.
- Как живой игрок. Действия идут через штатные обработчики интерфейса. Героя не переносят записью координат, покупку не делают правкой ресурсов, исход боя не пишут в память.
- Без картинок. Игра читается структурой, без скриншотов и OCR: так партия остаётся точной и недорогой.
- Честная граница. Агент знает ровно то, что узнал бы человек за этой стороной. Туман, чужие армии и планы компьютера закрыты; неизвестное — явный статус, а не выдумка.
- Мост не советчик. Он передаёт состояние и выполняет решения. Цели, маршрут, бой и свой цвет выбирает агент; справка — отдельный инструмент и в ответы не подмешивается.
- Команды по смыслу. Агент называет цель — город, сундук, шахту, отряд — а не пиксели. Геометрия и нажатия — забота моста.
- Надёжные операции. Каждое действие привязано к ревизии наблюдения: повтор не купит войска дважды, при неизвестном итоге сначала сверка, а не слепой повтор.
- Экономия. Короткая сводка и подробности по запросу; ожидание анимаций и чужих ходов не тратит вызовы модели. Стоимость партии считается по фактическим данным.
- Любая модель. Мост не привязан к поставщику: Claude, DeepSeek или любой другой агент с MCP.
- Весь цикл без подготовки. От закрытой игры до экрана итогов: запуск, меню, сценарий или случайная карта, партия, сохранение и загрузка — без ручной подготовки.
Что умеет
Всё словами
Каждый observe начинается со сводки хода. Герои, города, отряды и объекты — по именам; маршруты, стоимость и отметки «посещено» — от самой игры.
Честные границы
Скрытая карта, чужой ход, устаревший взгляд — отказ с кодом причины. Агент видит ровно то, что видит игрок, и ничего сверх.
Играет как человек
Читает то, что на экране, и жмёт кнопки самой игры оконными событиями. Без перехвата мыши, computer-use, OCR и внутренних команд игры.
Встроенный справочник
Правила, формулы, карточки существ и артефактов из таблиц установленной игры. Поиск офлайн — агенту не нужно полагаться на память.
Хотсит и команды
Мост передаёт цвет хода и участников сценария, свой цвет агент выбирает сам. Играйте против агента, с ним в команде или столкните двух агентов.
Стоимость партии
Доллары, токены и вызовы по сторонам и дням игры из телеметрии Claude Code — видно, во что обходится стратегия каждой модели.
Итог подтверждает игра
Одно действие — один вызов по ревизии наблюдения: устаревший взгляд отклоняется, повтор безопасен. Итог подтверждает сама игра — сменой экрана, ресурсов, журнала боя.
Партия глазами агента
Агент получает экран структурой: сводку хода, ресурсы, героев, отряды, доступные действия и их подписи. Решает он сам — мост только показывает и нажимает.
Инструменты
31 инструмент; полные описания — в справочнике агента.
| Инструмент | Для чего |
|---|---|
observe | Всё состояние своей стороны и действия, доступные на этом экране |
act | Любое смысловое действие из observe: город, найм, бой, диалог, конец хода |
nearby_targets, inspect_target, read_map | Что вокруг, маршрут и стоимость от самой игры, разведанная карта |
move_to, move_to_tile, attack_target | Ходьба и бой — нарочно разные инструменты |
inspect_cell, inspect_element, inspect_tile | Карточки правой кнопки и строка состояния, которые читает игрок |
wait_for_turn, ally_log | Хотсит: ждать своего хода или окна, адресованного вам; что сделал союзник |
plan, mark, read_journal | Память агента между ходами |
hota_docs, hota_reference | Справочник по игре |
debug_snapshot | Кадр и наблюдение одной парой — чтобы сообщить, что мост читает не так |
Как начать
- 1УстановитьСкачайте установщик и запустите, закрыв HD Launcher. Игру он найдёт сам и положит на рабочий стол ярлык «HotA MCP».
- 2Подключить агентаClaude Code, Claude Desktop, Codex или любой MCP-клиент — строки ниже.
- 3ИгратьСкажите агенту «давай поиграем в героев». Он поднимет службу, лаунчер и игру сам — или запустите их ярлыком.
Claude Code:
claude mcp add hota -- "C:\Users\<вы>\AppData\Local\Programs\HotaMcp\app\HotaMcp.exe" --stdioClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"hota": {
"command": "C:\\Users\\<вы>\\AppData\\Local\\Programs\\HotaMcp\\app\\HotaMcp.exe",
"args": ["--stdio"]
}
}
}Путь — если ставили в папку по умолчанию; иначе укажите свою. Правила игры сервер отдаёт клиенту при подключении, полный порядок — навык hota-player.
Вопросы
Что нужно для игры?
Windows 10/11 x64 и ваша легальная копия Heroes of Might and Magic III Complete (GOG) с Horn of the Abyss 1.8.1 и HD Mod — при подключении мост проверяет, что всё нужное ему на месте в этой сборке. Файлов игры в проекте нет.
Какие агенты подходят?
Любой MCP-клиент через stdio или HTTP: Claude Code, Claude Desktop, Codex и другие. Проверено с Claude и DeepSeek. Автобой идёт до 3 минут — поднимите таймаут вызова инструмента в клиенте (у Codex — tool_timeout_sec = 200).
Это бесплатно? Куда уходят данные?
Проект бесплатный, лицензия MIT. Служба работает на вашем компьютере и слушает только 127.0.0.1; телеметрия стоимости партии, если включить, тоже уходит только в локальный мост.
Работает ли с игрой не на русском?
Мост проверен на русской HotA 1.8.1: около двух десятков фраз игры мост сверяет по тексту. Если ваша игра на другом языке — расскажите, что не читается, это одна из главных задач следующих версий.
Нужна помощь
Мост, навык агента и справочник пока говорят по-русски. Поиграйте с агентом и сообщите, где он застревает; переведите навык и справочник на свой язык — модели играют лучше, когда справочник говорит на языке игры, которую они видят.