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-клиента

Роль Unity-клиента

Unity-клиент отвечает за визуальное и интерактивное представление игры:

• загрузка menu/lobby/game scenes;
• player local representation;
• remote users/pawns;
• NPC/monster prefabs;
• movement/camera/input;
• UI Toolkit/UI scripts;
• audio/FMОD hooks;
• preview/offline build mode;
• network communication with login/game servers.

Сцены

В проекте есть основная Game scene и отдельная Game1 preview scene.

Game1 используется для development preview build и offline-проверок. По PREVIEW_BUILD_HANDOFF.md, preview pipeline:

• копирует Game.unity в Game1.unity;
• пересоздает EventSystem;
• удаляет проблемные/тяжелые элементы для preview;
• создает sanitized copies проблемных карт;
• исключает тяжелые NPC/monster resources;
• собирает Windows x86_64 Development build.

Wiki-страницы:

• Wiki/UnityClient/Scenes
• Wiki/UnityClient/PreviewBuild
• Wiki/Maps/Cells/*

Персонажи

В текущем аудите есть 14 visual archetypes:

• FDarkElf
• FDwarf
• FElf
• FFighter
• FMagic
• FOrc
• FShaman
• MDarkElf
• MDwarf
• MElf
• MFighter
• MMagic
• MOrc
• MShaman

FDarkElf и FDwarf отмечены как runtime-ready candidates. Их нужно описать как reference pattern:

• Player prefab;
• User prefab;
• Pawn prefab;
• AnimatorController/states;
• locomotion;
• attack/cast/hit/death;
• colliders;
• materials;
• face/hair;
• gear slots;
• weapon animation compatibility;
• local/remote representation;
• sounds.

Остальные raw-only archetypes должны собираться по этому pattern и оставаться скрытыми из production UI до готовности.

NPC и монстры

В Unity audit найдено:

• 16 runtime monster prefabs;
• 24 runtime NPC prefabs.

Каждый runtime prefab должен иметь Wiki-страницу с:

• asset path;
• prefab hierarchy;
• animator clips;
• materials;
• collider/click area;
• nameplate/target behavior;
• server NPC id binding;
• spawn usage;
• AI/service role;
• verification evidence.

UI

UI audit содержит 112 rows. Текущие группы:

• Game UI;
• Login/Character;
• Chat;
• Inventory;
• Nameplates;
• Skillbar;
• Quest;
• Skill learn;
• UI Toolkit assets.

Для production UI нужна не только загрузка prefab/UXML, но и состояния:

• normal;
• empty;
• loading;
• error;
• disabled;
• selected;
• hover/focus;
• network update;
• localization;
• resolution scaling.

Preview/offline режим

Preview build может работать без сервера. Это важно для проверки карты, персонажей и базового управления без полной серверной связки.

Wiki должна явно разделять:

• offline preview behavior;
• full client/server behavior;
• что проверено только в preview;
• что проверено end-to-end через server.