序列帧动画（Aseprite）

本页面镜像自

BedrockWiki

根据原始项目协议授权。本文经过AI翻译处理，如有内容遗漏，可以提交PR进行补充。

Aseprite简介

Aseprite 是一款付费像素艺术软件，专门用于轻松创建皮肤和资源包。它提供丰富的工具、详尽的文档和教程，适合不同水平的艺术家使用。

LibreSprite 是Aseprite的免费开源替代品。它基于Aseprite最后一个开源许可版本进行分支开发，本教程中的操作同样适用于LibreSprite。

在Aseprite中创建动画

假设你有一组按数字1到5顺序命名的"frameimage"系列帧图像。导入第一张图像后，Aseprite会自动识别同名但编号不同的其他图片，将它们按正确顺序排列并创建动画。

🖼️frameimage1.png

🖼️frameimage2.png

🖼️frameimage3.png

🖼️frameimage4.png

🖼️frameimage5.png

使用箭头键在帧间导航，Enter键控制动画的播放/暂停。按下Tab键可打开时间轴选择单帧，右键点击时间轴上的帧可设置各种参数。

通过快捷键Ctrl + E或菜单文件 -> 导出到精灵表进行导出操作。在输出设置中选择输出文件和JSON数据格式，出现包含哈希（Hash）和数组（Array）两种选项的下拉菜单时，请确保选择数组（Array）模式，否则会导致异常。

最终将生成两个文件：SpriteSheet图像和JSON文件。请确保这两个文件主文件名相同且扩展名不同。

在JSON-UI中使用Aseprite动画

aseprite_flip_book动画类型专用于image类型元素的uv属性配置。

RP/ui/example_file.json

{
	"image_element": { // 此处为动画元素
		"type": "image",
		"texture": "textures/ui/my_sprite_file",
		"uv_size": [32, 32],
		"uv": "@example_namespace.image_uv_animation"
	},

	"image_uv_animation": { // 此处为动画控制参数
		"anim_type": "aseprite_flip_book",
		"initial_uv": [0, 0]
	}
}

将texture字段设置为导出文件的路径（不包含扩展名）。uv_size字段应设置为单帧的宽高尺寸。