Litematica Stats

# Litematica Stats

A client-side Fabric addon that extends **Litematica's Material List** with entity and container statistics, so you can see everything a schematic actually needs — not just placement blocks.

## Features

**Three tabs in the Material List screen**
- **Blocks** — the original Litematica material list, unchanged.
- **Entities** — counts every entity in the schematic by type, shown with its spawn egg icon. Entities are informational only and are never added to the material totals.
- **Container Contents** — scans every block container (chests, barrels, shulkers, furnaces, hoppers, dispensers, brewing stands, bookshelves, campfires, beacons…) plus container entities (chest/hopper minecarts, chest boats, donkeys, llamas, item frames…).

**Container inspection**
- Double chests are merged into a single container.
- Items are rendered as a slot-grid preview matching the container's real GUI layout and full capacity.
- Hover any slot to see the vanilla item tooltip, including shulker-box previews from Tweakeroo/Minihud.
- Containers with identical contents can be merged into one card with an ×N badge.
- Hover an entity in the Entities tab to preview the contents of its inventory.

**Organization**
- Ignore individual containers or entire container categories; ignored items are collected in a separate section at the bottom.
- Toggle "unified item view" to aggregate every item across all containers into one list.
- Toggle hiding of empty containers.
- Smooth pixel-based scrolling, search filtering and sortable columns.

## Supported Versions

Separate builds are provided for: **1.18.2, 1.19.4, 1.20.1, 1.21.1, 1.21.11, 26.2, 26.3** (Fabric).

## Requirements

- Fabric Loader + Fabric API
- [Litematica](https://modrinth.com/mod/litematica)
- [MaLiLib](https://modrinth.com/mod/malilib)

## Notes

- Client-side only; works on servers and in singleplayer wherever Litematica works.
- Purely additive: the original material list and material totals are untouched.
- Optional compatibility with Tweakeroo/Minihud container previews.

---

# Litematica Stats（中文）

一个客户端 Fabric 附属模组，为**投影模组的材料列表**增加实体与容器内容物统计，让你看到蓝图真正需要的全部内容，而不只是放置用的方块。

## 功能

**材料列表界面新增三个选项卡**
- **方块列表**：原版投影材料列表，完全保留。
- **实体列表**：按类型统计蓝图中的所有实体，并以对应刷怪蛋图标展示。实体仅作参考，不计入材料统计。
- **内容物列表**：扫描所有方块容器（箱子、木桶、潜影盒、熔炉、漏斗、发射器、酿造台、书架、营火、信标等）以及容器实体（箱子/漏斗矿车、箱子船、驴、羊驼、物品展示框等）。

**容器查看**
- 大箱子合并为一个容器展示。
- 以“格子”视图预览物品，布局和总容量与原版容器 GUI 一致。
- 鼠标悬停任意槽位显示原版物品提示，兼容 Tweakeroo/Minihud 的潜影盒预览。
- 内容物完全相同的容器可合并为一张卡片并显示 ×N 数量角标。
- 在实体列表中悬停带物品栏的实体，可直接预览其储存的物品。

**整理与筛选**
- 可忽略单个容器或整类容器，被忽略的物品统一收纳到页面底部的“被忽略”栏。
- “统一物品展示”可将所有容器中的物品汇总为一张列表。
- 可隐藏空容器。
- 像素级平滑滚动、搜索过滤与按列排序。

## 支持版本

分别提供 **1.18.2、1.19.4、1.20.1、1.21.1、1.21.11、26.2、26.3**（Fabric）构建。

## 前置模组

- Fabric Loader + Fabric API
- [Litematica](https://modrinth.com/mod/litematica)
- [MaLiLib](https://modrinth.com/mod/malilib)

## 说明

- 纯客户端模组；只要投影模组可用的服务器或单人存档均可使用。
- 纯增量功能：原版材料列表与材料总数不受影响。
- 可选兼容 Tweakeroo/Minihud 的容器预览。