Skip to main content
skill CX Codex

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.

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

What 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-code

2Manually: put the files in place

~/.claude/skills/msw-combat-system/SKILL.md

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

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.

Similar skills

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

From the same set14

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-search Search MSW API references and guides, or look up sprites, animations, sounds, resource packs, and avatars. Use it when .d.mlua lacks the detail you need or you need an RUID. 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-general Foundation skill for MapleStory Worlds work: shared tools, platform rules and validated .model templates. Every other MSW skill builds on it. 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

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