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-pet-structure.md

View on GitHub
---
name: maple-pet-structure
description: |
  Pet file structure, animation states, frame fields (origin, lt/rb, delay, z, zigzag),
  interaction system (food, interact, slang), and info metadata.
  Use when rendering pets or implementing pet interaction logic.
---

# Pet Structure

## File Path

`Item/Pet/{petID}.json` (7-digit ID, e.g. `5000000.json`)

474 pet files in data. No link system — each pet file is self-contained.

## Name & Dialogue

- Name: `String/Pet.json` -> key `"{petID}"` -> `{ "name": "Brown Kitty", "desc": "..." }`
- Dialogue: `String/PetDialog.json` -> key `"{petID}"`

## Top-Level Keys

| Key | Type | Description |
|-----|------|-------------|
| `{stateName}` | object | Animation state (stand0, move, jump, etc.) |
| `info` | object | Pet metadata (see Info Fields) |
| `food` | object | Feeding reactions by closeness tier |
| `interact` | object | Command interactions with success/fail |
| `slang` | object | Idle monologue triggers |

## Animation States

### Core States (all 474 pets)

| State | Description | Typical frames |
|-------|-------------|---------------|
| stand0 | Primary idle | 3–6 |
| stand1 | Secondary idle (e.g. tail wag) | 4–9 |
| move | Walking | 3–4 |
| jump | Jumping (hold frame) | 1 |
| fly | Flying | 1–2 |
| hang | Hanging from rope/ladder | 1 |
| hungry | Hungry expression | 3–4 |

### Common Emotion States (400+ pets)

| State | Pets | Description |
|-------|------|-------------|
| rest0 | 454 | Resting |
| chat | 451 | Chatting |
| eat | 448 | Eating |
| cry | 446 | Crying |
| angry | 442 | Angry |
| dung | 438 | Defecating |
| love | 430 | Love expression |
| sleep | 429 | Sleeping |
| sit | 365 | Sitting |
| roll | 206 | Rolling |
| what | 171 | Confused |
| no | 154 | Refusing |

115 unique state names exist across all pets. States beyond the core 7 vary per pet — enumerate keys at runtime.

### TransformAction

Some pets (e.g. Demon Lux 5001000) have a `TransformAction` key containing a full alternate state set (stand0, move, jump, fly, hang, etc.). This represents the pet's transformed appearance. Each sub-state has the same frame structure as top-level states.

## Frame Structure

```json
{
  "_path": "Item/Pet/5000000/stand0/0.png",
  "origin": { "x": 19, "y": 39 },
  "lt": { "x": -19, "y": -39 },
  "rb": { "x": 19, "y": 0 },
  "delay": 1200
}
```

`z` field is optional (absent on ~6300 frames, present on ~37200 frames).

| Field | Description |
|-------|-------------|
| `_path` | PNG path relative to data/ root |
| `origin` | Anchor point (from image top-left). y = ground contact point |
| `lt` | Bounding box left-top (relative to origin, negative = left/up) |
| `rb` | Bounding box right-bottom (relative to origin, positive = right, y=0 = origin height) |
| `delay` | Frame duration in ms. **Default 180ms** when absent |
| `z` | (optional) Rendering depth. Numeric (not string like Character). 0 = default (36645/37215 frames). z=2 used in ~568 frames |

### Single-Frame States

States like `jump` and `hang` have 1 frame with no `delay` field. Hold the frame for the duration of the state (controlled by game logic, not animation timing).

## Zigzag (Palindrome Playback)

Per-state flag, not per-pet. Check `{state}.zigzag` field:

- `zigzag: 1` on a state -> play frames as palindrome: 0, 1, 2, 1, 0, 1, 2, ...
  (first and last frames are not duplicated at the turn)
- Only 6 states across all pets use zigzag (4x rest0, 2x cry)
- `manifest/pets.json` has a pet-level `zigzag: true` flag that indicates "this pet has at least one zigzag state" — it is an index hint, not a rendering directive

## Flip Rule

Same as Mob/Character: sprites face **left by default**. Flip horizontally when facing right. When flipped: `anchorX = width - origin.x`.

## Info Fields

| Field | Count | Description |
|-------|-------|-------------|
| `cash` | 474 | Cash item flag (always 1) |
| `hungry` | 474 | Hunger rate tier |
| `icon` | 474 | Inventory icon (has _path, origin) |
| `iconD` | 474 | Disabled icon |
| `iconRaw` | 474 | Raw icon |
| `iconRawD` | 474 | Raw disabled icon |
| `life` | 474 | Life duration (0 = permanent) |
| `chatBalloon` | 455 | Chat balloon style |
| `nameTag` | 455 | Name tag style |
| `multiPet` | 469 | Multi-pet summon allowed |
| `noHungry` | 472 | Disable hunger |
| `msnGrade` | 472 | Mission grade |
| `nomiraclepet` | 472 | Miracle pet exclusion flag |

## Interaction System

### food — Feeding Reactions

Indexed by closeness tier (`l0`–`l1` range):

```
food["0"] = { l0: 1, l1: 9, success: { "0": { act: "rest0", "0": "f1_s" } }, fail: { "0": { act: "cry", "0": "f1_f" } } }
```

- `l0`/`l1`: closeness range for this tier
- `success`/`fail`: reaction variants. Each has `act` (animation state to play) and numbered dialogue keys (reference PetDialog.json)

### interact — Command Interactions

```
interact["0"] = { command: "c1", l0: 1, l1: 9, prob: 30, inc: 1,
                  success: { "0": { act: "rest0", "0": "c1_s1", "1": "c1_s2" } },
                  fail: { "0": { act: "stand1", "0": "c1_f1", "1": "c1_f2" } } }
```

- `command`: command ID (c1–c28)
- `prob`: success probability (%)
- `inc`: closeness increment on success
- `l0`/`l1`: closeness range
- `success`/`fail`: same structure as food

### slang — Idle Monologue

```
slang["0"] = { act: "rest0", l0: 1, l1: 9, "0": "s1" }
```

- `act`: animation state to play
- `l0`/`l1`: closeness range
- Numbered keys: dialogue references
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: 472kUpdated 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