免费 软件资源 LitematicaMaterialCounter丨全面统计投影填充材料 v1.0.1

​

Litematica Material Counter​

​

> 简介​

Litematica Material Counter 是一个用于精确统计 .litematic 投影文件中的所有建筑材料的工具。它能够深入容器（如箱子、潜影盒）内部进行统计，区分不同NBT数据的物品（例如自定义名称、附魔），最终将统计结果输出为易于阅读和处理的 CSV 文件。

> 功能特点​

• 全面统计: 统计投影中的所有方块和可获取的实体，并递归统计标准容器（箱子、木桶、发射器、投掷器、漏斗等）以及物品展示框上、潜影盒内部的物品。
• NBT区分: 能够识别并区分具有不同NBT标签的同一ID物品，例如不同自定义名称的工具或不同附魔等级的书籍。
• CSV输出: 生成详细的CSV格式报告，包含物品的（中文）名称、命名空间ID、NBT信息摘要、总数量以及估算存储所需的潜影盒数量。

> 输出CSV格式说明​

在导入的投影文件的同一级目录下，会生成一个{投影文件名称}_materials.csv 输出的CSV文件包含以下列：

• 物品名称: 物品的显示名称。如果配置了中文语言文件且找到对应翻译，则为中文名称；否则为处理后的英文ID。
• 物品ID: 物品的完整命名空间ID (例如 minecraft:diamond_pickaxe)。
• NBT信息: 对物品NBT数据的关键信息摘要。常见的包括：
  • 标准: 表示物品没有特殊的、被追踪的NBT标签。
  • 名称: <自定义名称>: 显示物品的自定义名称。
  • 附魔: <附魔1> <等级1>, <附魔2> <等级2>: 列出物品的附魔及其等级（等级以罗马数字显示）。
  • 药水: <药水效果ID>: 显示药水的基本效果ID。
  • 其他NBT信息会以键值对形式简要展示，并用分号分隔不同类型的NBT。
• 数量 (个): 该物品（具有相同ID和NBT信息）在投影中的总数量。
• 数量 (潜影盒): 根据标准27格潜影盒计算，存储这么多物品大约需要多少个潜影盒。结果保留3位小数。

> 效果展示​

> 更新日志​

• v1.0.0 2025.5.11 初始版本
• v1.0.1 2025.5.11 添加相同物品合并映射，使得物品ID不同但本质上相同的物品（如火把物品和火把方块）的数量合并统计，并将映射表提取到主程序之外

> 作者&技术交流/反馈群​

• bilibili：TianKong_y
• QQ：技术交流/反馈群

> 鸣谢​

• Albertchen857 本项目参考了LitematicaViewer的投影文件读取、容器分析功能的实现