msw-avatar

Manage avatar costumes and animations in MapleStory Worlds workspace files.

33|2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: msw-avatar
Source: https://github.com/MSW-Git/msw-ai-coding-plugins-official/tree/main/plugins/msw-maker-base-skill/skills/msw-avatar
Command: npx skills add https://github.com/MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides comprehensive management and customization of avatars in MapleStory Worlds (MSW), allowing for detailed costume and animation adjustments.

Core Features & Use Cases

  • Costume Management: Customize appearance with 17 equip slots for costumes, including body, hair, face, and accessories.
  • Animation Customization: Control the 3-layer animation pipeline for state-based and action-specific animations.
  • Use Case: For a game developer, this Skill can be used to create unique character designs and animations for MSW.

Quick Start

To apply a new costume to the default player, use the command: msw-avatar set_costume "CustomBodyEquip" "new_body_ruid".

Frequently Asked Questions about msw-avatar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize MapleStory Worlds avatars with different costumes and animations?

To customize MapleStory Worlds avatars, you modify appearance and animations using the costume manager and avatar state animation components. You edit workspace files directly and use the msw-maker-mcp refresh tool to apply changes to entities.

How does the 3-layer animation pipeline work for MapleStory Worlds characters?

The 3-layer animation pipeline in MapleStory Worlds controls state-based and action-specific character animations. It applies to NPC, monster, and player entities through the avatar state animation component, enabling layered animation blending.

Can I use the msw-avatar skill to customize NPC and monster entities?

Yes, the msw-avatar skill supports avatar appearance and animation customization for NPC, monster, and player entities. You apply costumes and animations across all three entity types within the MapleStory Worlds environment.

What is the best way to apply a new costume to a player character in MapleStory Worlds?

The best way to apply a new costume is using the `msw-avatar set_costume` command. You provide the equip slot name and the new resource UID, such as `set_costume "CustomBodyEquip" "new_body_ruid"`.

Why are my MapleStory Worlds avatar costume changes not showing up in the game?

Costume and animation changes require a refresh to take effect. After editing workspace files to adjust avatar appearance, you must run the msw-maker-mcp refresh tool to synchronize and apply the updates to the game environment.