PlugWiki

MSW DefaultPlayer skill for Claude Code: change movement, jump, HP and camera

A MapleStory Worlds skill that makes Claude change the DefaultPlayer model: speed, jump, HP, camera and components.

Installs
10.2K
on skills.sh
Stars
38
on GitHub
Updated
Oct 2026
last repo commit

msw-defaultplayer teaches Claude how the default player is built: Player.model as the base and DefaultPlayer.model as the override, both in ./Global. Claude patches them through the ModelBuilder in msw-general, never by hand-editing JSON. It can change property values, add or remove components and set camera options.

It covers the movement component for each map mode and says to start poses through StateComponent. New custom scripts go under RootDesk/MyDesk. Costumes belong to msw-avatar.

Good for

  • MapleStory Worlds creators tuning player speed, jump force, HP or camera
  • Developers adding a custom script component to the player
  • Anyone hiding or reworking the default player character

Install msw-defaultplayer

Claude Code

  1. 1

    Copy this prompt.

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

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

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 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 DefaultPlayer (character) management. Use the msw-general ModelBuilder to inspect/patch DefaultPlayer.model and Player.model, add/remove components, configure movement speed / jump force / HP / camera, and per-map-mode movement components. Use for DefaultPlayer model, player components, movement speed, jump force, HP, camera, physics. Keywords: player, DefaultPlayer, speed, jump, HP, camera, gravity, revive, respawn, character.

Sections in SKILL.md

  1. DefaultPlayer overview
  2. What is DefaultPlayer?
  3. File location and structure
  4. DefaultPlayer is patched through ModelBuilder
  5. File structure detail
  6. Player.model (base)
  7. DefaultPlayer.model (override)
  8. DefaultPlayer default component list
  9. Quick reference — key components
  10. DefaultPlayer Values structure
  11. TargetType rules
  12. Model properties (TargetType: null)
  13. Direct component override (TargetType: specific component)
  14. Movement components per map mode
  15. Identifying a player (for script reference)
  16. Player entity runtime structure (root vs children)

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,226 as of Nov 2, 2026
GitHub stars
38 for the msw-ai-coding-plugins-official repo, Nov 2, 2026
What is inside
1 file: SKILL.md (git tree)
Part of
The msw-maker-base-skill plugin, which holds 13 skills (git tree)
Works with
Uses the ModelBuilder in msw-general; points to msw-avatar for costumes and msw-scripting for custom scripts
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

  • Player.model base and DefaultPlayer.model override

    Both files live in ./Global. The model ID comes from the PlayerUri property of DefaultUserEnterLeaveLogic.

    Read · DefaultPlayer structure

  • read, value(), component(), write

    Claude loads DefaultPlayer.model, sets values with an explicit type key, adds or removes components, then writes the file and asks for a Maker refresh.

    Try: “Make my player 20 percent faster and give it more HP.”

    Write · Patch with ModelBuilder

  • Model properties versus direct component overrides

    If both a model property and a component override exist, Claude must set both. jumpForce and speed need extra care.

    Write · Values and TargetType rules

  • Picks the body component for the map type

    The active movement component differs between MapleTile, RectTile and SideViewRectTile maps.

    Read · Movement components per map mode

  • Starts poses through the state machine

    SKILL.md says never to write the pose selector directly on a player-shaped entity.

    Write · Avatar poses via StateComponent

  • Disables components with Enable=false values

    A keep or disable table says which components to turn off, applied with a builder edit.

    Write · Hide DefaultPlayer

  • Basic properties, custom script, camera

    Three recipes. The camera one sets dead zone, soft zone, damping, screen, dutch and offset values.

    Write · Workflows

  • What is in and out of scope

    Costumes go to msw-avatar, UI to .ui files, map edits to .map files. New files in ./Global are not recommended.

    Read · Boundaries

From the official docs

Permissions

Medium risk

This skill edits the player model that every user in your world uses, and the plugin route adds hooks. Commit before each change 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 changes the model every player uses

    Edits to DefaultPlayer.model affect every user who enters your world. Test in a copy of the workspace first. 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

  • Edits ./Global/Player.model and ./Global/DefaultPlayer.model through ModelBuilder

  • Creates custom scripts under RootDesk/MyDesk when you ask for one

Questions

What does the msw-defaultplayer skill do?

It makes Claude change the default player model in a MapleStory Worlds project: movement speed, jump force, HP, camera, components and hiding the character.

Does it edit JSON by hand?

No. SKILL.md says to patch Player.model and DefaultPlayer.model through the ModelBuilder script in msw-general, and the plugin hooks block direct .model reads and writes.

What other skills does it need?

msw-general for the ModelBuilder, and msw-scripting when you add a custom script to the player. Costume changes are in msw-avatar. The skills CLI route in the install box includes the first two.

How do I install it?

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

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-defaultplayer safe to use?

It edits files in ./Global that every player in your world uses. The plugin route also adds hooks, so read the permissions section before you install it. Our advice: commit before each change so you can revert the model.

Information

updated Nov 2, 2026

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

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-defaultplayer 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.