PlugWiki

MSW Combat System skill for Claude Code: attack, hit, damage and AI with MSW native APIs

A MapleStory Worlds skill that makes Claude build combat from MSW's native attack, hit, damage skin and AI components.

Installs
10.2K
on skills.sh
Stars
38
on GitHub
Files
3
besides SKILL.md
Updated
Oct 2026
last repo commit

msw-combat-system gives Claude the full flow of 2D combat in MapleStory Worlds, using only native APIs: AttackComponent and HitComponent, damage hooks, knockback, hit stop, camera shake, death and revive, damage skins and hit effects. A coverage table says which layers are native and which need custom code.

The skill folder has three references: an HP gauge, projectiles and behaviour-tree AI. It also reads msw-general's monster guide, so install that too.

Good for

  • MapleStory Worlds creators building monsters, bosses or player attacks
  • Developers who want hit effects, knockback, damage numbers and HP bars
  • Teams building monster AI with state machines or behaviour trees

Install msw-combat-system

Claude Code

  1. 1

    Copy this prompt.

    Install the msw-combat-system skill in Claude Code. Run this command:

npx skills add https://github.com/msw-git/msw-ai-coding-plugins-official --skill msw-combat-system --skill msw-general --skill msw-scripting --skill msw-defaultplayer

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The plugin route installs msw-maker-base-skill: 13 skills (counted from the git tree) and hooks (6 hook events backed by 12 Node scripts, per hooks.json and the git tree). Read the permissions section first. The skills CLI route copies only the skill folders named, without the hooks. SKILL.md for msw-general says every other MSW skill depends on it, so it is always in the list, plus msw-scripting, msw-defaultplayer which this skill sends you to. The skills also call two MCP servers, msw-maker-mcp and msw-mcp. SKILL.md points to the official setup page for wiring them and the API key: https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1368 The default shown is the skills CLI route, which does not add the hooks.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

MSW combat system integration guide. Covers the Attack→Hit pipeline, damage model, i-frame, knockback, Hit Stop, Camera Shake, Sprite Flash, SFX, death/revive, damage skin, hit effect, avatar combat motion, custom events, and AI FSM — all based on MSW native APIs for 2D multi-genre coverage. Keywords: attack, hit, damage, combat, monster, hit effect, critical, projectile, damage skin, knockback, hit stop, combo, HP bar, collision, contact hit, TriggerComponent.

Sections in SKILL.md

  1. 0. Coverage matrix
  2. 0.5 References — where to go
  3. 1. Attack Resolution
  4. 1-1. Shape & Attack trigger
  5. 1-2. Target filter
  6. 1-3. attackInfo tagging
  7. 1-4. ⚠️ IsLegacy
  8. 1-5. Shape mapping per attack form
  9. 1-6. Continuous movement — common rules for projectiles, monsters, and AI
  10. 1-7. Collision-based hit — pick the detection method (do not hand-roll distance)
  11. 2. Damage Model
  12. 2-1. HitEvent payload
  13. 2-2. AttackEvent payload
  14. 2-3. ⚠️ Antipattern: direct HP subtraction — do not bypass HitEvent
  15. 3. Hit Reaction
  16. 3-1. Knockback — API per Body

Key facts

Author
MSW-Git, the marketplace owner in marketplace.json; the README calls the repo the public release source for MSW maker skills
License
No LICENSE file in the repo and none in the plugin manifests; GitHub shows no license
Installs on skills.sh
10,199 as of Nov 2, 2026
GitHub stars
38 for the msw-ai-coding-plugins-official repo, Nov 2, 2026
What is inside
4 files including SKILL.md: references/ai-bt.md, hp-gauge.md and projectile.md (git tree)
Part of
The msw-maker-base-skill plugin, which holds 13 skills (git tree)
Works with
Reads msw-general's monster.md; points to msw-scripting and msw-defaultplayer
Last commit to the repo
Oct 6, 2026
Needs
A MapleStory Worlds local workspace, Node.js for the bundled scripts, and the Maker MCP servers set up as described in the official docs

What it includes

  • Native versus custom for 10 combat layers

    Seven layers plus damage skin, hit effect and avatar motion. Custom code is needed for things like status effects, aggro and combo windows.

    Read · Coverage matrix

  • AttackComponent, HitComponent and shapes

    Covers triggers, target filters, attackInfo tags, the IsLegacy setting and collision-based hits.

    Try: “Add a sword attack with knockback and damage numbers.”

    Write · Attack resolution

  • CalcDamage hooks, HitEvent and AttackEvent

    SKILL.md calls direct HP subtraction an antipattern that bypasses HitEvent.

    Write · Damage model

  • Knockback, i-frames, hit stop, shake, flash

    Six game-feel effects are native. Status effects need custom code.

    Write · Hit reaction and game feel

  • StateComponent, DeadEvent, ReviveEvent, event bus

    Players use PlayerComponent HP; monsters use a custom synced HP property.

    Write · Death, revive and events

  • State machine, behaviour tree and Pattern A scripts

    References/ai-bt.md covers AIComponent, four native composites and custom nodes.

    Write · AI

  • DamageSkin components and HitEffectSpawnerComponent

    Auto mode uses components; manual mode uses DamageSkinService. Includes recipes for crits, heals and multi-hit.

    Write · Damage skin and hit effect

  • 9 checks before you call combat done

    Covers models, HitComponent setup, state motions, HP handling, direction, time source, event clean-up and the Body rule.

    Read · Combat checklist

From the official docs

Permissions

Medium risk

