IconFlux

IconFlux

将游戏中的任意物品图标导出为APNG或静态PNG,动画帧直接读取自物品自身的纹理。

杂项

IconFlux · 动态图标导出

客户端工具。它读取游戏自身的渲染结果,因此每个导出的图标都与物品栏中完全一致。

IconFlux 可将任意物品的物品栏图标转换为 APNG 或静态 PNG,正确处理透明度,动画直接取自游戏。

快速上手

  1. 在和平模式的超平坦世界中启动客户端,确保导出过程不受干扰。
  2. 输入 /iconflux help 以确认模组已加载。
  3. 输入 /iconflux export minecraft diamond 128,然后在 .minecraft/IconFlux 下查找文件。

指令

/iconflux help
/iconflux export <命名空间> all [auto|帧数] [边长]
/iconflux export <命名空间> <物品>[属性] [auto|帧数] [边长]
参数 取值 含义
命名空间 minecraft、crycraft、任意模组 id 要查看哪个模组的物品
all 关键字 该命名空间的所有物品
物品 路径,例如 diamond 单个物品;命名空间会自动补全
属性 方括号,例如 [grade=3] 选择变体;仅读取 grade,其他键会被忽略
帧数 auto 或 1 到 256 省略时表示 auto,跟随贴图的 mcmeta
边长 16 到 512 图标边长(像素),默认 128

image

文件保存位置

  • 目录结构。 .minecraft/IconFlux/<命名空间>/<边长>x/,每个模组、每种尺寸各一个文件夹。
  • 文件名。 当前游戏语言下的物品显示名称,Windows 不允许的字符会被替换。
  • 静态物品。 仅一个文件,不生成 _static 副本。
  • 动画物品。 一张 APNG,外加一张取自循环中间的静态图。

image

建议做法

  • 在和平模式的超平坦世界中导出。 没有移动、没有攻击,工具处理长列表时世界保持安静。
  • 帧数丢失时手动指定帧数。 部分物品的动画通过模型分支而非贴图的 mcmeta 实现,因此 auto 只能看到静态图像;手动传入帧数即可捕获完整循环。

注意

  • 进度。 导出时会打开一个界面,玩家无法移动;按 ESC 取消,已写入的文件会保留。
  • 插值。 使用 interpolate 的贴图在游戏中会生成混合帧;APNG 保留真实帧,因此看起来可能略硬。
  • 速度。 每一帧都会被捕获并写入,因此大型命名空间耗时较长;建议先导出一个物品检查结果。
  • 长动画会被截短。 超过 256 帧,或单帧停留超过 2 秒的动画,会按静态图像处理;单独导出该物品即可捕获完整循环。
  • 部分动画不会以标准速度播放。 帧时长按贴图声明的值写入,因此外观由模型分支或游戏自身插值驱动的物品,导出结果仍可能过快或过慢;之后可手动调整帧数。

中文说明

客户端工具。图标由游戏自身渲染,因此导出的图像与物品栏中看到的完全一致。

IconFlux 可将任意物品的界面图标导出为 APNG 或静态 PNG,透明边缘处理干净,动画直接取自游戏。

快速上手

  1. 进入和平模式的超平坦世界,避免导出时受到怪物或地形干扰。
  2. 输入 /iconflux help,若能列出用法说明即表示加载成功。
  3. 输入 /iconflux export minecraft diamond 128,然后在 .minecraft/IconFlux 下查找文件。

指令

/iconflux help
/iconflux export <命名空间> all [auto|帧数] [边长]
/iconflux export <命名空间> <物品>[属性] [auto|帧数] [边长]
参数 取值 含义
命名空间 minecraft、crycraft 或任意模组 id 到哪个模组中查找物品
all 关键字 该命名空间下的全部物品
物品 路径,例如 diamond 单个物品,命名空间会自动补全
属性 方括号,例如 [grade=3] 选择变体,目前仅识别 grade;其他键会被忽略
帧数 auto 或 1 到 256 省略时按 auto 处理,跟随贴图的 mcmeta
边长 16 到 512 图标边长,默认 128

文件位置

  • 目录。 .minecraft/IconFlux/<命名空间>/<边长>x/,每个模组、每种尺寸各一个文件夹。
  • 文件名。 当前游戏语言下的物品显示名称,Windows 不允许的字符会被替换。
  • 静态物品。 仅生成一个文件,不写入 _static。
  • 动画物品。 一张 APNG,外加一张取自整轮循环中间的静态图。

建议做法

  • 在和平模式的超平坦世界中导出。 没有怪物打扰,也没有随机地形干扰,批量导出时画面安静。
  • 帧数丢失时手动补充。 有些物品的动画写在模型分支中而非贴图的 mcmeta 中,auto 会将其视为静态图;此时手动填写帧数,才能捕获完整循环。

注意

  • 进度。 导出时会打开界面,玩家无法移动;按 ESC 取消,已写入的文件会保留。
  • 插值。 带 interpolate 的贴图在游戏中会在帧之间补间,APNG 仅保留真实帧,因此看起来会略硬。
  • 速度。 每一帧都需要截图并写入磁盘,命名空间越大越慢;建议先导出一个物品确认效果,再批量处理。
  • 长动画会被截短。 超过 256 帧,或单帧停留超过 2 秒的动画,会按静态图像处理;如需完整循环,请单独导出该物品。
  • 部分动画材质的播放速度并非标准速度。 帧时长按贴图声明的值写入,但外观由模型分支或游戏自身插值驱动的物品,导出的快慢仍可能与游戏中不同,需要后续自行调整帧数。