Yueyue Litematica Extension

Yueyue Litematica Extension / 月月投影扩展

A client-side companion for Litematica, by Yisibite. Current release: 1.1.5+mc26.3. View complete schematic material totals, retain recently checked missing-material counts when chunks unload, inspect container contents and composter levels, locate containers, and replace compatible building materials before saving a schematic.

Complete materials and chunk loading

Placement material totals come directly from the schematic file and do not require real-world chunks or distant rendered schematic chunks to be loaded. Enabled subregions, render-layer limits, double-slab quantities and entity materials follow Litematica rules.

Missing and mismatched counts retain the most recent comparison made in the current world session. Unloaded chunks keep that recorded result; reloaded chunks are checked again automatically. Never-checked chunks are initially treated as still needing construction, so cached missing counts are not a live guarantee of remote world contents. The session cache clears on leaving the world or changing dimension; schematic fingerprints prevent reuse after incompatible content changes.

Work runs in small batches and reads only actual chunks already received by the client. The extension does not request, force-load or generate real-world chunks, or write world saves.

Carried ender-chest supplies

Carry an ender chest in your inventory, hotbar, main hand or offhand to include its supplies in the material list, including materials inside shulker boxes stored there. Multiple chests count their shared contents once. Singleplayer refreshes current contents automatically every half second. Multiplayer uses the most recent synchronized contents: open an ender chest once after connecting, and open it again after changes made elsewhere. The list shows whether current or cached contents are being used. No server installation, item changes or chunk loading is required.

Material replacement

Open a Litematica material list and use Replace / 互换, immediately left of a supported row's Ignore button. The picker shows compact dark rows, item icons and localized names. Search Chinese names or English IDs, then use the mouse wheel for continuous scrolling or drag the scrollbar; there are no picker pages. Search resets to the top; resizing preserves search and scroll position.

• Stone, smooth stone, cobblestone, stone bricks, mossy variants and 16 concrete colors are grouped by shape: full blocks, slabs and stairs are separate families. Only registered compatible targets are offered. The picker does not itself add missing blocks or require Yueyue Modern Technology.
• 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 retain compatible source-state properties.

Compatible properties are preserved, including facing, axis, slab half/double state, 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. Selecting a target returns to the material list. Cancel preserves the existing draft; 恢复原材质 (“Restore original material”) clears that row's draft. Save New Schematic / 保存新投影 writes a new .litematic. Replace Current Schematic / 替换当前投影 asks for confirmation, backs up the original beside it in .yueyue-replacement-backups/, validates a temporary result and replaces the file. Other imported formats can be saved as a new .litematic.

Only after successful saving do matching materials merge: 2 glass + 3 white stained glass changed to glass becomes 5 glass. Placement position, rotation, mirror, subregion settings, visibility and locks are retained; failed saves retain the draft and original file.

The stone-material picker warns: 混凝土的防爆抗性比石头类低，替换前请先检查 (“Concrete has lower blast resistance than stone materials; check before replacing”). 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 items needed inside schematic containers, including nested shulker contents and material multipliers. Different names, enchantments and other components remain distinct. Select an item to list the containers needing it, inspect their slots, search by name/ID/coordinates and highlight a selected location in the world. Composter levels 0–8 are listed; level 8 indicates collectable bone meal.

Highlights follow moved, rotated and mirrored placements, and clear when the placement is removed/disabled or the world is left. File-based material lists show subregion coordinates; placement-based lists use world coordinates and allow world highlighting. Missing container NBT is shown as unknown; unopened loot-table contents cannot be predicted. Re-save the schematic with container item data in its source world to supply missing information.

These are container-fill requirements, not crafting ingredients. Inspection does not fill containers, place blocks or control a printer. Confirmed material saving writes the schematic, not the world.

中文介绍与完整操作说明

月月投影扩展mod 1.1.5+mc26.3提供完整材料统计、缺料记录、材质互换，以及容器物品 / 堆肥等级查询和定位。

材料总量与缺料

投影放置的总材料直接从投影文件读取，无须实际区块或远处投影渲染区块加载。已启用子区域、渲染层、双半砖数量与实体材料仍按 Litematica 规则统计。

缺料和错放数量保留本次世界会话最近核对的记录：区块卸载后继续显示，重载后自动重新核对；从未核对的区块先按待建材料计算。因此远处缺料是已记录结果，不代表实时远程扫描。退出世界或切换维度会清缓存，修改投影后还会检查内容指纹。读取分批执行，只读客户端已有区块，不请求、不强制加载、不生成实际区块，不写玩家存档。

随身末影箱材料

