games-creater/cocos-extension/安装说明.md

Anim Studio 导入器 · Cocos 扩展安装说明（3.8.5 / 3.8.6）

装一次，以后在编辑器菜单点两下就能把素材导进任意工程并布置好演示场景，不用再手动拖文件。

一、安装扩展（只做一次）

把 anim-studio-importer 这个文件夹放进 Cocos 的扩展目录，二选一：

• 只给当前项目用：放到 你的Cocos项目/extensions/ 下（没有 extensions 文件夹就新建一个）。
• 所有项目通用：放到全局扩展目录
  • Windows：C:\Users\你的用户名\.CocosCreator\extensions\
  • macOS：~/.CocosCreator/extensions/

放好后，在 Cocos 顶部菜单 扩展（Extension）→ 扩展管理器 里找到「anim-studio-importer」，确认是启用状态（第一次可能要点一下启用 / 刷新）。

本扩展用纯 JS 写的，不需要编译；放进去启用即可。

二、怎么用（每次导入素材时）

1. 先在 Anim Studio 网站点 📦 导出 Cocos 整合包，得到 out/<game>/cocos-pack/。
2. 打开你的 Cocos 工程，顶部菜单 扩展 → Anim Studio → 「1. 导入 cocos-pack 资源」。
3. 在弹出的文件框里选中那个 cocos-pack 文件夹，确定。等右下角导入进度条走完。
4. 新建或打开一个场景（资源管理器右键 → 新建 Scene，双击打开；保证场景里有 Canvas）。
5. 再点 扩展 → Anim Studio → 「2. 在当前场景布置演示节点」。
6. 按 Ctrl/Cmd + S 保存场景，点正上方 ▶ 播放：角色排队果冻抖动，按钮触发 WIN 和粒子特效。

三、菜单点不动 / 没反应？

• 扩展刚放进去要去「扩展管理器」启用或点刷新；个别情况重启一次编辑器。
• 「布置演示节点」必须先打开一个场景才能用；没开场景会提示手动兜底步骤。
• 如果第 5 步报「脚本还没导入完」，多等一会让资源导入跑完再点。

四、自动布置失败时的手动兜底（很简单）

新建/打开场景 → 在 Canvas 下右键「创建空节点」→ 把 assets/scripts/JellyDemo.ts 拖到该节点的属性检查器上 → 保存、播放。效果完全一样。