完整版BedrockWiki镜像！

docs/wiki/json-ui/aseprite-animations.md

@@ -0,0 +1,64 @@
+---
+title: 序列帧动画
+category: 巧思案例
+mentions:
+    - TheDataLioness
+    - shanewolf38
+    - TheItsNameless
+    - LeGend077
+    - stirante
+---
+
+# 序列帧动画（Aseprite）
+
+<!--@include: @/wiki/bedrock-wiki-mirror.md-->
+
+## Aseprite简介
+
+[Aseprite](https://www.aseprite.org/) 是一款付费像素艺术软件，专门用于轻松创建皮肤和资源包。它提供丰富的工具、详尽的文档和教程，适合不同水平的艺术家使用。
+
+[LibreSprite](https://libresprite.github.io/) 是Aseprite的免费开源替代品。它基于Aseprite最后一个开源许可版本进行分支开发，本教程中的操作同样适用于LibreSprite。
+
+## 在Aseprite中创建动画
+
+假设你有一组按数字1到5顺序命名的"frameimage"系列帧图像。导入第一张图像后，Aseprite会自动识别同名但编号不同的其他图片，将它们按正确顺序排列并创建动画。
+
+<FolderView
+:paths="[
+    'frameimage1.png',
+    'frameimage2.png',
+    'frameimage3.png',
+    'frameimage4.png',
+    'frameimage5.png'
+]"
+></FolderView>
+
+使用`箭头键`在帧间导航，`Enter键`控制动画的播放/暂停。按下`Tab键`可打开时间轴选择单帧，右键点击时间轴上的帧可设置各种参数。
+
+通过快捷键`Ctrl + E`或菜单`文件 -> 导出到精灵表`进行导出操作。在输出设置中选择输出文件和JSON数据格式，出现包含哈希（Hash）和数组（Array）两种选项的下拉菜单时，请确保选择数组（Array）模式，否则会导致异常。
+
+最终将生成两个文件：SpriteSheet图像和JSON文件。请确保这两个文件主文件名相同且扩展名不同。
+
+## 在JSON-UI中使用Aseprite动画
+
+`aseprite_flip_book`动画类型专用于`image`类型元素的`uv`属性配置。
+
+::: code-group
+```json [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`字段应设置为单帧的宽高尺寸。