maple-make

maple-make スキル

references/ 配下の MapleStory データリファレンスライブラリを読み込み、MapleStory のアセットの構造と構成方法（スプライトの描画、ソケットの組み立て、mob／NPC／スキル／マップのデータ構造）に関する完全な知識を提供します。

エントリーポイント

必ず references/maple-data-reference.md から読み始めてください。各ドメインに対応するリソースファイルを示すインデックスです。エントリーポイントを確認せずに、リソースファイルを直接読み込まないでください。

リソースマップ

ファイル	説明
maple-data-reference.md	エントリーポイント — クイックルール、ID の式、リファレンスマップ
maple-core-rendering.md	CDN、反転ルール、描画式、Phaser との統合
maple-core-folder-guide.md	data/ ディレクトリの構造、ファイル命名規則
maple-core-id-system.md	ID からファイルを解決するルール
maple-core-id-reference.md	武器の種類、職業ツリー、身体パーツのスロット、スキルグレード
maple-core-items.md	アイテムの概要
maple-core-items-reference.md	アイテム ID リファレンス
maple-character-rendering.md	キャラクターのソケット組み立て（複数パーツの装備）
maple-character-skill-system.md	スキル定義、ダメージ計算式
maple-character-skill-reference.md	スキル ID リファレンス
maple-character-morph-structure.md	モーフスプライトの構造
maple-character-tamingmob-structure.md	TamingMob（騎乗動物）の構造
maple-character-install-structure.md	設置アイテムの構造
maple-field-map.md	マップの背景と足場の構造
maple-field-reactor-structure.md	リアクタースプライトの構造
maple-npc-structure.md	NPC スプライトの構造
maple-pet-structure.md	ペットスプライトの構造
maple-mob-structure.md	mob のスプライトとステータスの構造
maple-mob-boss-{name}-structure.md	ボスごとのスプライトと攻撃の構造（19 体のボス）

ワークフロー

1. エントリーポイントを読む

references/maple-data-reference.md

ここでは、クイックルールの表（ID の式、描画式、ソケットの式）と、各ドメインで読み込むリソースファイルを示すリファレンスマップを確認できます。

2. 必要に応じて読み込む

現在のタスクに関連するリソースファイルだけを読み込んでください。ファイルを選ぶ際は、maple-data-reference.md のリファレンスマップを使用します。

タスク	読み込むファイル
スプライトの描画全般	maple-core-rendering.md — すべてのエンティティタイプで必ず読み込む
装備中のキャラクター	maple-character-rendering.md
マップ／背景	maple-field-map.md、maple-core-folder-guide.md
mob	maple-mob-structure.md
NPC	maple-npc-structure.md
スキル	maple-character-skill-system.md
ボス	maple-mob-boss-{name}-structure.md
ID の解決	maple-core-id-system.md、maple-core-id-reference.md

タスクが明らかに複数のドメインにまたがる場合は、まずすべてのリソースファイルのフロントマターにある説明を確認してから、全文を読み込むファイルを選んでください。

3. ナレッジを適用する

読み込んだリファレンスを使用して、以下を行います。

• ID からアセットのファイルパスを解決する
• 原点に基づく描画位置と反転ルールを適用する
• キャラクターのソケットチェーンを組み立てる
• mob／skill／map の JSON 構造を解析する
• Phaser 3 と統合する（maple-core-rendering.md を参照）

主なルール（エントリーポイントより）

ルール	計算式
描画位置	draw_x = world_x - origin.x / draw_y = world_y - origin.y
反転時のアンカー	anchorX = flip ? (width - origin.x) : origin.x
ソケット（反転なし）	childOriginWorld = parentOriginWorld + parentSocket - childSocket
ソケット（反転あり）	childOriginWorld.x = parentOriginWorld.x - parentSocket.x + childSocket.x
スプライトの向き	すべてのスプライトはデフォルトで左を向きます。右を向かせるには明示的に反転します
CDN のベース URL	https://resource-static.msu.io/data/

制約

• アセットのパスをハードコードしないでください。必ずリソースファイルと ID の計算式から導き出してください
• 描画／反転／ソケットのコードを書く際は、maple-core-rendering.md を必ず参照してください
• データ構造に関する知識を得るために、references/ 以外のファイルを参照しないでください
• すべてのリソースファイルを一度に読み込まず、タスクに応じて必要なものだけを読み込んでください