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	Reactor 精灵图结构
maple-npc-structure.md	NPC 精灵图结构
maple-pet-structure.md	宠物精灵图结构
maple-mob-structure.md	Mob 精灵图与属性结构
maple-mob-boss-{name}-structure.md	每个 Boss 的精灵图与攻击结构（19 个 Boss）

工作流

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
Boss	maple-mob-boss-{name}-structure.md
ID 解析	maple-core-id-system.md、maple-core-id-reference.md

当任务明显涉及多个领域时，先浏览所有资源文件的 frontmatter 描述，再选择要完整加载的文件。

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 基础地址	https://resource-static.msu.io/data/

约束

• 不要硬编码资源路径——始终根据资源文件和 ID 公式推导
• 编写任何绘制/翻转/插槽代码时，绝不能跳过 maple-core-rendering.md
• 不要引用 references/ 之外的文件来了解数据结构
• 不要一次性加载所有资源文件——根据任务按需加载