Установка

Это руководство проведёт вас через импорт MCE в проект Unity и первый запуск.

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

• Unity 6 LTS (6000.3.8f1 или новее), установленная через Unity Hub.
• Новый проект, созданный по шаблону «Universal 2D» или «Universal 3D».

Это весь список. Ничего покупать или устанавливать заранее не нужно.

Сторонняя библиотека твининга не нужна

Прежние версии этой страницы советовали установить DOTween Free перед импортом. Это больше не так, и этот шаг можно пропустить: слой анимации — NovaMotion, компонент MCE, который поставляется с движком за собственным API OpenMon OpenMon.Foundation.Tweening, поэтому движок компилируется только с шаблоном URP. Тест в режиме редактора это гарантирует: ни один файл движка не может импортировать DG.Tweening, так что зависимость не вернётся случайно.

Если DOTween уже есть в проекте, это не навредит; движок просто его не использует.

Импортируйте в пустой проект. Оба шаблона URP уже включают URP, Input System и TextMeshPro. Ни один не включает Cinemachine и VFX Graph, а шаблон 3D также не содержит 2D Tilemap Extras и 2D Sprite: установщик на шаге 2 добавит всё недостающее.

Шаг 1: Импорт .unitypackage

1. В Unity: Assets > Import Package > Custom Package.
2. Выберите файл .unitypackage OpenMon для вашей редакции.
3. Нажмите Import — импортируйте ВСЕ файлы.
4. Дождитесь, пока Unity скомпилирует скрипты (~30–60 секунд).

Шаг 2: Автоматическая настройка (два диалога)

После компиляции автоматически появляются два диалога:

Диалог 1: «OpenMon — Install Dependencies»

PackageDependencyInstaller обнаруживает отсутствующие пакеты UPM и предлагает установить их:

Пакет	Назначение
com.unity.cinemachine	Система боевой камеры
com.unity.2d.tilemap.extras	SiblingTile, RuleTile, автотайлы
com.unity.2d.sprite	Инструменты редактора спрайтов (Importer)
com.unity.render-pipelines.universal	URP (обычно уже есть)
com.unity.inputsystem	Обработка ввода (обычно уже есть)
com.unity.visualeffectgraph	Погода, пыль при подъёме и боевые эффекты (все .vfx движка и демо)

Нажмите «Install All». Unity установит пакеты и перекомпилирует проект.

После установки пакетов TMP Essential Resources (шрифты, шейдеры, спрайты) автоматически импортируются из com.unity.ugui.

Как это работает

Установщик использует [InitializeOnLoad] в изолированной сборке (OpenMon.Setup) без внешних ссылок. Своё состояние он хранит в файле внутри Library/ (для проекта, а не глобально). Если вы пропустили диалог, используйте Tools > MCE > Setup > Re-check Package Dependencies, чтобы повторить попытку.

Диалог 2: OpenMon Hub — Setup Status

Откройте Hub через Tools > MCE > OpenMon Hub (или Ctrl+Shift+H). На вкладке Welcome показан индикатор состояния настройки ЗЕЛЁНЫЙ/КРАСНЫЙ.

Две кнопки под строкой состояния выбирают режим, а синяя — это режим, в котором вы находитесь: выше проект в режиме Offline. Нажатие другой переключает режим: меняет define скриптинга, регистрирует сцены, нужные этому режиму, направляет конфигурацию в нужное место и засевает данные. Остальные вкладки описаны в OpenMon Hub.

Если КРАСНЫЙ, нажмите «Run Full Setup», который запускает ProjectQuickSetup:

Настройка	Что делает
Custom Layers	Создаёт BattleElement (6), Camera (7), EvolutionStage (8), MapScreen (9)
Render Pipeline	Задаёт MCERenderPipelineAsset (2D Renderer) для всех уровней качества
Build Settings	Добавляет обнаруженные сцены проекта/системы, если они есть; ни одна редакция не содержит сцен демо (демо загружаются отдельно)
Player Settings	Задаёт название компании, название продукта, разрешение
TMP Essentials	Импортирует ресурсы TextMeshPro, если их ещё нет

