moonwell-client/client-export/README.md

PlayerGuide — клиентский пакет (3.3.5a / MoonWellClient)

Это материалы для интеграции вкладки «Путеводитель» в существующий ретропортированный Encounter Journal. Реализация соответствует требованиям из uploads/player-guide-requirements.md и опирается на канон-визуал WotLK (Friz Quadrata, тёмно-синий фон EJ, золотые акценты).

Структура

MoonWellClient/
├── EncounterJournal/
│   ├── Utils/
│   │   └── C_PlayerGuide.lua          ← хранилище + API
│   ├── Custom_EncounterJournal/
│   │   ├── Custom_EncounterJournal.xml ← патч: новая вкладка
│   │   ├── Custom_EncounterJournal.lua ← патч: routing вкладки
│   │   ├── PlayerGuide.xml            ← фреймы и шаблоны (НОВОЕ)
│   │   └── PlayerGuide.lua            ← рендер и логика (НОВОЕ)
│   └── Localization/
│       └── ruRU.lua                   ← патч: MW_PLAYER_GUIDE и др.
├── AIO/
│   └── MoonWellPlayerGuide.lua        ← AIO-handler (клиентская часть)
└── MoonWellClient.toc                 ← патч: подключение файлов

Порядок интеграции

1. Скопируйте новые файлы в проект:
   • client-export/PlayerGuide.xml → EncounterJournal/Custom_EncounterJournal/PlayerGuide.xml
   • client-export/PlayerGuide.lua → EncounterJournal/Custom_EncounterJournal/PlayerGuide.lua
   • client-export/C_PlayerGuide.lua → EncounterJournal/Utils/C_PlayerGuide.lua
   • client-export/MoonWellPlayerGuide.lua → AIO/MoonWellPlayerGuide.lua
2. Примените патчи из client-export/patches/ к существующим файлам (см. ниже — Custom_EncounterJournal.xml, Custom_EncounterJournal.lua, MoonWellClient.toc, Localization/ruRU.lua).
3. Перезагрузите интерфейс (/reload). Если AIO ещё не передал payload — увидите «пустое» состояние с кнопкой «Обновить».

Что вошло в MVP (по требованиям)

MVP-пункт	Где
вкладка Путеводитель	Custom_EncounterJournal.xml патч
пустой PlayerGuideFrame	PlayerGuide.xml
C_PlayerGuide.lua + статика	C_PlayerGuide.lua
заголовок этапа + цели	PlayerGuide.lua → PlayerGuide_Refresh
tab switching / hide-show	Custom_EncounterJournal.lua → EJ_ContentTab_OnClick хук
AIO SetData	MoonWellPlayerGuide.lua → handlers.SetData
Обновить (RequestRefresh)	PlayerGuide.lua → PlayerGuide_RefreshButton_OnClick

Что отложено (см. «Later UI» в требованиях)

• Фильтры (все / активные / завершённые)
• Pinning отслеживаемой цели
• Награды — блок временно отключён (SHOW_REWARDS = false)
• Серверные уведомления (Notify)

Сноска по визуалу

Текстуры в XML — это встроенные ресурсы 3.3.5a-клиента. Если у вас есть атлас MoonWell — замените пути в блоке -- TEXTURE_ATLAS на свои. Биом-обложки рекомендаций (Interface\AddOns\MoonWellClient\EncounterJournal\Textures\Biome-*) надо создать отдельно — это плейсхолдеры (см. таблицу в PlayerGuide.lua).