Yueyue Litematica Extension

A client-side companion for Litematica, by Yisibite. Current release: 1.1.2 for Minecraft 26.3. Inspect schematic container contents, locate containers and composter levels, and replace supported building materials before saving the schematic.

Material replacement

Open a Litematica material list and use Replace / 互换, immediately left of a supported row's Ignore button. The picker shows block icons and translated names and supports Chinese names and English IDs.

• Stone, smooth stone, cobblestone, stone bricks, mossy variants and the 16 concrete colors are grouped by shape: full blocks, slabs and stairs are separate families. Only existing registered, compatible targets are offered; this add-on does not itself add missing blocks.
• Doors, trapdoors and walls each have their own families. Wood families include planks, logs/stems, wood/hyphae, stripped variants, slabs, stairs, fences, fence gates, wooden buttons/pressure plates, signs and hanging signs.
• Color families include wool, carpets, terracotta, glazed terracotta and concrete powder. Glass and stained glass form one family; glass panes form another.
• Live/dead coral fans can be exchanged while retaining floor/wall mounting. Leaves can be exchanged while retaining source-state properties.

Compatible source properties are preserved, including facing, axis, slab half, stair shape, waterlogging, door hinge/open/powered state and wall connections. Unsupported conversions are not offered. Containers, their stored items and entity data are not material replacements.

Selections remain a draft: rows keep their original counts and are not merged immediately. Save New Schematic / 保存新投影 writes a new .litematic. Replace Current Schematic / 替换当前投影 asks for confirmation, backs up the original beside it, validates a temporary result and replaces the file. After a successful save, matching materials merge: 2 glass + 3 white stained glass changed to glass becomes 5 glass. Placement position, rotation, mirror and subregion settings are retained; failed saves retain the draft and original file.

The stone-material picker warns: 混凝土的防爆抗性比石头类低，替换前请先检查. Material replacement can change a machine's physical behavior even when shape and direction are retained.

Container contents and composters

The material list's Container Items / Composter Levels entry counts the items needed inside schematic containers, including nested shulker contents and material multipliers. Different names, enchantments and other components remain distinct. Inspect item slots, find containers by name/ID/coordinates and highlight a selected location in the world. Composter levels 0-8 are listed, with level 8 indicating collectable bone meal.

Highlights follow moved, rotated and mirrored placements. Missing container NBT is shown as unknown; unopened loot-table contents cannot be predicted. These are container-fill requirements, not the ingredients needed to craft those items. Inspection does not fill containers or place blocks; confirmed material saving writes the schematic, not the world.

中文介绍与使用

月月投影扩展包含“材料互换”和“容器 / 堆肥等级”两组功能。

1. 打开投影材料列表，点击每行“忽略”左侧的 互换，按方块图标、中文名或英文 ID 选择同形状材质。石制默认按圆石、石头、平滑石头、石砖、16 色混凝土排列，白色混凝土优先；玻璃先普通玻璃，再白色及其它染色玻璃。
2. 石制整砖、半砖、楼梯分别互换；门、活版门、墙分别互换；各种木材按用途互换；羊毛、地毯、陶瓦、带釉陶瓦、混凝土粉末、玻璃和玻璃板分别互换；珊瑚扇 / 失活珊瑚扇、树叶也支持。只提供当前游戏中已注册且状态兼容的目标，不要求安装月月现代科技，也不会凭空添加缺少的方块。
3. 互换保留朝向、轴、上下半砖、楼梯形状、含水、门状态和墙连接等兼容属性。墙上的珊瑚扇、告示牌保持墙面形态；树叶保留距离、持久性和含水等源属性。混凝土的防爆抗性比石头类低，替换前请先检查。
4. 选好后先显示目标预览，不立刻改源文件、不合并行。底部点击 保存新投影 另存，或 替换当前投影 确认覆盖。替换原文件前保存保护副本；两种方式都在成功后才合并相同材料。例如 2 个玻璃与 3 个改成玻璃的白色玻璃合为 5 个玻璃。失败保留草稿和原文件。
5. 点击 容器 / 堆肥等级，查看容器内需要装入多少物品、哪些容器需要它、具体槽位，以及堆肥桶 0-8 级。支持潜影盒内物品、材料倍率及中文 / ID / 坐标搜索；点击 定位此位置 可在世界中高亮。

容器信息来自投影已保存的 NBT，缺失就显示未知，不自动填充或接管打印机。材质互换只处理建筑方块，不替换容器里的物品。不同形状不混换，不能把半砖直接换成整砖。

Runtime and dependencies

• Minecraft 26.3, Java 25, Fabric Loader 0.19.5+; client only.
• Feature integration targets Litematica 0.29.1, MaLiLib 0.30.2+ and the required Fabric API modules. Install their own dependencies separately.
• Missing optional feature dependencies hide integration without preventing startup. No server installation is needed for local schematic editing.
• /yueyueprojection opens the current extension view; /yueyueprojection clear clears the location highlight.

Complete corresponding source and build instructions are attached separately.

Credits and references

Original companion by Yisibite. Credits to masa and Litematica/MaLiLib maintainers for schematic/material-list/UI APIs (LGPLv3). This is not their official release and does not bundle those dependency JARs. Minecraft item/container data is interpreted through game APIs.

• Litematica: Separate feature dependency/API targets (LGPLv3, installed metadata)
• MaLiLib: Separate feature dependency/UI API (LGPLv3, installed metadata)

Original Yueyue code by Yisibite, with AI assistance. Source REFERENCES.md, THIRD_PARTY_NOTICES.md and any text-source ledger identify upstream material separately. No upstream dependency is represented as Yueyue-owned or relicensed by the original-code license.