Item Icon Exporter

物品图标导出工具

\[英文介绍\]

想为你的维基、整合包任务或视频缩略图准备高质量的透明背景物品图标吗？厌倦了在 Photoshop 里手动裁剪背景吗？

Item Icon Exporter 是一款非常实用、轻量的客户端工具模组。它可以让你即时捕获并导出游戏中的任意物品或方块，将其保存为干净的透明背景 PNG 图片，直接存入本地硬盘！

✨ 核心功能

• 一键导出：轻松导出你当前手持的物品，也可以按一次快捷键批量导出背包中的所有不同物品！（默认快捷键：Numpad 4用于导出手持物品，Numpad 5用于导出背包物品。）
• 完美透明背景：精准渲染物品，并自动保存为 100% 透明背景图片。导出后即可直接使用！
• 超大物品智能缩放：武器或物品模型超过标准格子大小时（例如其他模组中的巨剑），智能算法会自动识别、缩放并裁剪，使其完美适配图片。告别边缘被裁切或手动调整配置！
• 附魔光效控制：想要不带紫色附魔光效的原始物品纹理？你可以设置模组自动在视觉上移除附魔物品的光效，也可以同时导出附魔版和纯净版！
• 智能命名与整理：自动将导出图片归类到带时间戳的文件夹中（yyyyMMddHHmmss）。文件名采用物品在游戏内的本地化名称（例如 Stone_32x32.png），并自动处理重名文件（例如 Stone(1)_32x32.png）。
• 生成映射文件：在导出文件夹中生成便捷的 0Item Name and ID Mapping.txt 文件，方便你将本地化图片名称对应回准确的注册 ID。
• NBT 与数据组件支持：能够准确区分 ID 相同但数据组件或 NBT 不同的物品。批量导出背包时，不会遗漏任何变体！
• 生成多种尺寸：想同时生成标准的 36×36 图标和高清的 168×168 渲染图？设置模组即可同时输出多种分辨率！（支持尺寸从 16 到超高清 2048！）
• 游戏内智能反馈：导出完成后，聊天栏中会显示简洁的汇总信息。点击文字即可立即打开输出文件夹。
• 仅需安装在客户端：只需在客户端安装此模组。在任何多人服务器上都能正常使用！

⚙️ 配置

你可以在 .minecraft/config/item_icon_exporter-client.toml 找到配置文件。

• savePath（默认值：”item_icon_exporter_output”）：保存导出图片的文件夹。支持绝对路径或相对路径。
• imageSizes（默认值：[36, 168]）：要导出的正方形图片尺寸列表。请输入整数（例如 32 表示 32×32）。
• glintExportMode（默认值：1）：设置如何处理带附魔光效的物品。
• 1 = 仅导出未附魔图标（导出前在视觉上移除光效）。
• 2 = 仅导出附魔图标（保留原始光效）。
• 3 = 同时导出两种版本（导出一张纯净图片，另一张文件名带有 “_glint” 后缀）。

📦 整合包使用许可

本模组可免费收录并直接打包进任何整合包。你可以将 .jar 文件放入整合包，方便玩家直接使用。

\[中文介绍\]

正在为整理维基（Wiki）、制作整合包任务书或是视频封面，苦恼怎么弄到高清的透明底物品图标吗？受够了在修图软件里辛苦地一点点抠去背景吗？

Item Icon Exporter（物品图标导出工具） 是一个极为实用且轻量的客户端辅助模组。它可以让你在游戏内，将任意物品或方块极速渲染为纯净、透明背景的 PNG 图片文件，并直接保存到你的电脑中！

✨ 核心功能

• 一键极速导出：只需按下快捷键，即可导出当前手持的物品；或者一键批量导出玩家背包内的所有不同物品！（默认快捷键：小键盘 4 导出手中物品，小键盘 5 导出整个背包）。
• 完美透明背景：精准渲染游戏内物品的原貌，并自动生成带透明通道（Alpha）的图片。即开即用，再也不必费时费力地抠图！
• 超大尺寸物品自动适配：模组自带智能包围盒算法！遇到拔刀剑等模型严重超出格子的物品时，会自动检测物品的实际大小，并将其完美居中、缩放和截取，彻底告别出框裁剪或四周大片留白，无需手动调整任何缩放配置！
• 附魔光效自由剥离：不想要附魔武器上的紫色光效？你可以通过配置，让模组导出带有附魔的物品时自动剥离光效，生成纯净版图标；也可以同时导出“纯净 / 发光”两种版本供你挑选！
• 智能命名与归档：导出时会自动创建带时间戳的专属文件夹（如 20241117123000）。图片名称会自动采用玩家游戏语言的本地化名称（例如 石头_32x32.png），并智能处理重名物品（如自动添加后缀 石头(1)）。
• 自动生成对照表：每次导出都会在对应文件夹中生成一份 0物品名称和物品ID对照表.txt，让你不仅能获得直观的图片名称，还能在制作整合包时轻松查找对应的物品注册表 ID！
• 完美支持 NBT 与数据组件：即使是底层 ID 完全相同、仅依靠 1.21 数据组件或 NBT 区分的物品（例如各种形态不同的自定义道具），批量导出时也能精准识别，绝不遗漏任何一种形态！
• 同时生成多种尺寸：得益于灵活的配置文件，你可以通过一次按键同时生成多种尺寸的图像！无论是 36×36 的标准图标，还是 168×168 的高清图，一步到位。（支持边长 16 至超清的 2048。）
• 智能游戏内反馈：导出完成后，聊天栏会立即显示成功提示。直接点击聊天框中的路径文字，即可一键打开图片所在文件夹。
• 纯客户端模组：本模组只需安装在客户端即可使用，你可以带着它进入任何多人服务器截图保存！

⚙️ 配置

配置文件位于 .minecraft/config/item_icon_exporter-client.toml。

• savePath（默认：”item_icon_exporter_output”）：图片保存路径。支持填写绝对路径或相对路径。
• imageSizes（默认：[36, 168]）：要导出的图片尺寸列表（直接填写整数，表示正方形边长）。你可以随意添加多个尺寸。
• glintExportMode（默认：1）：导出带附魔光效物品时的处理策略。
• 1 = 仅导出无光效的纯净版图标（渲染时自动剥离附魔光效）。
• 2 = 仅导出附魔图标（保留原有光效）。
• 3 = 同时导出两种版本（一张无光效原图，以及一张带 ‘_glint’ 后缀的光效图）。

📦 整合包使用许可