SpineThumbnails 图标 SpineThumbnails v1.0.0
获取插件
Eagle 插件 · 自动资源配对

导入完成，
缩略图自动就位

SpineThumbnails 识别 Eagle 中导入的 Spine 骨骼、Atlas 与贴图， 自动跨 item 文件夹完成配对，再按你的设置生成静态 PNG 或动态 WebP 缩略图。 从版本识别到渲染、写入、进度反馈，一次完成。

前往插件页 了解工作流程 →
  • 9Spine 版本
    3.4 – 4.3
  • 2缩略图模式
    静态 / 动态
  • 8界面语言
    简繁英日韩俄西德
SpineThumbnails 插件主界面：自动生成开关、生成方式、策略、状态、统计与分类日志
SpineThumbnails 1.0.0 · 插件主界面
首次使用默认关闭自动生成，只有主动开启后才会处理新导入的素材。
  • json
  • skel
  • skel.bytes
  • atlas
  • atlas.txt
  • png / jpg / webp · 用于 atlas 贴图配对
SAFE BY DEFAULT

默认关闭，只处理新导入

缩略图会写入 Eagle 素材卡片，因此在首次使用时需要明确打开自动生成开关。

  • 01 不扫描历史素材

    插件从启用后的新导入批次开始监听，不会回头批量修改已有素材。

  • 02 不覆盖自定义缩略图

    检测到素材已有自定义缩略图时直接跳过，并把结果记录在分类日志中。

  • 03 配置独立保存

    设置写入 Eagle 用户数据目录，不修改素材 metadata.json、标签或注释。

FEATURES

导入之后，剩下交给插件

不是只会渲染一张图：资源发现、跨目录配对、版本切换、编码搜索和写入反馈都在同一个后台流程里完成。

跨文件夹自动配对

Eagle 会把每个导入文件拆成独立 item 文件夹。插件按文件名与尾缀规则关联骨骼、atlas 和贴图，即使它们分散在不同目录也能组成一套资源。

静态与动态两种输出

静态模式固定使用 setup pose 输出 PNG；动态模式读取骨骼中的第一个动画，逐帧渲染后封装为轻量 WebP。

体积与速度双策略

“最优体积”生成十个候选档位并保留最小结果；“最优速度”先粗估再只渲染最有希望的一两档，适合大批量导入。

9 个运行版本

从 JSON 版本字段或 SKEL 二进制头部识别 Spine 版本，自动匹配 3.4–4.3 对应的本地运行时。

批次串行处理

一次只渲染一个素材，避免批量导入时把 Eagle 卡住。后续批次自动排队，进度窗口会同步总数与剩余数量。

暂停、继续与取消

大批量动态生成时自动显示进度窗口。可暂停当前队列、继续执行，或取消剩余任务并保留已经完成的结果。

分类日志

成功、失败、警告和错误可分别筛选。每条记录包含素材名、Eagle 文件夹、骨架、atlas 与贴图齐全情况。

八种界面语言

跟随 Eagle 当前语言显示简体中文、繁体中文、英文、日文、韩文、俄文、西班牙文或德文界面。

WORKFLOW

从导入到缩略图

首次打开自动生成后，后续新导入的 Spine 素材会沿同一条串行流程处理。

  1. 01

    发现新素材

    监听 Eagle 素材库目录，在导入批次稳定后读取新增 item，历史素材不会进入队列。

  2. 02

    配对与检查

    关联骨骼、atlas 和贴图，检查版本、复合后缀、贴图数量以及是否已有自定义缩略图。

  3. 03

    渲染缩略图

    加载匹配运行时，按静态或动态模式绘制画布。动态模式继续搜索满足目标体积的编码参数。

  4. 04

    写入与反馈

    通过 Eagle 官方接口写入自定义缩略图，并同步更新统计、分类日志与进度窗口。

OUTPUT

按素材用途选择输出

两种模式共用同一套资源识别与安全检查，只在最终渲染阶段不同。

STATIC

静帧 · setup pose

始终生成一个稳定的 default 姿势，适合需要明确默认形象、动画首帧不适合作为封面的素材。

  • 输出格式：PNG
  • 渲染内容：setup pose
  • 速度：更快，结果稳定
ANIMATED

动态 · 首个动画

读取骨骼中的第一个动画，采样帧后封装为动态 WebP，让素材卡片直接呈现动作状态。

  • 输出格式：动画 WebP
  • 渲染内容：第一个动画
  • 速度：更慢，需搜索编码档位
SUPPORTED

覆盖 Spine 3.4 – 4.3

支持 JSON、SKEL、SKEL.BYTES、ATLAS 与 ATLAS.TXT，使用与皮肤和约束相匹配的本地运行时渲染。

  • 3.4
  • 3.5
  • 3.6
  • 3.7
  • 3.8
  • 4.0
  • 4.1
  • 4.2
  • 4.3
版本骨骼输入渲染说明
3.4 / 3.5 JSON · SKEL · SKEL.BYTES 使用独立版本运行时和匹配的二进制解析分支，保留网格、权重、变形、约束与绘制顺序。
3.6 / 3.7 JSON · SKEL · SKEL.BYTES 通过官方同版本 SkeletonBinary 兼容层解析，无需额外导入 JSON。
3.8 – 4.3 JSON · SKEL · SKEL.BYTES 读取数据版本并加载对应运行时；4.x 的物理约束、裁剪和染色能力由运行时处理。
  • 复合后缀 skel.bytes
  • 复合后缀 atlas.txt
  • PMA 贴图
  • 多皮肤骨骼
  • 动态 WebP
  • 进度暂停与取消
  • 八种界面语言
GET STARTED

安装后只需打开一次开关

插件不会在默认状态下自动写入缩略图。先在控制面板开启“导入时自动生成缩略图”，再导入新的 Spine 资源。

EAGLE PLUGIN COMMUNITY 在 Eagle 插件社区获取 SpineThumbnails 搜索“Spine缩略图”，或直接打开 Eagle 插件社区。 前往插件页 →

  1. 安装并打开插件

    在 Eagle 中安装插件，打开 SpineThumbnails 控制面板。

  2. 启用自动生成

    打开“导入时自动生成缩略图”，选择动态或静态模式，以及最优体积或最优速度策略。

  3. 导入整套资源

    把骨骼、atlas 和贴图导入 Eagle。插件会只针对本次新导入的素材自动处理。

FAQ

常见问题

插件会覆盖我已经设置好的缩略图吗？

不会。检测到素材已有自定义缩略图时会跳过并记录日志。插件只通过 Eagle 官方接口设置当前新素材的缩略图。

为什么历史素材没有自动处理？

这是默认安全行为。插件只处理启用后新导入的素材，不扫描、不修改历史素材，避免一次开关造成全素材库批量变更。

资源没有同时导入会怎样？

配套不全的素材会记为待观察。后续批次补齐 atlas 或贴图后，插件会重新检查并继续处理。

动态缩略图为什么比静态慢？

动态模式需要渲染多个动画帧，还要在分辨率、帧率、质量和目标体积之间寻找合适档位。选择“最优速度”会减少实际生成的候选数量。