SuperAPI AI 工具集

blockbench-flipbook-textures

设计与创作

查看项目

更新于 10-15 22:41

技能介绍

用途:为 Blockbench 与 Minecraft 生成动画翻页纹理。最终交付一张垂直 PNG,包含等尺寸动画帧,帧 0 在顶部,帧间无间隙;N 帧 W×H 像素时位图为 W×(H*N)。每帧是完整方块贴图或完整 UV 图集。

主要能力:先确定动画契约(主体、风格、单帧像素、帧数、时长/FPS 或每帧 tick、循环或单次、透明、平铺、目标平台),再生成源图集并归一化为垂直帧条,最后导入 Blockbench 并配置元数据。

必要用法:需先加载 blockbench-use 与 blockbench-texturing;生成或重绘必须使用 blockbench-gpt-image-textures 的 GPT Image 2.5 工作流与脚本(含 FAL_KEY 处理),不可静默替换模型。转换用 Python 3.10+ 与 Pillow(python -m pip install Pillow),也可用 ImageMagick。示例:python scripts/sheet_to_flipbook.py /path/to/source.png /path/to/portal.png --grid 4 4 --count 16 --frame-width 32 --frame-height 32 --ticks-per-frame 2 --preview /path/to/portal-preview.apng。已垂直用 --grid 1 N,水平用 --grid N 1;非顺序帧用 --indices;有留白或间隙用 --crop 与 --gap;不规则排布用 --rects。像素画用默认最近邻,绘画风格用 --resample lanczos。

适用场景:Blockbench 预览、Java 资源包、Bedrock 方块或实体。Java 用 .png.mcmeta,Bedrock 方块用 textures/flipbook_textures.json 加图集绑定,Bedrock 实体需单独 UV 动画/材质设置。

限制:转换器不写游戏元数据;APNG 仅为预览。生成 API 尺寸限制为 16 的倍数、655360 至 8294400 像素、最长边 3840、宽高比不超过 3:1。未指定时序时默认 2 ticks/帧(10 FPS)。不存在的 set_flipbook 工具不可假设。PBR 动画各通道需相同帧几何、顺序与时序。