Aseprite 与 Unity 2D 集成：官方 Importer 使用教程

一、环境要求

• Unity 2021.3.15f1 或更高版本
• 2D 项目模板（URP 或内置管线均可）
• 安装 2D Animation 和 2D PSD Importer 包

二、安装 Aseprite Importer

1. 打开 Unity，Window → Package Manager
2. 左上角下拉选择 "Unity Registry"
3. 搜索 "2D Aseprite Importer"，点击 Install
4. 等待安装完成，可能需要重启 Unity

三、导入 .aseprite 文件

1. 将 Aseprite 保存的 .ase/.aseprite 文件直接拖入 Unity Project 窗口
2. 选中文件，在 Inspector 中查看导入设置
3. 关键设置：
   • Pixels Per Unit：每单位像素数，16/32/64 根据你的像素大小设定
   • Generate Animation Clips：勾选，自动生成动画片段
   • Generate Physics Shape：勾选，自动生成碰撞形状
   • Import Mode：Animated Sprite（动画精灵）
   • Canvas Size：保持原始画布大小
4. 点击 Apply 应用设置

四、自动生成的内容

导入后，Unity 会自动生成：

• 精灵图集（Sprite Sheet）
• 每个帧标签对应的 Animation Clip（.anim 文件）
• Animator Controller（动画控制器）
• 预制体（Prefab），包含 SpriteRenderer 和 Animator

五、在场景中使用

1. 将生成的预制体拖入场景
2. 它已自带 Animator 组件，默认播放第一个动画片段
3. 在脚本中通过 animator.Play("walk") 切换动画
4. 使用 animator.SetBool("isRunning", true) 配合状态机参数控制

六、常见问题

导入后图片模糊？ 选中精灵，Filter Mode 设为 Point（no filter），Compression 设为 None。

动画没有自动切片？ 确保 .aseprite 文件中使用了帧标签（Tag），且 Generate Animation Clips 已勾选。

图层没有分开？ Aseprite Importer 默认合并图层。如需骨骼动画，需使用 2D Animation 包配合 PSD Importer。

导出设置详见Sprite Sheet 导出教程。使用 Godot 引擎？看Godot 4 集成教程。制作瓦片地图见Tilemap 地图制作教程。