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-mob-boss-balrog-structure.md

View on GitHub
---
name: maple-mob-boss-balrog-structure
description: |
  Balrog multi-part boss rendering: 7 parts, HP-based phase transitions, z-order,
  and action mapping. Load when rendering Balrog (8830000–8830006).
---

# Balrog — Multi-Part Boss Rendering

Balrog is a **7-part composite boss**. Each part is an independent mob JSON with its own animation states and sprites. All parts share the same world anchor point and are drawn with their per-frame `origin` offsets.

## Parts

| Part ID   | Label      | Role                          |
|-----------|------------|-------------------------------|
| 8830000   | Body       | Torso + wings (always visible except Spirit phase) |
| 8830001   | LeftHand   | Left hand (alive)             |
| 8830002   | RightHand  | Right hand (alive)            |
| 8830003   | Spirit     | Full upper-body spirit form (invincibility phase) |
| 8830004   | LeftDead   | Left hand (sealed/dead)       |
| 8830005   | RightDead  | Right hand (sealed/dead)      |
| 8830006   | LeftDummy  | Left hand placeholder (identical sprites to LeftDead) |

All parts have `info.noFlip = 1` — **never flip horizontally**.

## Phase System

Balrog has HP-based phases that determine which parts are visible:

| Phase | HP Range   | Visible Parts                    | Description |
|-------|------------|----------------------------------|-------------|
| 1     | 100% → 75% | Body + LeftHand + RightHand     | Both hands alive |
| 2     | 75% → 50%  | Body + LeftDead + RightHand     | Left hand sealed |
| 3     | 75% → 50%  | Body + LeftHand + RightDead     | Right hand sealed |
| 4     | 50% → 0%   | Body + LeftDead + RightDead     | Both hands sealed |
| Spirit | Periodic  | Spirit (alone)                  | Invincibility — replaces all other parts |

> Phase 2 and 3 are alternative — which hand dies first depends on gameplay. For a viewer, offer both.

## Z-Order

Parts render at the **same world anchor** with different depth:

| Part(s)          | Depth   | Rule |
|------------------|---------|------|
| Body, Spirit     | Behind  | `z_base - 1` |
| LeftHand, RightHand, LeftDead, RightDead, LeftDummy | In front | `z_base` |

Hands render **in front of** the body. In Phaser: `body.setDepth(9)`, hands `.setDepth(10)`.

## Rendering

All parts share the same world position (anchor). Per-frame `origin` handles the relative offset:

```
// For each visible part:
draw_x = anchor_x - frame.origin.x
draw_y = anchor_y - frame.origin.y
```

Body and Spirit have large origins (~324, 560) placing them with feet at the anchor. Hands have smaller/negative origins positioning them relative to the body's shoulders.

### Example: Stand Frame 0 Origins

| Part       | origin.x | origin.y |
|------------|----------|----------|
| Body       | 324      | 560      |
| LeftHand   | 376      | 209      |
| RightHand  | -188     | 208      |
| Spirit     | 324      | 560      |
| LeftDead   | 441      | 193      |
| RightDead  | -128     | 191      |

> Every frame has its own `origin`. Do not cache or reuse across frames.

## Actions per Part

| Part       | Actions |
|------------|---------|
| Body       | stand(12), attack1(24), attack2(27), attack3(23), attack4(17), die1(60), hit1(1), skill1(23), skill16(9) |
| LeftHand   | stand(12), attack1(21), attack2(29), die1(28), hit1(1), skill1(37) |
| RightHand  | stand(12), attack1(21), attack2(24), attack3(19), die1(28), hit1(1) |
| Spirit     | stand(12), die1(1), hit1(1) ⚡effect-only (dummy sprite), skill1(24), skill16(23) |
| LeftDead   | stand(1), die1(1), hit1(1) |
| RightDead  | stand(1), die1(1), hit1(1) |
| LeftDummy  | stand(1), die1(22), hit1(1) |

Frame counts in parentheses. Number = number of animation frames.