This skill writes combat scripts and models in your MapleStory Worlds workspace, and the plugin route adds hooks. Use version control and read the hook findings before installing the plugin.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It writes combat scripts and models

    It creates and edits scripts and models in your workspace. Review each change in version control. github.com

  • The plugin runs 9 hook scripts on 6 events

    hooks.json registers 9 hook scripts on 6 events. SessionStart: mlua-session-start.cjs starts the mlua LSP daemon in the background when it finds a RootDesk folder, and inject-agents-md.cjs (next item). UserPromptSubmit: skill-router-reminder.cjs adds the same fixed routing reminder to every prompt. PreToolUse: skill-read-guard.cjs refuses Bash reads such as cat, head or grep on the plugin's skill .md files, and structured-file-guard.cjs refuses reads, edits and shell commands on .model and .ui files. PostToolUse on Edit, Write and MultiEdit: mlua-diagnose-post-tool-use.cjs runs the mlua checker on edited .mlua files and returns a block decision with the errors when it finds any, and a second hook calls the msw-maker-mcp tool maker_refresh_workspace. PostToolUse on Read and Skill, and the InstructionsLoaded event: skill-log.cjs logs skill reads to .mswai/logs/skill.log. PostToolUse on every tool: mcp-log.cjs (below). SessionEnd: mlua-session-end.cjs stops the LSP daemon. Use the skills CLI route in the install box if you do not want hooks. github.com

  • The plugin writes AGENTS.md and edits CLAUDE.md

    inject-agents-md.cjs copies its AGENTS.md to your project root, replacing the file if the content differs, and adds an @AGENTS.md line at the top of CLAUDE.md. Back up an existing AGENTS.md first. github.com

  • The plugin runs a downloaded package with npx -y

    The mlua checks start a background daemon at session start and run again after each .mlua edit. resolve-cmd.cjs looks first for a local copy (env override, the workspace .mswai/runtime folder, the ai-cli vendored copy, mlua-lsp on PATH). If none is found and npx exists, it runs npx -y @maplestoryworlds/mlua-lsp@1.1.4, which downloads that package from the npm registry. github.com

  • The plugin logs every MCP call to .mswai/logs

    mcp-log.cjs runs after every tool call and, for MCP tools from any server, appends one line to .mswai/logs/mcp.log in your project with the tool name, the full arguments and the full response (cut only if MCP_LOG_MAX_OUTPUT_BYTES is set). lsp.log and skill.log are written to the same folder. Our advice: add .mswai/ to .gitignore, because the log can hold anything your MCP servers return. github.com

  • The plugin blocks direct reads of .model and .ui files

    structured-file-guard.cjs refuses Read, Edit, Write and shell commands on .model and .ui files and tells Claude to use the builders. Setting MSW_STRUCTURED_FILE_GUARD_DISABLE=1 turns it off. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlySKILL.md names no read-only setting.
Scopes

  • Writes .mlua combat scripts and edits .model files through builders

  • Calls Maker MCP refresh and play tools when testing

Questions

What does the msw-combat-system skill do?

It makes Claude build combat in MapleStory Worlds from native components: attacks, hits, damage, knockback, effects, death, damage numbers and AI.

What does it need installed with it?

msw-general, because it reads that skill's monster guide and builders, and msw-scripting and msw-defaultplayer, which it points to for scripts and the player. The skills CLI route in the install box includes them.

Does it cover every combat feature?

No. Its coverage table and Custom implementation section list what needs your own code, such as buffs and debuffs, aggro tables, projectile pooling, combo windows and guard or parry.

How do I install it?

Use the install box above. The plugin route installs all 13 skills in msw-maker-base-skill plus hooks.

Is it official, made by Nexon?

The repo does not say so. It is published by a personal GitHub account named MSW-Git (account type User, no company or description on the profile). The repo name contains "official" and the README calls it the public release source for MSW maker skills, but nothing in the repo names Nexon as the publisher. marketplace.json lists the owner as MSW-Git with an outlook.kr email address. The skills do link to Nexon's MapleStory Worlds creators docs for MCP setup. Our advice: treat it as a third-party toolkit for Nexon's platform unless Nexon confirms otherwise.

Do I need the MapleStory Worlds MCP servers?

The skills call two MCP servers, msw-maker-mcp for the Maker editor and msw-mcp for search and assets. SKILL.md says to point you to the official setup page when an MCP call fails or an API key is needed: https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1368.

Is msw-combat-system safe to use?

It lets Claude write combat scripts and edit .model files in your workspace. The plugin route also adds hooks, so read the permissions section before you install it. Our advice: use version control.

Information

updated Nov 2, 2026

Repository
msw-git/msw-ai-coding-plugins-official
Folder
plugins/msw-maker-base-skill/skills/msw-combat-system

msw-git/msw-ai-coding-plugins-officialskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 15
  1. msw-ai-coding-plugins-official README · github.com
  2. marketplace.json · github.com
  3. msw-combat-system SKILL.md · github.com
  4. skills.sh listing · skills.sh
  5. MSW-Git GitHub profile · github.com
  6. hooks.json · github.com
  7. inject-agents-md.cjs · github.com
  8. resolve-cmd.cjs · github.com
  9. mcp-log.cjs · github.com
  10. structured-file-guard.cjs · github.com
  11. skill-router-reminder.cjs · github.com
  12. mlua-diagnose-post-tool-use.cjs · github.com
  13. skill-log.cjs · github.com
  14. skill-read-guard.cjs · github.com
  15. mlua-session-start.cjs · github.com

Updated Nov 2, 2026.