社区脚本精选｜上千个现成脚本，拿来即用

Aseprite 社区脚本资源

Aseprite 社区已经积累了上千个 Lua 脚本——覆盖导出、调色板、瓦片、自动化、UI 增强等各种场景。主要资源：

怎么安装别人写的脚本

方式一：脚本文件夹

1. 打开 Aseprite → File → Preferences → Scripts
2. 找到脚本文件夹路径（Windows 通常是 C:\Users\<你>\AppData\Roaming\Aseprite\scripts）
3. 把下载的 .lua 文件复制进去
4. 重启 Aseprite，脚本自动出现在 File → Scripts 菜单里

方式二：直接运行

下载 .lua 文件后，在 Aseprite 里 File → Scripts → Open Script → 选择文件 → 运行。

方式三：命令行运行

aseprite -b --script downloaded-script.lua target.ase

精选实用脚本

1. Export By Group——按图层组分别导出 PNG

功能：把每个图层组导出成独立的 PNG 文件（自动创建文件夹结构）。

用途：角色设计时想把"身体"、"头部"、"武器"分别导出做配件系统；或者关卡里每个 tile 单独导出。

地址：community.aseprite.org

2. Palette Swap——一键换色

功能：输入新调色板文件（.gpl / .aseprite_palette / .png），自动把当前 sprite 的颜色替换成新调色板。

用途：你有一套角色想用 10 种配色风格，不用手动改 10 次调色板——导入 10 个调色板文件、跑 10 次脚本，搞定。

3. Tilemap JSON Export——瓦片地图导出

功能：把 Aseprite Tilemap Layer 导出成游戏引擎可用的 JSON 格式（含瓦片 ID、位置、碰撞数据等）。

用途：用 Aseprite 画瓦片地图 → 直接导出给 Godot / Tiled 用。

4. RotSprite Tool——像素完美旋转

功能：比 Aseprite 内置旋转工具更精确的像素完美旋转算法——旋转时尽量保持像素边界清晰，减少锯齿。

用途：需要旋转小尺寸 sprite 时（比如 8×8 的图标），内置旋转工具容易出现锯齿。

5. Auto Slice——自动切片

功能：根据颜色差异自动把 sprite 切成多个部分（适合角色身体部位分离）。

用途：做可定制角色（衣服、头盔、武器可以单独换）时，自动把不同颜色区域切成独立 PNG。

写自己的脚本：5 分钟起步

最简单的入门脚本——输出当前画布信息：

-- my-first-script.lua
local sprite = app.activeSprite
if sprite then
  app.alert("当前画布: " .. sprite.width .. "x" .. sprite.height .. "px\n" ..
           "图层数: " .. #sprite.layers .. "\n" ..
           "帧数: " .. #sprite.frames)
else
  app.alert("没有打开的画布")
end

这个脚本在 Run Command（Ctrl+Space）窗口里直接输入就能跑——弹窗显示当前画布的尺寸、图层数、帧数。

写脚本的纪律

• 先 GUI 后 Batch：脚本先在界面里测试正确，再丢进 -b 命令行模式
• 出错就 alert：脚本里关键节点加 app.alert("xx: " .. 值)，方便调试
• 检查 nil：app.activeSprite 可能为 nil（没有打开任何文件时），脚本要处理这种情况
• Lua 语法注意：-- 是注释、~= 是不等于、不要用 !=