Vanguard Re:Master

Фанатский ремастер Cardfight!! Vanguard базовой эры (2011): формат Classic, сет BT01 и два триал-дека TD01/TD02.

Fan-made project. Not affiliated with Bushiroad. All card names and art belong to their respective owners.

Текущая оперативная сводка — docs/SESSION-STATE.md.

Статус

Блок	Состояние
Документация и решения	готово
Каталог карт (94 / 124 принта)	готово
Контент-пайплайн и валидатор	готово
Игровое ядро (правила)	каркас: фазы, райд, призыв, бой, драйв, урон
Протокол и контракты (docs/protocol.md, Vanguard.Shared)	готово
Сервер: матч по сети, матчмейкинг, реконнект	готово
PostgreSQL (матчи), Redis (тикеты, очередь), Docker	готово
Мета-API: JWT, коллекция, каталог, колоды, магазин, история, реплеи	готово
CI (Forgejo Actions)	готово: ci.yml проходит на home-runner
EF-миграции	готово (InitialCreate)
Orleans	готово: silo + MatchActorGrain, включается Orleans:Enabled
Клиент	Unity 6.6: 3D-сцены, логин, онбординг, коллекция, декбилдер, магазин, история/реплей, очередь, тренировка с ботом, бой с артами, маллиганом, зоной урона, анимациями и RU/EN
Лаунчер	не начато

Требования

• .NET SDK 10 (LTS). Версия зафиксирована в global.json.
• Python 3 — только для переимпорта карт из первоисточника.

Быстрый старт

# проверить целостность контента
dotnet run --project server/src/Vanguard.Cli -- validate

# сводка по кланам, триггерам и редкостям
dotnet run --project server/src/Vanguard.Cli -- stats

# 1000 партий случайного бота с проверкой инвариантов
dotnet run --project server/src/Vanguard.Cli -- stress 1000

# тесты
dotnet test server/Vanguard.slnx

Запуск игрового сервера:

dotnet run --project server/src/Vanguard.Server --urls http://localhost:5080
# проверка: http://localhost:5080/health

Orleans по умолчанию выключен; Orleans__Enabled=true включает silo в том же процессе. В docker-compose.yml он уже включён; для локального запуска без Orleans ничего дополнительно настраивать не нужно. Состояние соединений остаётся в процессе, поэтому несколько реплик сервера пока не поддерживаются.

Контейнер: docker compose up --build, затем http://localhost:8080/health. Порт задаётся в .env (VANGUARD_PORT, VANGUARD_WS_URL); стек включает PostgreSQL и Redis (AOF). HTTP-контракт очереди и тикетов — docs/server-api.md.

Ожидаемый вывод валидатора:

Карт: 94   Принтов: 124

OK: ошибок 0, предупреждений 0

Структура

/server/src/Vanguard.Rules        ядро правил: карты, колоды, состояние игры
/server/src/Vanguard.Content      загрузка и проверка YAML-контента
/server/src/Vanguard.Shared       сетевые контракты (netstandard2.1 для Unity + net10.0)
/server/src/Vanguard.Server       ASP.NET Core: WebSocket, мета-API, магазин, матчи
  /Auth                           JWT, register/login/refresh, BCrypt
  /Meta                           коллекция, колоды, экономика, история, реплеи
  /Storage                        PostgreSQL-снапшоты и восстановление матчей
  /Matchmaking                    очередь, MMR, Redis-хранилище очереди
  /Tickets                        тикеты: память или Redis
/server/src/Vanguard.Cli          консольные команды
/server/tests                     тесты правил, контрактов и сервера (включая E2E)
/content/sets                     карты в YAML
/content/trial-decks.yaml         две триал-деки
/content/pack_odds.yaml           веса бустера
/content/keywords.yaml            ключевые слова и иконки
/content/translations/ru.yaml     русские тексты
/tools                            импорт и сид переводов
/docs                             протокол, API, правила перевода
/docker-compose.yml               PostgreSQL, Redis и сервер

Vanguard.Rules — чистая библиотека без Orleans, БД и сети. Это позволяет прогонять матчи в консоли и проверять правила до появления клиента.

Контент

Первоисточник — официальный карт-лист en.cf-vanguard.com: и параметры карт, и арты берутся с одного сайта (tools/import_official.py). Пересобрать YAML и докачать недостающие арты:

py tools/import_official.py --sets BT01,TD01,TD02

Полезные режимы: --list-sets (какие сеты есть и их id), --no-art, --dry-run, --limit N для пробного прогона. На Windows, где python — заглушка Microsoft Store, используйте py.

tools/import_cards.py — прежний вариант (триггеры и редкости брались из вики, арты — с Fandom); оставлен как справка. Ручные поля из существующих YAML (snipeBackRow, boost, nameRu, textRu) новый импорт сохраняет.

Валидатор проверяет инварианты, которые легко нарушить вручную:

• у grade 0 щит 5000 только у Draw-триггера, иначе 10000;
• Sentinel всегда со щитом 0;
• параллельный принт (BT01/S01…S12) ссылается на существующий базовый принт той же карты;
• в колоде ровно 50 карт, ≤4 копий по имени (а не по принту), ≤4 Sentinel, ≤4 Heal.

Тексты карт и иконки

Ключевые слова ([AUTO], [Counter-Blast 3], (VC/RC), <Kagero>) заменяются на иконки при отрисовке. Чтобы перевод не ломал разметку, тексты хранятся в виде шаблонов с токенами:

{auto}:{cb:2} When this unit is placed on {vc}, you may pay the cost...

Список токенов и их иконок — content/keywords.yaml. Русские тексты — content/translations/ru.yaml: заполняется только textRu. Поле nameRu существует, но пока содержит английское название — на случай, если позже решим переименовать карты. Правила перевода и спорные термины — docs/translation-rules.md.

Черновой перевод всех 66 текстов уже залит; его правит человек, после чего правила уточняются под фактические правки.

# создать файл переводов или обновить шаблоны, сохранив введённые переводы
dotnet run --project server/src/Vanguard.Cli -- translations build

# проверить заполнение и целостность токенов
dotnet run --project server/src/Vanguard.Cli -- translations check

Проверка ловит: незаполненные тексты, потерянные или лишние токены, токены, которых нет в справочнике. Карты без эффекта считаются готовыми сразу — им переводить нечего.

Язык клиента

Интерфейс переключается между RU и EN кнопкой в Login и Lobby; выбор сохраняется в PlayerPrefs. Переводы UI живут в client/Assets/Vanguard/Runtime/UI/Localization.cs, а имена и тексты карт берутся из пары nameRu/nameEn и textRu/textEn каталога /api/cards. Переключение применяется на лету, без перезагрузки сцены.

Документация

• plan.md — исходный дизайн-документ.
• DEVELOPMENT_CHECKLIST.md — решения, механики, экономика, риски.
• IMPLEMENTATION_CHECKLIST.md — исторический план по блокам и гейтам.
• docs/Development/IMPLEMENTATION_PLAN.md — активный журнал задач и шаблон плана.
• docs/Development/AGENT-WORKFLOW.md — двухэтапный процесс: анализ → реализация (обе стадии на DeepSeek).
• docs/HANDOFF.md — состояние на конец сессии и порядок следующих шагов.
• docs/protocol.md — протокол матча: кадры, интенты, события, таймеры, реконнект.
• docs/game-rules.md — конспект правил и сверка с текущей реализацией.
• docs/server-api.md — HTTP API: JWT, коллекция, каталог, колоды, магазин, очередь, история и реплеи.
• content/cards-mvp.md — каталог карт с разбором состава сетов.