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.

Обзор проекта

l2-unity-client - Unity-клиент для playable demo Lineage 2. Базовая цель проекта: запустить ограниченный, но проверяемый игровой цикл с логином, выбором/созданием персонажа, входом в MVP-зону, движением, таргетом, боем, базовыми предметами, UI и сетевым взаимодействием.

Основные области

Область	Смысл
Unity client	Сцены, UI, персонажи, движение, камера, эффекты, аудио, сборки.
Server/client flow	Login/game server, пакеты, синхронизация, состояние персонажа, NPC/monster runtime.
Game data	Карты, geodata, spawn, NPC, monsters, skills, items, icons, effects.
Assets	Модели, анимации, материалы, prefabs, VFX, FMOD/audio.
QA and release	Smoke checks, missing references, build profile, regression checklist.

MVP-формула

MVP считается полезным, когда игрок может:

• запустить клиент и подключиться к серверу;
• выбрать или создать разрешенного персонажа;
• войти в ограниченную MVP-зону;
• видеть других игроков и базовых NPC/монстров;
• двигаться, таргетить и атаковать;
• получать и использовать базовые предметы;
• пользоваться минимальным UI без критических ошибок;
• пройти smoke-проверку без Unity Editor как обязательного условия.

Не-MVP объем

Следующие темы не должны блокировать первый рабочий срез, если они явно скрыты или отложены:

• полный список рас, классов и архетипов;
• все зоны мира;
• все skills/items/NPC из исходных данных;
• квесты, кланы, экономика, олимпиада, manor;
• полная визуальная полировка всех ассетов.

Источники в репозитории

• README.md - исходное описание проекта и базовый запуск.
• MVP_GOALS_AND_ISSUES_PLAN_2026-06-30.md - MVP-цели и нарезка задач.
• FULL_RELEASE_PLAN_2026-07-01.md - релизная дорожная карта.
• FULL_GAME_TASK_CATALOG_INDEX_2026-07-01.md - индекс generated task catalog.
• GITWORK_IMPORT_REPORT_2026-07-01.md - отчет об импорте задач в GitWork.

---

Назначение проекта

Цель проекта l2-unity - получить playable Lineage 2 style Unity-клиент с базовым MMO loop: вход, выбор/создание персонажа, загрузка мира, перемещение, target, бой, NPC/monster interaction, inventory, skills, UI и серверная синхронизация.

Исходный README описывает проект как basic playable demo Lineage 2 on Unity. Сейчас проект уже содержит больше, чем простой прототип: Unity-клиент, локальные серверные проекты, импортированные world/map assets, персонажи, NPC/monster prefabs, UI scripts/assets, preview build pipeline и generated catalogs из original/client/server data.

MVP

MVP должен быть не полным клоном оригинала, а проверяемым вертикальным срезом:

• игрок входит через login/game server или через preview/offline режим для локальной проверки;
• выбирает или создает персонажа из ограниченного набора готовых visual archetypes;
• попадает в выбранную игровую зону;
• перемещается мышью/WASD;
• видит HUD, nameplates, target, chat, inventory, skillbar;
• выбирает монстра/NPC;
• атакует, получает серверный или preview result;
• получает loot/item update;
• может выйти и зайти снова без потери базового состояния.

Направление к production

Production-ready игра требует закрыть не только код, но и объектные каталоги:

• все playable visual archetypes должны иметь понятный статус;
• все original map cells должны быть описаны или исключены с причиной;
• NPC/monster/service catalog должен иметь mapping на server template и Unity visual;
• item catalog должен иметь правила inventory/equip/use/drop/trade/destroy;
• skill catalog должен иметь статус по каждому skill id;
• network packets должны иметь проверенный end-to-end flow;
• UI должен закрывать нормальные, пустые, ошибочные и disabled states;
• Wiki должна быть актуальной после каждой задачи.

Что не считать готовностью

Наличие файла в проекте не означает production readiness.

Примеры:

• raw character prefab без Player/User/Pawn runtime path не готов как playable character;
• NPC id без server template/Unity visual/spawn usage не готов как NPC;
• skill id без server formula, icon, effect token, animation и UI feedback не готов как skill;
• scene без проверки colliders/geodata/spawns/performance не готова как игровая map cell;
• UI script без data source, error states и resolution check не готов как production UI.

Текущие ключевые масштабы

Область	Объем
playable visual archetypes	14
runtime monster prefabs	16
runtime NPC prefabs	24
original map cells	168
scene triage rows	167
skill id rows	8264
skill effect tokens	2216
skill icon tokens	2077
NPC catalog rows	7494
item catalog rows	14823
spawn rows	38995
spawn regions	1742
network packet rows	68
UI audit rows	112