# msw-avatar

Скилл для работы с аватаром в MSW: экипировка из 17 слотов, привязка состояний к спрайтовым клипам и свои действия вроде shoot или dance.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 9800 установок · ★ 38
- Автор: MSW-Git
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/MSW-Git/msw-ai-coding-plugins-official/tree/HEAD/plugins/msw-maker-base-skill/skills/msw-avatar/SKILL.md
- Обновлён: 2026-10-06
- HTML: https://affpapa.org/nevibecode/skills/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`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/msw-avatar/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/msw-avatar/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/msw-avatar/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/msw-avatar/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MSW-Git/msw-ai-coding-plugins-official msw-avatar
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/msw-avatar/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/MSW-Git/msw-ai-coding-plugins-official --path plugins/msw-maker-base-skill/skills/msw-avatar
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/msw-avatar/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/MSW-Git/msw-ai-coding-plugins-official/tree/HEAD/plugins/msw-maker-base-skill/skills/msw-avatar/SKILL.md

## Когда брать
- выдать NPC костюм без правки кода на лету
- получить список надетых вещей игрока через `GetEquip`
- привязать своё действие к состоянию анимации
- заблокировать автопереход анимации у персонажа
- сделать отдельную анимацию атаки под конкретное оружие

## Примеры запросов агенту
- Покажи, какие предметы надеты у этого NPC, и замени ему плащ на новый RUID из `msw-search`
- Сделай кастомное действие dance и привяжи его к состоянию через `StateToAvatarBodyActionSheet`
- Убери автопереход анимации у этого монстра, чтобы проигрывался только мой клип

## Похожие
- [orbit-card](https://affpapa.org/nevibecode/skills/orbit-card.md) — скилл · 10000 установок
- [cad](https://affpapa.org/nevibecode/skills/cad.md) — скилл · 14000 установок
- [step-parts](https://affpapa.org/nevibecode/skills/step-parts.md) — скилл · 11200 установок
- [sdf](https://affpapa.org/nevibecode/skills/sdf.md) — скилл · 10500 установок
- [urdf](https://affpapa.org/nevibecode/skills/urdf.md) — скилл · 10500 установок
- [hatch-pet](https://affpapa.org/nevibecode/skills/hatch-pet.md) — скилл · 3300 установок

Из того же набора: [msw-git/msw-ai-coding-plugins-official](https://affpapa.org/nevibecode/by/msw-git/msw-ai-coding-plugins-official.md) — 14 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md