If you're building anything in MapleStory Worlds, read this first. It enforces a core principle: MSW isn't about prototypes, it's about polished games, so every entity needs proper sprites, animations, and sounds applied via the search skill. The real value is the workflow discipline it hammers in: never start models from scratch (use the validated template catalog), always use builders instead of hand-editing files, and if an entity appears twice or more in a map, author a model first and place instances rather than copying inline components. The preflight rules are strict (read entity.md before touching entities, read builder-protocol.md before any file writes) but they exist because the three builders are interlocked and skipping documentation breaks the component sync contracts.

skills.sh installs
10.7K
GitHub stars
38
last updated
Aug 21, 2026

Install

$ npx -y skills add msw-git/msw-ai-coding-plugins-official --skill msw-general --agent claude-code

Installs into .claude/skills of the current project.

Files

MSW General — Foundation Skill

The foundation skill for MSW (MapleStory Worlds) creation, integrating shared tools, domain knowledge, platform rules, and file authoring. Every other MSW skill depends on it.


Core Principle: Visual Polish

MSW is a game creation platform. The goal is not a prototype where logic merely runs — it is a polished game players can enjoy.

So whatever entity you create — monster, NPC, tower, item, background object — search for and apply appropriate resources (sprites, animations, sounds) that match its role and personality. Do not leave the default sprite in place or leave SpriteRUID empty.

Resource application principle when creating an entity:

  1. After creating the entity, use the msw-search skill to find sprites/animations that fit it
  2. Apply the RUID of the found resource to SpriteRendererComponent so the entity is visually represented
  3. If there is combat, also set hit/explosion effects; if there is interaction, set sound effects

Functionality implemented != finished. A polished game requires appropriate resources plus visual presentation.


When making a .model — catalog first

Sponsors

Details

Repository
github.com/msw-git/msw-ai-coding-plugins-official
Categories
Git & Pull Requests, AI & Agent Building
First seen
Jun 3, 2026

More from msw-git/msw-ai-coding-plugins-official

All 12
1msw-git avatarmsw-scriptingmsw-git/msw-ai-coding-plugins-officialAuthoring MSW scripts (.mlua) plus integrated playtest and debugging. Covers mlua syntax, annotations (@Component/@Logic/@ExecSpace/@Sync), lifecycle, exec spac10.7Kskills.sh installs
2msw-git avatarmsw-defaultplayermsw-git/msw-ai-coding-plugins-officialMSW DefaultPlayer (character) management. Use the msw-general ModelBuilder to inspect/patch DefaultPlayer.model and Player.model, add/remove components, configu10.7Kskills.sh installs
3msw-git avatarmsw-searchmsw-git/msw-ai-coding-plugins-officialMSW search integration — (1) vector search for API docs and implementation guides via the msw-mcp MCP server (mlua_api_retriever / mlua_document_retriever), (2)10.7Kskills.sh installs
4msw-git avatarmsw-avatarmsw-git/msw-ai-coding-plugins-officialMSW avatar management — costume (CostumeManagerComponent, 17 slots) + animation 3-layer pipeline (StateComponent → AvatarStateAnimationComponent → AvatarRendere10.6Kskills.sh installs
5msw-git avatarmsw-combat-systemmsw-git/msw-ai-coding-plugins-officialMSW combat system integration guide. Covers the Attack→Hit pipeline, damage model, i-frame, knockback, Hit Stop, Camera Shake, Sprite Flash, SFX, death/revive, 10.6Kskills.sh installs
6msw-git avatarmsw-paintermsw-git/msw-ai-coding-plugins-officialWhen msw-search cannot find a suitable sprite RUID, draw a pixel art sprite directly with SVG / HTML5 Canvas / HTML code, render it to PNG, and upload it via th10.6Kskills.sh installs