Перейти к основному содержимому

Установка

Это руководство проведёт вас через импорт MCE в ваш Unity-проект и первоначальную настройку.

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

  • Unity 6 LTS (версия 6000.3.x или новее), установленная через Unity Hub.
  • Universal Render Pipeline (URP) -- MCE требует URP для своей системы рендеринга.
  • Новый или существующий Unity-проект, настроенный на URP.
Версия Unity

MCE создан и протестирован на Unity 6 LTS (6000.3.8f1). Более ранние версии Unity (2022 LTS, 2021 LTS) не поддерживаются. Использование другой патч-версии Unity 6 должно работать, но придерживайтесь канала LTS для стабильности.

Шаг 1: Импорт из Asset Store

  1. Откройте Unity Asset Store в браузере или через Window > Asset Store в редакторе.
  2. Найдите "Monster Capture Engine" или "OpenMon MCE".
  3. Приобретите уровень, подходящий для вашего проекта (Lite, Basic, Pro, Online или Source).
  4. В Unity откройте Window > Package Manager.
  5. Выберите My Assets из выпадающего списка, найдите Monster Capture Engine и нажмите Import.
  6. Импортируйте все файлы по запросу. Пакет установится в Assets/OpenMon/.
Альтернатива: файл Unity Package

Если вы получили MCE в виде файла .unitypackage, просто перетащите его в окно Project или используйте Assets > Import Package > Custom Package и выберите файл.

Шаг 2: Настройка URP

Если ваш проект ещё не использует URP, необходимо его настроить:

  1. Установите URP из Package Manager: Window > Package Manager > Unity Registry > Universal RP.
  2. Создайте URP Asset: Assets > Create > Rendering > URP Asset (with Universal Renderer).
  3. Назначьте его в Edit > Project Settings > Graphics > Scriptable Render Pipeline Settings.
  4. Назначьте его в Edit > Project Settings > Quality > Rendering для каждого уровня качества.

MCE включает пользовательские URP-шейдеры для освещения по времени суток и погодных эффектов. Для их корректной работы необходим URP.

Шаг 3: Мастер первоначальной настройки

Когда вы впервые откроете сцену после импорта MCE, автоматически появится Мастер первоначальной настройки. Если этого не произошло, запустите его вручную из меню:

MCE > Tools > Setup Wizard

Мастер выполняет:

  • Выбор языка -- Выберите язык разработки (влияет на интерфейс редактора и локализацию по умолчанию).
  • Инициализация базы данных -- Создаёт необходимые базы данных ScriptableObject, если они не существуют.
  • Настройка ввода -- Устанавливает привязки ввода по умолчанию для клавиатуры и геймпада.
  • Настройка сцены -- Проверяет настройку сцены и создаёт недостающие необходимые GameObject'ы.

Пройдите каждый шаг мастера. По завершении вы увидите подтверждающее сообщение и сможете приступить к работе.

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

После импорта ваш проект будет содержать следующую структуру:

Assets/
OpenMon/
Core/
Runtime/ # Код ядра движка (сражения, монстры, мир, сохранения, UI)
Actors/ # Система NPC и скриптинг CommandGraph
Battle/ # Система сражений с 15+ модульными компонентами
Characters/ # Контроллеры персонажей игрока и NPC
Configuration/ # ScriptableObject'ы конфигурации игры
GameFlow/ # Управление состоянием игры
Initialization/ # Запуск движка и первоначальная настройка
Monster/ # MonsterInstance, Roster, эволюция, разведение
MonsterDatabase/ # Определения ScriptableObject'ов монстров/приёмов/предметов/способностей
MonsterDex/ # Система отслеживания MonsterDex
Player/ # Состояние игрока (GlobalGameData)
Quests/ # Система квестов (уровень Pro+)
Rendering/ # URP-шейдеры и вспомогательные средства рендеринга
Saves/ # Система сохранения/загрузки
SDK/ # Интерфейсы публичного API
UI/ # Все UI-контроллеры и префабы
World/ # Система сетки, тайлы, встречи, карты
Editor/ # Инструменты, доступные только в редакторе
ArtGenerator/ # Генерация спрайтов с помощью ИИ (уровень Basic+)
MonsterCreator/ # Мастер создания монстров
Tools/ # Обозреватель базы данных, редактор таблицы типов, валидаторы
Art/ # Включённые художественные ресурсы
Различия между уровнями

Не все папки будут присутствовать в каждом уровне. Например, Editor/ArtGenerator/ доступен только в уровне Basic и выше. Папка Runtime/SDK/ содержит интерфейсы публичного API, доступные во всех уровнях, включая Lite.

Шаг 4: Проверка установки

Чтобы убедиться, что всё работает:

  1. Откройте демо-сцену по адресу Assets/OpenMon/Scenes/DemoScene (если включена в ваш уровень).
  2. Нажмите Play в редакторе Unity.
  3. Вы должны увидеть последовательность инициализации MCE, а затем игровой мир.

Если вы видите ошибки в консоли:

  • Проверьте, что URP правильно настроен (наиболее частая проблема).
  • Убедитесь, что вы импортировали все файлы из пакета.
  • Запустите MCE > Tools > Asset Validation для проверки целостности базы данных.

Следующие шаги

Вы готовы начать разработку. Перейдите к следующему руководству, чтобы создать своего первого монстра: