📄 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 为名创建子文件夹，并将图片分门别类地存放。
• 配置文件中新增了以下选项：
  • 允许彻底关闭快捷键注册（适合仅需指令导出的玩家），避免按键误触。
  • 新增“每帧最大处理数量”设置。该机制将极其庞大的导出任务分摊到多个游戏帧中进行，彻底解决了导出几千个物品时游戏端瞬间卡死（画面冻结）的问题。

修复与优化

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