PrefabLitematica

## What it does

PrefabLitematica turns Litematica structures into reusable, chargeable blueprints. Import a `.litematic` file, a schematic already loaded in Litematica, or an entry from the projection list. You do not need to enable a projection in the world to import it.

## Charge with materials

The Blueprint Workbench shows the materials required for a build. Submit materials through its 3×3 input grid, charge in multiple batches, or use materials stored in shulker boxes. Each input slot can hold up to 4,096 items.

The mod supports 45 material groups based on block family and form. Empty buckets are returned after fluid materials are consumed. A Creative Charge Battery fills a blueprint instantly; it is available in the Creative inventory and has no recipe, loot, trade, or world-generation source.

## Place your build

Take the fully charged blueprint and right-click a block face to place the build in the adjacent space. Sneak-right-click to rotate it through 0°, 90°, 180°, and 270°.

The server validates the schematic data and placement area, then places blocks over time while preserving the original block states. By default, the blueprint item remains after placement and its shared charge resets to zero.

## Requirements

- Minecraft 26.3
- Java 25
- Fabric Loader 0.19.5 or later
- Fabric API 0.161.0+26.3 or a compatible newer version
- Install PrefabLitematica and Fabric API on both the client and server. Use the same mod version on both.
- Litematica 0.29.1 and MaLiLib 0.30.2 are needed only on clients that import schematics. Dedicated servers do not need them.

## Notes

- The default SAFE placement mode only allows placement in air or replaceable blocks. Server administrators can configure REPLACE mode.
- The mod does not copy entities or container contents, and does not automatically load chunks.
- If placement is forcibly interrupted, part of the build may remain. Spent charge is not automatically refunded.

## 简体中文

PrefabLitematica 可将 Litematica 建筑原理图导入为可重复使用的可充能蓝图。支持从 `.litematic` 文件、Litematica 已读入的原理图或投影列表导入，无需先在世界中启用投影。

蓝图工程台会显示建筑所需材料。玩家可通过 3×3 输入区提交材料、分批充能，也可使用潜影盒中的材料。每个输入格最多容纳 4,096 个物品。

模组支持按方块类别和形态划分的 45 类材料。消耗流体材料后会返还空桶。创造蓝图充能电池可立即充满蓝图；它可从创造物品栏获取，没有合成配方、战利品、交易或世界生成来源。

取出充满的蓝图后，右击方块表面即可将建筑放在相邻位置。潜行右击可在 0°、90°、180° 和 270° 之间切换方向。

服务端会验证原理图数据和放置范围，再逐步放置建筑并保留原始方块状态。默认情况下，放置完成后蓝图物品保留，共享充能归零。

## 安装要求

- Minecraft 26.3
- Java 25
- Fabric Loader 0.19.5 或更高版本
- Fabric API 0.161.0+26.3 或兼容的更新版本
- 客户端和服务端都需安装 PrefabLitematica 与 Fabric API，并使用相同版本的模组。
- 仅需导入原理图的客户端安装 Litematica 0.29.1 和 MaLiLib 0.30.2；独立服务器无需安装它们。

## 注意事项

- 默认 SAFE 放置模式只允许在空气或可替换方块位置放置。服务器管理员可配置 REPLACE 模式。
- 模组不会复制实体或容器内容，也不会自动加载区块。
- 如果放置被强制中断，世界中可能留下未完成的建筑；已消耗的充能不会自动返还。