Skip to main content
skill CX Codex

msw-general — Claude Code skill: MapleStory Worlds foundation

Foundation skill for MapleStory Worlds work: shared tools, platform rules and validated .model templates. Every other MSW skill builds on it.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a claude-code
Open on GitHub

What msw-general does

This skill sets the shared groundwork for MapleStory Worlds: how to find resources, how to author .model and .map files, which platform rules to follow. Other MSW skills reference it, so it comes first.

Inside is a catalog of validated .model templates grouped by category: monsters, NPCs, player, terrain, map objects, particles, sound, tile maps, UI. Starting a new .model from an empty file is discouraged — pick the closest template, swap the three identifiers (EntryKey, Id, Name) through ModelBuilder, then adjust components. Save into a typed subfolder of RootDesk/MyDesk/Models/, for example Models/Monsters/{Name}.model, then refresh.

There is a separate rule for repeated objects: if the same entity shows up in a map twice or more, author a .model and place instances by modelId instead of copy-pasting @components. One edit in the model updates every instance, and the .map stays readable. Dynamic spawning through SpawnByModelId needs a model regardless of count. Before touching entities the skill requires reading references/entity.md; before editing .map, .model or .ui it requires the builder protocol.

What it helps with

  • build a monster or NPC .model from a ready template
  • place five identical trees via modelId instead of copy-paste
  • match a sprite and animation to an entity's role
  • wire hit effects and interaction sounds
  • keep model and map instances from drifting apart

Example prompts for the agent

  • read msw-general and build a .model for a chasing monster
  • use msw-general to place 10 trees via modelId in this map
  • check with msw-general that every entity has SpriteRUID set

How to install msw-general

1Skills CLI (Vercel)

npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a claude-code

2Manually: put the files in place

~/.claude/skills/msw-general/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/msw-general/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about msw-general

How do I install msw-general in Claude?

Run npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a claude-code. The skill lands at ~/.claude/skills/msw-general/SKILL.md.

What does msw-general do?

It provides the shared layer for MapleStory Worlds work: a catalog of .model templates, rules for placing entities, and the reading order for reference docs. Other MSW skills depend on it.

When do I need a model instead of inline components?

A one-off entity in a single map can use inline components. At two or more instances the skill requires a .model with modelId instances.

Similar skills

Everything for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set10

msw-avatar A skill for MSW avatars: 17 equipment slots, mapping animation states onto sprite clips, and custom actions such as shoot or dance. CX Codex +1 9,800installs msw-combat-system Reference guide for the 2D combat pipeline in MSW. Helps implement attack collision, damage calculation, hit reactions, and monster AI. CX Codex +1 9,800installs msw-defaultplayer A skill for editing the DefaultPlayer model in MapleStory Worlds Maker: run speed, jump force, HP, camera and physics, all through ModelBuilder. Handy when the character needs tuning. CX Codex +1 9,800installs msw-scripting Guides authoring .mlua scripts for MapleStory Worlds, covering annotations, execution spaces, and playtesting. Useful when building MSW logic and debugging runtime issues. CX Codex +1 9,900installs msw-painter Draws a pixel-art sprite when msw-search finds no suitable RUID, then helps register the PNG as a resource. CX Codex +1 9,700installs msw-behaviourtree Builds MSW .behaviourtree files and refreshes a project-specific node spec. Use it to define a behaviour graph with Blackboard variables and node properties. CX Codex +1 9,600installs msw-sprite-ruid Rules for assigning RUID to SpriteRendererComponent.SpriteRUID and SpriteGUIRendererComponent.ImageRUID, plus the thumbnail:// prefix for icons. CX Codex +1 9,700installs msw-ui-system Guides coding agents through building MapleStory Worlds interfaces: generates .ui layouts, configures UI components, and handles .mlua UUID bindings. CX Codex +1 9,700installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor