1 Unity Setup
Roman edited this page 2026-07-01 12:38:14 +03:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Unity Setup

Страница фиксирует рабочие правила запуска и проверки Unity-проекта. Перед изменениями лучше сверять фактический активный Unity root, потому что в checkout есть несколько вложенных и архивных директорий.

Основные директории

Путь Назначение
l2-unity/ Основной Unity project root в текущем checkout.
l2-unity/Assets/ Сцены, prefabs, scripts, resources, UI, imported assets.
l2-unity/Packages/manifest.json Unity package dependencies.
servers/ Серверные компоненты/связанные материалы, если присутствуют в текущем checkout.
_local_unity_packages/ Локальные Unity/MCP packages и tooling.
l2-unity-fmod/ FMOD/audio-related workspace, если нужен звук.

Базовый запуск из README

  1. Открыть сцену Menu.
  2. Добавить l2_lobby сцены в сцену/настройки запуска.
  3. Убедиться, что build settings содержат Menu, L2_lobby, Game и нужные игровые сцены.
  4. Запустить loginserver и gameserver, если проверка требует сетевого цикла.

Что проверять перед gameplay-задачами

  • Unity открывает целевые сцены без критических import/compile ошибок.
  • В сценах нет новых missing references.
  • Resources paths соответствуют runtime-загрузке prefabs/data.
  • Build scene list соответствует проверяемому профилю, а не всему архивному миру.
  • Логи не содержат новых ошибок, которые блокируют smoke.

Правило для агентов

Если работа идет через Unity Editor, использовать MCP server Unity MCP, как указано в AGENTS.md. Не обращаться напрямую к внутреннему HTTP bridge, если доступен MCP-инструмент.

Минимальный smoke

  • открыть Unity project root;
  • проверить compile/import состояние;
  • открыть Menu/Game/MVP сцену;
  • запустить нужный server stack;
  • пройти логин/выбор персонажа/движение/таргет/бой в ограниченном сценарии;
  • сохранить результат проверки в issue, wiki или отчет, в зависимости от задачи.