背包、快捷栏、主手或副手携带末影箱时，材料列表自动计入箱内物品，也包含箱内潜影盒里的材料；多只末影箱只计算一次。单人档每半秒自动读取当前内容；联机使用最近打开时同步的内容，重新连接后请先打开一次，箱内内容被其它方式修改后也需重新打开。列表下方会提示使用当前内容还是缓存。不修改物品，不加载世界区块，不需要服务器安装扩展。

材质互换与保存

1. 打开投影材料列表，点击每行“忽略”左侧的 互换。选择页为材料列表式暗色紧凑行，显示方块图标与本地化名称；支持中文名 / 英文 ID 搜索，滚轮连续上下浏览，或拖动右侧滚动条，不再翻页。搜索回到顶部，缩放保留搜索与滚动位置。
2. 石制整砖、半砖、楼梯按同形状互换，涵盖圆石、石头、平滑石头、石砖、苔石和 16 色混凝土；门、活板门、墙分别互换；各种木材按相同用途互换；羊毛、地毯、陶瓦、带釉陶瓦、混凝土粉末各自成组，玻璃与玻璃板分别成组；珊瑚扇 / 失活珊瑚扇和树叶也支持。选项来自当前实际注册且状态兼容的方块，不需要现代科技，不会凭空增加缺少的方块。
3. 石制默认按圆石、石头、平滑石头、石砖、16 色混凝土排列，白色混凝土优先；玻璃先普通玻璃，再白色及其它染色玻璃。保留朝向、轴、上 / 下 / 双半砖、楼梯形状、含水、门铰链 / 开关 / 供电、墙连接等兼容状态；告示牌和珊瑚扇保留落地 / 贴墙形态，树叶保留距离、持久性与含水。不同形状不混换。混凝土的防爆抗性比石头类低，替换前请先检查。
4. 点击目标回到材料列表并显示箭头预览和“互换*”，只暂存、不改源文件、不合并行、不改原数量。取消保留已有草稿；点 恢复原材质 清除当前行草稿。不同材料列表各自保存草稿。
5. 点 保存新投影 另存 .litematic，原文件保留，当前选中放置切到新副本；或点 替换当前投影，确认后先完整备份原文件到旁边 .yueyue-replacement-backups/，校验临时文件后替换，同源已加载放置切到新数据。位置、旋转、镜像、子区域状态、可见性与锁保留；其他导入格式只允许另存 .litematic。
6. 两种保存仅成功后才合并相同材料，例如 2 个玻璃与 3 个改成玻璃的白色玻璃合为 5 个玻璃。失败保留草稿和原文件。材质互换只改建筑方块，不改容器物品、实体数据或实际世界。

容器 / 堆肥等级与定位

点材料列表底部 容器 / 堆肥等级，在物品需求中查看要装入的数量。按物品和完整组件区分，改名、附魔不同的物品不混合；支持潜影盒内物品和材料倍率，统计的是装填需求，不含合成原料。

点击物品查看需要它的容器，再点容器展开槽位；容器坐标旁标明其中所需的选定物品数量。支持中文名称、英文 ID 和坐标搜索，图标悬停显示原版提示；列表支持滚轮、Tab 和回车。选容器后点 定位此位置，返回世界显示绿色描边、位置与距离。定位随放置移动、旋转、镜像更新，移除 / 禁用放置或退出世界后清除。堆肥桶可按 0～8 级查询和定位，8 级标明可取骨粉。

从“投影文件”材料列表进入显示子区域内坐标，从“投影放置”进入显示世界坐标并可定位。缺少容器 NBT 显示“未保存物品数据”，不会当成空容器；未生成战利品表的内容也无法预知，需要回原存档重存含容器物品数据的投影。查询不会自动填充、放方块、补货或接管打印机。

/yueyueprojection 打开当前材料列表对应扩展，/yueyueprojection clear 取消定位。

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.

Complete corresponding source and build instructions are attached separately. 中文：需要实际使用这些功能时，请安装对应 Litematica、MaLiLib 与所需 Fabric API 模块；缺少功能依赖时不会显示对应入口。服务端无需安装本扩展，源码附件不作为游戏模组安装。

Credits and references / 致谢、参考与许可

Original companion by Yisibite, with AI assistance; original code is MIT. Credits to masa and Litematica/MaLiLib maintainers for schematic/material-list/UI APIs (LGPLv3). Complete material counting and coordinate transforms reference Litematica APIs. This is not their official release and does not bundle their source or dependency JARs. Minecraft item/container data is interpreted through game APIs.

• Litematica: Separate feature dependency/API targets (LGPLv3, installed metadata).
• Litematica maintained branch: Material counting and coordinate-transform API reference (LGPL-3.0).
• MaLiLib: Separate feature dependency/UI API (LGPLv3, installed metadata).

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. 中文：原创扩展由 Yisibite 制作，使用 AI 辅助；上游依赖及接口各自保留原许可和权利，本扩展不是 Litematica / MaLiLib 官方发布。