Когда все проверки пройдены, индикатор становится ЗЕЛЁНЫМ.

Ручной перезапуск: Tools > MCE > Setup > Run Full Quick Setup

Шаг 3: Запуск

Ни одна редакция не содержит демо-проекта: демо загружаются отдельно (полная MIT Licensed Demo для Indie и всех редакций выше, а для Starter — собственное демо из 77 видов). Продолжите с Ваш первый монстр и Ваше первое сражение, чтобы создать контент и нажать Play.

Включённые физические плагины

MCE физически включает собственные плагины в Assets/Plugins/ (не через UPM):

Плагин	Путь	Почему физически?
NovaInspector	Assets/Plugins/NovaInspector/	.unitypackage не может включать пакеты UPM. Без него более 100 файлов не компилируются.
NovaMotion	Assets/Plugins/NovaMotion/	Слой анимации (твининга) за OpenMon.Foundation.Tweening.
Zenject (Extenject)	Assets/Plugins/MCELibs/	Фреймворк внедрения зависимостей, используемый во всём движке. Включён как предкомпилированные DLL.

NovaInspector уже поставляется с MCE

NovaInspector — собственный слой инспектора движка: производная работа с новой лицензией, распространяемая исключительно как часть MCE на условиях Assets/Plugins/NovaInspector/LICENSE.md. Его нет в Package Manager, и там он не нужен, поэтому установка отдельного пакета инспектора рядом с ним излишня.

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

Assets/
  OpenMon/
    Core/
      Runtime/           # Core engine (battles, monsters, world, saves, UI)
      Editor/            # Editor tools, Hub, Command Palette, Map Editor
      Art/               # Included art assets
      RPSettings/        # URP 2D Renderer configuration
    Foundation/          # Shared framework (DI, audio, localization, toolbar)
    Online/              # Nakama multiplayer layer (Pro, Source and Studio)
    Importer/            # Pokemon Essentials import pipeline (Indie and above)
    Setup/               # PackageDependencyInstaller + ProjectQuickSetup
  Plugins/
    MCELibs/             # Zenject, ExtendedEditor
    NovaInspector/       # Inspector attributes (physical, not UPM)
    NovaMotion/          # Tweening layer (physical, not UPM)
  Resources/             # Runtime-loaded assets (ProjectContext, singletons)

Проверка установки

1. Откройте Hub: Tools > MCE > OpenMon Hub (Ctrl+Shift+H).
2. Продолжите с Ваш первый монстр и Ваше первое сражение, чтобы создать контент для собственной сцены.
3. Запустите валидатор: откройте OpenMon Hub (Tools > MCE > OpenMon Hub) → вкладка Database → Validate Database — 0 ошибок, 0 предупреждений.

Устранение неполадок

Проблема	Решение
Диалог «Install Dependencies» не появился	Tools > MCE > Setup > Re-check Package Dependencies
Hub показывает КРАСНОЕ состояние настройки	Нажмите кнопку «Run Full Setup»
Ошибки атрибутов инспектора (GroupAttribute не найден)	Атрибуты находятся в Assets/Plugins/NovaInspector/ — проверьте, что эта папка попала в проект при импорте
Боевые спрайты невидимы	Убедитесь, что установлен com.unity.2d.sprite (установщик должен справиться с этим)
Отсутствует слой тайлсета	Запустите Tools > MCE > Setup > Configure Layers
Текст TMP не отображается	Запустите Tools > MCE > Setup > Run Full Quick Setup, чтобы импортировать TMP Essentials
Ошибки Cinemachine	Запустите Tools > MCE > Setup > Re-check Package Dependencies

Горячие клавиши

Действие	Сочетание
OpenMon Hub	Ctrl+Shift+H
Command Palette	Ctrl+Shift+M
Map Editor: Карандаш	B
Map Editor: Ластик	E