msw-combat-system — Claude Code skill: what it does, how to install
Reference guide for the 2D combat pipeline in MSW. Helps implement attack collision, damage calculation, hit reactions, and monster AI.
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-combat-system -a claude-codeWhat msw-combat-system does
This skill supplies the native API surface for MapleStory Worlds 2D combat built on mlua. It details the interaction between AttackComponent and HitComponent, handling Box, Circle, and Polygon hitboxes. It covers damage resolution hooks like CalcDamage and CalcCritical, along with camera shake, knockback, and sprite flash.
Monster logic integrates StateComponent finite state machines and AIComponent behavior trees. Certain mechanics like piercing strikes and hit count limits lack native engine support. You must track them manually inside custom script tables.
Never append @ExecSpace annotations when overriding IsAttackTarget or IsHitTarget. Doing so triggers runtime error LEA-3014 SignatureMismatch because the parent method leaves the execution space unspecified.
What it helps with
- resolve melee and ranged attacks with AttackComponent shapes
- hook custom damage formulas into CalcDamage and CalcCritical
- build monster decision trees with AIComponent and FSM states
- trigger hit stop, screen shake, and hit effects natively
Example prompts for the agent
- How do I set up a BoxShape melee strike using AttackComponent in MSW?
- Show how to override IsAttackTarget without triggering LEA-3014
- Explain the setup for an AIComponent behavior tree in MSW
How to install msw-combat-system
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-combat-system -a claude-code2Manually: put the files in place
~/.claude/skills/msw-combat-system/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/msw-combat-system/
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-combat-system -a codex2Manually: put the files in place
.agents/skills/msw-combat-system/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-combat-system -a cursor2Manually: put the files in place
.cursor/skills/msw-combat-system/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MSW-Git/msw-ai-coding-plugins-official msw-combat-system2Manually: put the files in place
.github/skills/msw-combat-system/SKILL.md1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-combat-system -a gemini-cli2Platform CLI
gemini skills install https://github.com/MSW-Git/msw-ai-coding-plugins-official --path plugins/msw-maker-base-skill/skills/msw-combat-systemManually: put the files in place
.devin/skills/msw-combat-system/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-combat-system -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about msw-combat-system
How to install msw-combat-system in Claude Code?
Run npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-combat-system -a claude-code.
What does msw-combat-system do?
It provides API reference rules for MSW combat mechanics. The guide details attack resolution, collision groups, damage hooks, hit feedback, and enemy AI.
Does MSW natively handle projectile pierce and hit limits?
No. Multi-target hit caps and piercing mechanics are not supported natively and require script-level entity caching.