Перейти к содержимому
Mineforgian

Item Icon Exporter

A lightweight client-side utility to easily capture and batch-export transparent item icons for wikis and modpacks.

Загрузки
170
Подписчики
3
Обновлён
21 мая 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 19 апреля 2026 г.

Item Icon Exporter

[English Description]

Need high-quality, transparent item icons for your wiki, modpack quests, or video thumbnails? Tired of manually cropping out backgrounds in Photoshop?

Item Icon Exporter is a highly practical, lightweight client-side utility mod. It allows you to instantly capture and export any in-game item or block into clean, transparent PNG images directly to your local drive!

✨ Key Features

  • One-Click Export: Easily export the exact item you are currently holding, or batch export every unique item in your inventory with a single keypress! (Default Keys: Numpad 4 for Held Item, Numpad 5 for Inventory).
  • Perfect Transparent Backgrounds: Accurately renders the item and automatically saves it with a 100% transparent background. Ready to use immediately!
  • Smart Auto-Scaling for Oversized Items: Weapons or item models larger than the standard grid (like giant swords from other mods) are automatically recognized by a smart algorithm, perfectly scaled, and cropped to fit the image. Say goodbye to cut-off edges or manual config tweaking!
  • Enchantment Glint Control: Want the raw item texture without the purple enchanted glow? The mod can be configured to automatically visually strip the glint from enchanted items, or export both enchanted and clean versions simultaneously!
  • Smart Naming & Organization: Automatically groups your exports into timestamped folders (yyyyMMddHHmmss). It names the files using the item's localized in-game name (e.g., Stone_32x32.png) and automatically handles duplicate names (e.g., Stone(1)_32x32.png).
  • Mapping File Generation: Generates a convenient 0Item Name and ID Mapping.txt file in the export folder, allowing you to easily cross-reference the localized image names back to their exact registry IDs.
  • NBT & Data Component Support: Flawlessly distinguishes items that share the same ID but have different Data Components or NBTs. No variations are left behind during inventory batch exports!
  • Multi-Size Generation: Need a standard 36x36 icon and a high-res 168x168 render at the same time? Configure the mod to output multiple resolutions simultaneously! (Supported limits: Size 16 up to an ultra-HD 2048!).
  • Smart In-Game Feedback: Once the export is complete, a neat summary message will appear in your chat. Simply click the text to instantly open the output folder.
  • Client-Side Only: You only need to install this on your client. It works perfectly on any multiplayer server!

⚙️ Configuration

You can find the config file at .minecraft/config/item_icon_exporter-client.toml.

  • savePath (Default: "item_icon_exporter_output"): The folder where exported images are saved. Supports absolute or relative paths.
  • imageSizes (Default: [36, 168]): List of square image sizes to export. Input as integers (e.g., 32 means 32x32).
  • glintExportMode (Default: 1): How to handle items with enchantment glint.
    • 1 = Export ONLY the unenchanted icon (removes glint visually before exporting).
    • 2 = Export ONLY the enchanted icon (keeps original glint).
    • 3 = Export BOTH (exports one clean image, and another with a '_glint' suffix).

📦 Modpack Usage Permission

This mod can be freely included and bundled directly in any modpacks. You may put the .jar file inside your modpack for seamless usage by your players.

[中文介绍]

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

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

✨ 核心功能

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

⚙️ 配置

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

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

📦 整合包使用许可

Ченджлог

1.0.3-Forge-1.20.1Релиз1.20.1 · 21 мая 2026 г.

📄 Item Icon Exporter Update Changelog

🇬🇧 English

New Features

  • Introduced the /itemexport command system, allowing users to export items without relying on keybindings. Supported sub-commands include:
    • hand: Export the currently held item.
    • inventory: Export all valid items in the player's inventory.
    • mod <ModID>: Export all items from a specific mod. Supports TAB auto-completion to easily find loaded mod IDs.
    • all: Export all items currently registered in the game.
  • Improved bulk export organization: When exporting multiple items, the generated images are now automatically categorized into sub-folders based on their source mod.
  • Added new settings in the configuration file:
    • An option to completely disable the mod's keybindings to prevent accidental presses.
    • An adjustable "per-tick processing limit". This distributes massive export tasks (e.g., thousands of items) across multiple game frames, effectively preventing the game screen from freezing during the process.

