Русский · English
TowerForge от Lindforge Studios — создавайте собственные tower-defense игры.
TowerForge — открытый и независимый от конкретного контента конструктор 2D tower-defense игр с гексагональными и квадратными картами. В него входят детерминированный движок симуляции на TypeScript, локальный редактор проектов .tdproj, Wang/autotile pipeline, безопасные TowerScript-сценарии, CLI, headless-симуляции и анализ баланса, а также mobile, large-screen web и native desktop player targets с Canvas- или Phaser-рендерером, presentation-only ракурсами камеры и data-only HUD.
Desktop-сборки публикуются в GitHub Releases. Текущие alpha-версии явно помечаются как Unsigned build. Перед запуском сверяйте установщик с приложенным файлом SHA256SUMS. Инструкции по установке на macOS и политика распространения неподписанных сборок находятся в docs/releasing.md.
Текущая публичная версия — v0.8.0, неподписанный pre-release. Ветка main уже включает принятый R22 с opt-in плейлистами заставок и готовится как кандидат v0.9.0; публичной версия станет только после тега, сборки шести installers и проверки SHA256SUMS. Все presentation и gameplay расширения остаются opt-in; legacy targets не меняются. Точный статус и границы ведутся в ROADMAP.
| Компонент | Назначение | Расположение |
|---|---|---|
| TowerForge Editor | Редактор карт, контента и баланса | packages/studio |
| TowerForge Desktop | Устанавливаемая оболочка Studio для Windows, macOS и Linux | packages/desktop |
| TowerForge AI | ИИ-помощник и MCP-агент для цикла создание → симуляция → баланс → изменение | packages/mcp |
| TowerForge Runtime | Детерминированный движок и рендереры собранной игры | packages/engine, packages/renderer |
| TowerForge Market | Шаблоны, ресурсы и карты, запланировано в ROADMAP | — |
| TowerForge Academy | Обучение созданию игр, запланировано | — |
npm install
npm run studioStudio откроется по адресу http://localhost:5174 и по умолчанию загрузит examples/starter.tdproj. Основной язык интерфейса — русский; английский можно выбрать в Настройки → Внешний вид → Язык.
| Задача | Команда |
|---|---|
| Установить зависимости | npm install |
| Создать проект | npx towerforge create my-game --template classic --grid square, сетки hex/square, шаблоны classic, maze, idle, roguelike |
| Запустить Studio | npm run studio |
| Запустить MCP-сервер | npm run mcp -- --project examples/starter.tdproj |
| Собрать Codex plugin | npm run plugin:build |
| Проверить Codex plugin | npm run plugin:validate && npm run plugin:smoke |
| Подключить ИИ-клиент | npx towerforge mcp:connect <project> [--client <id> --write] или выбор клиента в Настройки → Интеграция ИИ-агентов |
| Проверить проект | npm run validate |
| Получить результат проверки в JSON | npm run validate -- --json |
| Симулировать стартовую миссию | npm run sim tutorial_01 60 |
| Получить симуляцию в JSON | npm run sim tutorial_01 60 -- --json |
| Запустить анализ баланса | npm run balance -- --project examples/starter.tdproj |
| Запустить Persona QA | npm run persona-qa -- --project examples/starter.tdproj --mission tutorial_01 --seed smoke --seconds 20 |
| Скомпилировать исходные карты | npm run maps:compile -- --project examples/starter.tdproj |
| Записать миграции схемы | npm run migrate -- --project examples/starter.tdproj --write |
| Проверить типы движка | npm run typecheck |
| Собрать runtime движка | npm run build:engine |
| Собрать веб-игру | npm run build |
| Собрать единый HTML-файл | npm run build -- --single-file |
| Упаковать переносимый веб-ZIP | npm run package:web -- --project examples/starter.tdproj |
| Экспортировать проверенный проект | npm run project:export -- --project examples/starter.tdproj --out game.tdpack |
| Импортировать проект | npm run project:import -- game.tdpack --dir ./projects |
| Показать встроенные темы | npm run themes:list |
| Просмотреть или применить тему | npm run themes:apply -- verdant-frontier --project examples/starter.tdproj --dry-run |
| Создать mobile-scaffold | node packages/cli/package.mjs --project examples/starter.tdproj --kind mobile |
| Создать desktop-scaffold игры | node packages/cli/package.mjs --project examples/starter.tdproj --kind desktop |
| Запустить desktop Studio | npm run desktop:dev |
| Собрать установщики Studio | npm run desktop:build |
| Собрать установщики для текущей ОС | npm run desktop:build:mac, npm run desktop:build:win или npm run desktop:build:linux |
| Пересобрать бренд-баннеры | npm run brand:build |
| Пересобрать нативные иконки | npm run brand:icons |
| Пересобрать встроенные tile sheets | npm run tiles:build-presets |
| Запустить unit- и integration-тесты | npm run test |
| Запустить браузерные E2E-тесты | npm run test:e2e |
Команда сборки записывает результат стартового проекта в examples/starter.tdproj/dist. Studio умеет открывать собранную игру в изолированном предпросмотре. Для ручного просмотра через loopback-сервер:
python3 -m http.server 5175 --bind 127.0.0.1 --directory examples/starter.tdproj/distЗатем откройте http://127.0.0.1:5175.
Каталог .tdproj является исходным кодом игры:
project.json— метаданные проекта.content/balance.json— константы, типизированный terrain registry, сложности, метапрогрессия, награды, способности, враги, башни, волны и миссии.content/mechanics.json— необязательный versioned-каталог opt-in механик; без него проект сохраняет штатное legacy-поведение.content/world-map.json— регионы и узлы миссий.content/visuals.json— визуальный каталог v2; schema v3 опционально добавляет декларативныйproceduralJuicev1, а schema v4 — presentation-only camera profiles и view variants.content/distribution.json— optional Distribution v1 для воспроизводимой публикации, Remix policy и host-only monetization hooks.content/hud.json— optional data-onlyHudCatalogV1для responsive HUD, экранов и меню строительства.content/story-comics.json— сюжетные панели, связанные с миссиями.content/battle-backgrounds.json— цвета миссий и необязательные фоновые спрайты.maps/src/*.tmj— редактируемые исходные карты.maps/compiled/maps.json— runtime-описания карт, созданные компилятором.scripts/**/*.tower.json— детерминированная пользовательская логика; TowerScript v7 опционально добавляет Behavior Trees и HFSM, а v1–v6 сохраняют прежний путь.build-targets.json— цели сборки; v2 добавляет opt-indesktop | responsiveform factors, first-class native desktop target и ссылки на camera/HUD/splash profiles.content/splashes.json— optionalSplashCatalogV1с 1–8 локальными PNG/JPEG/WebP-заставками после обязательного системного splash..towerforge/— локальное состояние редактора и резервные копии; каталог нельзя добавлять в git.
Миссия выбирает профили каталога через mission.mechanics; само наличие профиля не включает механику. Реализованные независимые профили охватывают combat/reactions, navigation/elevation/physics/terraforming, roguelite, heroes, logistics, director, quests, multiplayer, enemy behaviors, ballistics и weather. Mechanics Hub и AI/MCP показывают prerequisites для recipes, но никогда не включают зависимые профили и не патчат terrain, map, tower или ability автоматически. Обычные starter-проекты не содержат content/mechanics.json и сохраняют legacy path. Точные версии, зависимости и checkpoint/snapshot contracts находятся в ARCHITECTURE.md, а пользовательские последовательности — в runbook и reference examples.
Канонические границы модулей и инварианты описаны в ARCHITECTURE.md. Продуктовая архитектура и roadmap находятся в docs/td-constructor-architecture.md.
Единый стильгайд Studio, player shell и HUD находится в DESIGN.md. Бренд-ресурсы, палитра, правила нейминга и экспорта описаны в docs/brand.md. Русский social preview подготовлен для настроек GitHub; рядом находится английская версия.
Все игры, собранные официальным компилятором TowerForge, показывают встроенный системный splash Made with TowerForge перед загрузкой игрового меню. Он одинаков для Canvas/Phaser и web/mobile/desktop carriers и не отключается через данные проекта или HUD. R22 позволяет отдельно для build target добавить после него 1–8 заставок разработчика/издателя; без явной привязки legacy-вывод не меняется.
npm run sim ... -- --json и MCP-инструмент simulate_mission возвращают отчёт для агента: исход, агрегированные события, временную шкалу событий и ресурсов, снимки ключевых моментов, детерминированную стратегию и следующие допустимые действия. npm run balance и MCP-инструмент balance_report запускают несколько детерминированных стратегий и показывают процент побед, оставшееся здоровье ядра, использование башен, параметры стратегий и предупреждения советника.
Правила агентов находятся в AGENTS.md, операционные инструкции — в docs/runbook.md, политика релизов — в docs/releasing.md, архитектурные решения — в docs/adr/, примеры — в docs/examples/.
Встроенный Чат с ИИ и внешние MCP-клиенты используют общий реестр инструментов и единую политику авторинга. Доменное описание схем объясняет агентам, когда применять универсальные эффекты, TowerScript, сложность и метапрогрессию или визуальные темы. Инструменты публикуют метаданные риска и предпочитают preview, revision guard, узкие изменения, проверку и rollback. В настройках доступны ChatGPT OAuth через Codex App Server, аккаунт Claude через Claude Agent SDK/runtime и прямые ключи Anthropic, OpenAI и OpenRouter. Правая панель чата поддерживает режимы вопроса, плана и действия, выбор модели и уровня рассуждений, изображения и локально извлечённые кадры видео.
Для Codex доступен отдельный public marketplace towerforge-codex-plugin. Его release bundle детерминированно собирается из plugins/towerforge в этом репозитории. Плагин добавляет skill и локальный MCP runtime без API-ключа и TowerForge cloud account. Сервер ищет .tdproj только в файловых roots текущей Codex workspace, не принимает абсолютный projectDir от модели и удаляет локальные пути из ответов. Полная установка и модель безопасности описаны в runbook.
MIT. См. LICENSE.