### Action Fallback

Not all parts have every action. When playing an action:
1. If the part has the action → play it
2. If not → fallback to `stand`

Example: Playing `attack3` — Body and RightHand have it, but LeftHand does not → LeftHand stays on `stand`.

## Data Paths

CDN base: `https://resource-static.msu.io/data/`

| Resource | CDN Path (append to base) |
|----------|---------------------------|
| Body JSON | `Mob/8830000.json` |
| LeftHand JSON | `Mob/8830001.json` |
| RightHand JSON | `Mob/8830002.json` |
| Spirit JSON | `Mob/8830003.json` |
| LeftDead JSON | `Mob/8830004.json` |
| RightDead JSON | `Mob/8830005.json` |
| LeftDummy JSON | `Mob/8830006.json` |

PNG paths come from each frame's `_path` field (already CDN-relative):

```
Mob/8830000/stand/0.png   → Body stand frame 0
Mob/8830001/stand/0.png   → LeftHand stand frame 0
Mob/8830003/stand/0.png   → Spirit stand frame 0
```

Full URL: `CDN + frame._path`

## Quick Implementation

```js
const CDN = "https://resource-static.msu.io/data/";

// 1. Define parts and phases
const PARTS = [
  { id: '8830000', label: 'Body',      zOffset: -1 },
  { id: '8830001', label: 'LeftHand',   zOffset: 0 },
  { id: '8830002', label: 'RightHand',  zOffset: 0 },
  { id: '8830003', label: 'Spirit',     zOffset: -1 },
  { id: '8830004', label: 'LeftDead',   zOffset: 0 },
  { id: '8830005', label: 'RightDead',  zOffset: 0 },
  { id: '8830006', label: 'LeftDummy',  zOffset: 0 },
];

const PHASES = [
  { name: 'Phase 1', partLabels: ['Body', 'LeftHand', 'RightHand'] },
  { name: 'Phase 2', partLabels: ['Body', 'LeftDead', 'RightHand'] },
  { name: 'Phase 3', partLabels: ['Body', 'LeftHand', 'RightDead'] },
  { name: 'Phase 4', partLabels: ['Body', 'LeftDead', 'RightDead'] },
  { name: 'Spirit',  partLabels: ['Spirit'] },
];

// 2. Part JSONs — fetch each through maple-lookup and inline the result here.
//    Browser fetch() of CDN JSON is blocked (no CORS headers); PNGs still load via <img>.
const partJsons = { /* '8830000': { …get_sprite_data output… }, … */ };

// 3. Create animator per part
const animators = PARTS.map(part => ({
  label: part.label,
  zOffset: part.zOffset,
  json: partJsons[part.id],
  visible: false,
}));

// 4. Set phase → toggle visibility
function setPhase(phase) {
  animators.forEach(a => {
    a.visible = phase.partLabels.includes(a.label);
  });
}

// 5. Load PNG: CDN + frame._path
function loadImage(path) {
  const img = new Image();
  // No crossOrigin — the CDN sends no CORS headers, so 'anonymous' fails the load outright.
  // The canvas is tainted as a result: draw only, no getImageData()/toDataURL().
  img.src = CDN + path;
  return img;
}

// 6. Render: all visible parts at same anchor
function draw(anchorX, anchorY) {
  // Sort by zOffset (lower = behind)
  const sorted = animators.filter(a => a.visible).sort((a, b) => a.zOffset - b.zOffset);
  for (const a of sorted) {
    const frame = getCurrentFrame(a);
    const x = anchorX - frame.origin.x;
    const y = anchorY - frame.origin.y;
    ctx.drawImage(textures[frame._path], x, y);
  }
}
```

## Notes

- 8830007 exists in data but has **no actions** — ignore it.
- LeftDummy (8830006) has identical stand sprite to LeftDead (8830004). It is used as a placeholder during transition animations.
- Spirit has no `lt`/`rb` bounding box — it is invincible and has no hitbox.
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