Skip to content

NEXPACE-Limited/msu-skills / plugins/msu/skills/maple-make

maple-make

Verified

Use when working with MapleStory assets — how to look up, compose, and render characters, mobs, maps, skills, items, or sprites via maple-lookup MCP.

FileKindSize
SKILL.mdskill md5.3 KB
references/maple-character-install-structure.mdmarkdown4.2 KB
references/maple-character-morph-structure.mdmarkdown4.0 KB
references/maple-character-rendering.mdmarkdown17.8 KB
references/maple-character-skill-reference.mdmarkdown7.1 KB
references/maple-character-skill-system.mdmarkdown4.1 KB
references/maple-character-tamingmob-structure.mdmarkdown9.7 KB
references/maple-core-folder-guide.mdmarkdown10.4 KB
references/maple-core-id-reference.mdmarkdown5.6 KB
references/maple-core-id-system.mdmarkdown2.7 KB
references/maple-core-items-reference.mdmarkdown4.4 KB
references/maple-core-items.mdmarkdown3.4 KB
references/maple-core-rendering.mdmarkdown10.6 KB
references/maple-data-reference.mdmarkdown10.0 KB
references/maple-field-map.mdmarkdown15.7 KB
references/maple-field-reactor-structure.mdmarkdown6.2 KB
references/maple-mob-boss-arkarium-structure.mdmarkdown2.4 KB
references/maple-mob-boss-balrog-structure.mdmarkdown6.9 KB
references/maple-mob-boss-blackmage-structure.mdmarkdown8.5 KB
references/maple-mob-boss-cygnus-structure.mdmarkdown6.2 KB
references/maple-mob-boss-damien-structure.mdmarkdown12.1 KB
references/maple-mob-boss-darknell-structure.mdmarkdown7.5 KB
references/maple-mob-boss-gas-structure.mdmarkdown2.1 KB
references/maple-mob-boss-gloom-structure.mdmarkdown2.4 KB
references/maple-mob-boss-hilla-structure.mdmarkdown4.3 KB
references/maple-mob-boss-horntail-structure.mdmarkdown11.4 KB
references/maple-mob-boss-lotus-structure.mdmarkdown12.8 KB
references/maple-mob-boss-lucid-structure.mdmarkdown16.2 KB
references/maple-mob-boss-magnus-structure.mdmarkdown1.0 KB
references/maple-mob-boss-papulatus-structure.mdmarkdown3.2 KB
references/maple-mob-boss-pinkbean-structure.mdmarkdown10.3 KB
references/maple-mob-boss-seren-structure.mdmarkdown4.1 KB
references/maple-mob-boss-verushilla-structure.mdmarkdown4.7 KB
references/maple-mob-boss-vonleon-structure.mdmarkdown4.4 KB
references/maple-mob-boss-will-structure.mdmarkdown3.3 KB
references/maple-mob-structure.mdmarkdown13.1 KB
references/maple-npc-structure.mdmarkdown6.8 KB
references/maple-pet-structure.mdmarkdown5.3 KB

references/maple-character-install-structure.md

View on GitHub
---
name: maple-character-install-structure
description: |
  Install item (chair/furniture) file structure, effect animation layers, bodyRelMove seat positioning,
  group chair multi-seat layout, TamingMob link, and rendering z-order.
  Use when rendering chairs or implementing chair-sitting logic.
---

# Install Item Structure

## File Path

`Item/Install/{prefix}.json` where prefix = first 4–6 digits of 8-digit zero-padded item ID.

Examples:
- 3010205 → `Item/Install/03010.json` → key `"03010205"`
- 3016200 → `Item/Install/03016.json` → key `"03016200"`

3679 items across 31 JSON files. No link system.

## Name Lookup

`String/Ins.json` → key `"{itemID}"` → `{ "name": "...", "desc": "..." }`

## Top-Level Keys