Bug Fixes & Optimizations

  • Fixed an issue where exporting small items (such as Iron Nuggets) or items with offset visuals (like Sticks) would result in unnaturally stretched or improperly centered images.
  • Improved the automatic cropping system. Standard items will now strictly retain their original in-game proportions and visual spacing (including empty edges). Oversized modded models (such as giant weapons) will gracefully fallback to the dynamic scaling logic, ensuring they remain fully visible and correctly centered without being cut off.

🇨🇳 中文

新增功能

  • 新增了 /itemexport 命令系统，允许玩家通过指令进行导出操作，不再强制依赖快捷键。支持的指令分支包括：
    • hand：导出主手手持的物品。
    • inventory：导出当前背包内所有不重复的物品。
    • mod <模组ID>：导出指定模组的全部物品。支持按 TAB 键自动补全当前已加载的合法模组 ID。
    • all：一次性导出游戏中加载的所有物品。
  • 优化了批量导出的文件结构：在使用指令批量导出时，系统会自动以对应的模组 ID 为名创建子文件夹，并将图片分门别类地存放。
  • 配置文件中新增了以下选项：
    • 允许彻底关闭快捷键注册（适合仅需指令导出的玩家），避免按键误触。
    • 新增“每帧最大处理数量”设置。该机制将极其庞大的导出任务分摊到多个游戏帧中进行，彻底解决了导出几千个物品时游戏端瞬间卡死（画面冻结）的问题。

修复与优化

  • 修复了在导出尺寸较小（如铁粒）或原本就偏向角落（如木棍）的物品时，导出的图标会被不自然地拉伸放大或强行居中的问题。
  • 改进了自动裁切系统。现在普通的标准物品会严格保留其在原版游戏中的真实比例与边缘留空；而超大型模组物品（如巨型武器）在突破标准尺寸时，依然可以自动缩放并完整居中导出，不会被裁断。
1.0.3-NeoForge-1.21.1Релиз1.21.1 · 21 мая 2026 г.

📄 Item Icon Exporter Update Changelog

🇬🇧 English

New Features

  • Introduced the /itemexport command system, allowing users to export items without relying on keybindings. Supported sub-commands include:
    • hand: Export the currently held item.
    • inventory: Export all valid items in the player's inventory.
    • mod <ModID>: Export all items from a specific mod. Supports TAB auto-completion to easily find loaded mod IDs.
    • all: Export all items currently registered in the game.
  • Improved bulk export organization: When exporting multiple items, the generated images are now automatically categorized into sub-folders based on their source mod.
  • Added new settings in the configuration file:
    • An option to completely disable the mod's keybindings to prevent accidental presses.
    • An adjustable "per-tick processing limit". This distributes massive export tasks (e.g., thousands of items) across multiple game frames, effectively preventing the game screen from freezing during the process.

Bug Fixes & Optimizations

  • Fixed an issue where exporting small items (such as Iron Nuggets) or items with offset visuals (like Sticks) would result in unnaturally stretched or improperly centered images.
  • Improved the automatic cropping system. Standard items will now strictly retain their original in-game proportions and visual spacing (including empty edges). Oversized modded models (such as giant weapons) will gracefully fallback to the dynamic scaling logic, ensuring they remain fully visible and correctly centered without being cut off.

🇨🇳 中文

新增功能

  • 新增了 /itemexport 命令系统，允许玩家通过指令进行导出操作，不再强制依赖快捷键。支持的指令分支包括：
    • hand：导出主手手持的物品。
    • inventory：导出当前背包内所有不重复的物品。
    • mod <模组ID>：导出指定模组的全部物品。支持按 TAB 键自动补全当前已加载的合法模组 ID。
    • all：一次性导出游戏中加载的所有物品。
  • 优化了批量导出的文件结构：在使用指令批量导出时，系统会自动以对应的模组 ID 为名创建子文件夹，并将图片分门别类地存放。
  • 配置文件中新增了以下选项：
    • 允许彻底关闭快捷键注册（适合仅需指令导出的玩家），避免按键误触。
    • 新增“每帧最大处理数量”设置。该机制将极其庞大的导出任务分摊到多个游戏帧中进行，彻底解决了导出几千个物品时游戏端瞬间卡死（画面冻结）的问题。

