msw-avatar — скилл для Claude Code: костюмы и анимации MSW
Скилл для работы с аватаром в MSW: экипировка из 17 слотов, привязка состояний к спрайтовым клипам и свои действия вроде shoot или dance.
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-codeЧто делает msw-avatar
Скилл объясняет аватара в MSW по двум осям: внешность через CostumeManagerComponent и движение через AvatarStateAnimationComponent с AvatarRendererComponent. Правит он файлы рабочей области напрямую, а затем просит у сервера msw-maker-mcp вызвать refresh, чтобы редактор увидел изменения. Путь зависит от цели: ./Global/DefaultPlayer.model для игрока, блок в ./map/{mapName}.map для расставленного NPC или монстра, отдельный .model для сущности, привязанной только по modelId.
Внутри разобраны 17 строковых полей Custom*Equip и их соответствие перечислению MapleAvatarItemCategory, включая особенности вроде Longcoat, который занимает и верх, и низ. Сами RUID предметов скилл искать не даёт: их берут через msw-search, потому что придуманный идентификатор ни к чему не привяжется. Для слотов Custom*Equip нужен голый Guid: вариант с префиксом, например thumbnail://<ruid>, отбрасывается без ошибки, и слот остаётся пустым. Это стоит держать в голове, когда экипировка вдруг не появляется.
Для анимаций описана трёхуровневая цепочка и четыре разных вида ключа состояния: State, AvatarBodyActionStateName, enum MapleAvatarBodyActionState и идентификатор спрайтового действия вроде swingO1 или shoot1. Есть две системы маппинга через IsLegacy, ActionSheet и StateToAvatarBodyActionSheet.
Какие задачи решает
- выдать NPC костюм без правки кода на лету
- получить список надетых вещей игрока через
GetEquip - привязать своё действие к состоянию анимации
- заблокировать автопереход анимации у персонажа
- сделать отдельную анимацию атаки под конкретное оружие
Примеры запросов агенту
- Покажи, какие предметы надеты у этого NPC, и замени ему плащ на новый RUID из
msw-search - Сделай кастомное действие dance и привяжи его к состоянию через
StateToAvatarBodyActionSheet - Убери автопереход анимации у этого монстра, чтобы проигрывался только мой клип
Как установить msw-avatar
1Через Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-code2Вручную: положить файлы
~/.claude/skills/msw-avatar/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/msw-avatar/
1Через Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a codex2Вручную: положить файлы
.agents/skills/msw-avatar/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a cursor2Вручную: положить файлы
.cursor/skills/msw-avatar/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install MSW-Git/msw-ai-coding-plugins-official msw-avatar2Вручную: положить файлы
.github/skills/msw-avatar/SKILL.md1Через Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a gemini-cli2Командой платформы
gemini skills install https://github.com/MSW-Git/msw-ai-coding-plugins-official --path plugins/msw-maker-base-skill/skills/msw-avatarВручную: положить файлы
.devin/skills/msw-avatar/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о msw-avatar
Как установить msw-avatar в Claude Code?
Выполните npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-code. Файл скилла окажется по пути ~/.claude/skills/msw-avatar/SKILL.md.
Что делает msw-avatar?
Помогает агенту править костюм и анимации аватара в MSW: слоты экипировки, маппинг состояний на спрайтовые клипы, свои действия. После правки файлов скилл вызывает refresh у msw-maker-mcp.
Что нужно для работы скилла?
Подключённый MCP-сервер msw-maker-mcp для вызова refresh и поиск RUID через msw-search. RUID нельзя придумывать, а в поля Custom*Equip годится только чистый Guid без префиксов.