Aseprite 与 Godot 4 集成教程（原生支持）

一、Godot 4 原生支持

Godot 4.0+ 内置了 Aseprite 文件导入支持，无需安装任何插件。直接将 .ase/.aseprite 文件放入项目目录即可。这比 Unity 的导入流程更简单。

二、导入设置

在 FileSystem 面板中选中 .aseprite 文件，在 Import 面板中配置：

• Import As：选择 "Sprite2D" 或 "AnimatedSprite2D"
• Trim：裁剪透明边缘（建议开启）
• Filter：纹理过滤，像素画选 Nearest（最近邻）
• Animation > FPS：动画帧率，建议 12
• Loop：是否循环播放

点击 "Reimport" 应用设置。

三、使用 AnimatedSprite2D

1. 在场景中添加 AnimatedSprite2D 节点
2. 在 Inspector 中，Sprite Frames 属性选择导入的 Aseprite 资源
3. 帧标签自动成为动画名称（idle、walk、attack 等）
4. 在 Animation 下拉框中选择要播放的动画
5. 勾选 Autoplay 可在场景启动时自动播放

四、代码控制动画

extends AnimatedSprite2D

func _ready():
    play("idle")

func _process(delta):
    if Input.is_action_pressed("ui_right"):
        play("walk")
        flip_h = false
    elif Input.is_action_pressed("ui_left"):
        play("walk")
        flip_h = true
    else:
        play("idle")

五、使用 PNG + JSON 方式

如果你不想直接导入 .aseprite 文件：

1. 在 Aseprite 中导出 Sprite Sheet（PNG + JSON）
2. 在 Godot 中安装 "Aseprite Wizard" 插件（AssetLib 搜索）
3. 通过插件导入 PNG + JSON，自动生成 SpriteFrames 资源

动画制作见帧动画教程，瓦片地图见Tilemap 制作教程。