| Key | Always | Description |
|-----|--------|-------------|
| `effect` | yes | Main visual animation layer |
| `info` | yes | Metadata: bodyRelMove, group, icon, recovery |
| `effect2` | 331 items | Secondary effect layer (front layer) |

## Effect Layer

```json
"effect": {
  "0": { "_path": "...effect/0.png", "delay": 300, "origin": {"x":107,"y":108}, "z": 0 },
  "1": { "_path": "...effect/1.png", ... },
  "z": -1
}
```

| Field | Description |
|-------|-------------|
| `"0"`, `"1"`, ... | Animation frames (1–32 observed) |
| `z` | Layer-level z-order: negative = behind character, positive = in front |
| Frame `_path` | PNG path relative to data/ root |
| Frame `origin` | Anchor point (same convention as character/mob) |
| Frame `delay` | Frame duration in ms. Default 60ms when absent |
| Frame `z` | Per-frame z within the layer (usually 0) |

### Effect2 Layer

Same frame structure as `effect`. Typically `effect2.z` is positive (e.g. 3), placing it in front of the character.

Rendering order: `effect` (z=-1, behind) → character → `effect2` (z=3, in front).

## Seat Positioning — bodyRelMove

`info.bodyRelMove` = offset from the effect origin to the character's **navel** position.

```json
"bodyRelMove": { "x": 0, "y": -14 }
```

- y is typically negative (character sits above the effect origin)
- Offset is flipped when character faces right
- 474 items have this field

## Character Direction While Sitting

### Single-seat chairs

| Field | Value | Meaning |
|-------|-------|---------|
| `info.sitLeft` | 1 | Force character to face left |
| `info.sitRight` | 1 | Force character to face right |
| (neither) | - | Default direction |

### Group chairs (per-seat)

`info.group.sit.{N}.dir`:

| Value | Meaning |
|-------|---------|
| -1 (default) | Normal direction |
| 0 | Force face right |
| 1 | Force face left |

## Group Chair (Multi-Seat)

```json
"info": {
  "group": {
    "info": { "height": 400, "width": 265, "invite": 1, "randomSit": 1 },
    "sit": {
      "0": { "bodyRelMove": {"x":25,"y":-258}, "dir": 1, "tamingMobF": "01983279", "tamingMobM": "01983279" },
      "1": { "bodyRelMove": {"x":-125,"y":-110}, "dir": 1, ... },
      ...
    }
  }
}
```

| Field | Description |
|-------|-------------|
| `group.info.width/height` | Group interaction area (px) |
| `group.info.invite` | Allow inviting others to sit |
| `group.info.randomSit` | Random seat assignment |
| `group.sit.{N}.bodyRelMove` | Per-seat navel offset |
| `group.sit.{N}.dir` | Per-seat forced direction (-1/0/1) |
| `group.sit.{N}.tamingMobF` | TamingMob ID for female character |
| `group.sit.{N}.tamingMobM` | TamingMob ID for male character |

When `group` exists, use `group.sit.{N}.bodyRelMove` instead of `info.bodyRelMove`.

## TamingMob Link

Some chairs use TamingMob sprites for the character's sitting animation body:

- Single seat: `info.tamingMob` = TamingMob ID
- Group seat: `group.sit.{N}.tamingMobF` / `tamingMobM` (gender-specific)

When `tamingMob` is present, load the TamingMob JSON for the character's riding/sitting body sprite. When absent, the character uses its default sit pose.

## Info Fields

| Field | Description |
|-------|-------------|
| `bodyRelMove` | Character navel offset (see above) |
| `sitLeft` / `sitRight` | Force sitting direction |
| `tamingMob` | TamingMob ID for riding sprite |
| `group` | Multi-seat layout |
| `icon` / `iconRaw` | Inventory icon sprites |
| `recoveryHP` / `recoveryMP` | HP/MP recovery while sitting |
| `price` | NPC sell price |
| `slotMax` | Max per inventory slot |
| `weapon` | Show weapon sprite while sitting |
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall