用途:该技能面向《冒险岛》素材相关的开发工作,用于查询、组合和渲染角色、怪物、地图、技能、物品以及精灵图,需通过 maple-lookup MCP 进行。
主要能力:加载 references/ 目录下的冒险岛数据参考库,提供素材结构与组合方式的知识,涵盖精灵图渲染、插槽(socket)装配,以及怪物、NPC、技能、地图等数据结构。资源图包含入口索引 maple-data-reference.md,以及核心渲染、文件夹指南、ID 体系、物品、角色渲染、技能系统、变形、坐骑、安装物、地图、反应堆、NPC、宠物、怪物、首领(19 位)等结构文件。
使用方式:始终先读取入口 references/maple-data-reference.md,它提供 Quick Rules(ID 公式、绘制公式、插槽公式)与 Reference Map,用于定位各领域对应的资源文件。随后按需加载,只读取与当前任务相关的文件;当任务跨多领域时,先扫描各资源文件的 frontmatter 描述再选择完整加载。应用时用于从 ID 解析素材路径、按原点绘制与翻转规则定位、装配角色插槽链、解析怪物/技能/地图 JSON 结构,以及通过 maple-core-rendering.md 集成 Phaser 3。
关键规则:绘制位置 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/ 之外的文件获取数据结构知识;不要一次性加载全部资源文件,应按需加载。