修复与优化

  • 修复了在导出尺寸较小（如铁粒）或原本就偏向角落（如木棍）的物品时，导出的图标会被不自然地拉伸放大或强行居中的问题。
  • 改进了自动裁切系统。现在普通的标准物品会严格保留其在原版游戏中的真实比例与边缘留空；而超大型模组物品（如巨型武器）在突破标准尺寸时，依然可以自动缩放并完整居中导出，不会被裁断。
1.0.2-NeoForge-1.21.1Релиз1.21.1 · 4 мая 2026 г.

📄 Item Icon Exporter Update Changelog

🇬🇧 English

New Features

  • Added a new configuration option glintExportMode to control the export behavior of enchanted items. You can now choose to export only the base item icon without glint (default), only the original enchanted icon, or export both versions simultaneously.

Optimizations & Adjustments

  • Implemented a fully automated scaling and cropping system. Oversized item models (such as weapons from the SlashBlade mod) will no longer be cut off out of bounds. The mod now renders them internally in a large high-resolution buffer, precisely calculates the physical bounding box, and automatically downsizes them to the target size using the nearest-neighbor algorithm.
  • Simplified the imageSizes configuration format. You no longer need to use strings like "32x32"; instead, you can directly use a list of standard integers (e.g., 32, 168) to define the lengths of the exported square images.
  • Removed the renderScale configuration option, as the new auto-scaling algorithm perfectly handles item sizes without requiring any manual user adjustment.

🇨🇳 中文

新功能

  • 新增了附魔发光物品导出策略的配置选项（glintExportMode）。现在可以自由选择：仅导出剥离光效后的纯净物品图标（默认）、仅导出带光效的原版图标，或是同时完整导出无光效和有光效的两个版本。

优化与调整

  • 引入了全新的自动缩放与超采样裁剪系统。在导出超尺寸物品（如“拔刀剑”等极易超出原版16x16格子的模型）时，不再会被裁剪掉边缘。系统会在后台进行宽视野大图预渲染、精准提取包围盒，并使用邻近算法（Nearest-neighbor）自动完美缩放至用户需要的目标尺寸。
  • 大幅简化了图片尺寸配置项（imageSizes）的格式。移除了原本繁琐的 "32x32" 字符串格式要求，现在只需在配置文件中直接以整数列表的形式填写边长即可。
  • 由于全新自动化缩放机制的加入，现已移除原本需要玩家手动调整和复原的全局渲染缩放系数（renderScale），实现了真正的“免配置开箱即用”。
1.0.2-Forge-1.20.1Релиз1.20.1 · 4 мая 2026 г.

📄 Item Icon Exporter Update Changelog

🇬🇧 English

New Features

  • Added a new configuration option glintExportMode to control the export behavior of enchanted items. You can now choose to export only the base item icon without glint (default), only the original enchanted icon, or export both versions simultaneously.

Optimizations & Adjustments

  • Implemented a fully automated scaling and cropping system. Oversized item models (such as weapons from the SlashBlade mod) will no longer be cut off out of bounds. The mod now renders them internally in a large high-resolution buffer, precisely calculates the physical bounding box, and automatically downsizes them to the target size using the nearest-neighbor algorithm.
  • Simplified the imageSizes configuration format. You no longer need to use strings like "32x32"; instead, you can directly use a list of standard integers (e.g., 32, 168) to define the lengths of the exported square images.
  • Removed the renderScale configuration option, as the new auto-scaling algorithm perfectly handles item sizes without requiring any manual user adjustment.

🇨🇳 中文

新功能

  • 新增了附魔发光物品导出策略的配置选项（glintExportMode）。现在可以自由选择：仅导出剥离光效后的纯净物品图标（默认）、仅导出带光效的原版图标，或是同时完整导出无光效和有光效的两个版本。

优化与调整

  • 引入了全新的自动缩放与超采样裁剪系统。在导出超尺寸物品（如“拔刀剑”等极易超出原版16x16格子的模型）时，不再会被裁剪掉边缘。系统会在后台进行宽视野大图预渲染、精准提取包围盒，并使用邻近算法（Nearest-neighbor）自动完美缩放至用户需要的目标尺寸。
  • 大幅简化了图片尺寸配置项（imageSizes）的格式。移除了原本繁琐的 "32x32" 字符串格式要求，现在只需在配置文件中直接以整数列表的形式填写边长即可。
  • 由于全新自动化缩放机制的加入，现已移除原本需要玩家手动调整和复原的全局渲染缩放系数（renderScale），实现了真正的“免配置开箱即用”。

Комментарии

Загружаем…