{"url":"https://levimc.org/mods/github.com/copper-lamp/LitematicaBE/","tooth":"github.com/copper-lamp/LitematicaBE","name":"LitematicaBE","description":"LSE投影插件：支持 .litematic格式的原理图，幽灵方块投影、逐层建造与轻松放置","owner":"copper-lamp","icon":"https://raw.githubusercontent.com/copper-lamp/LitematicaBE/main/resources/pack_icon.png","repository":"https://github.com/copper-lamp/LitematicaBE","issues":"https://github.com/copper-lamp/LitematicaBE/issues","releases":"https://github.com/copper-lamp/LitematicaBE/releases","stars":22,"updated":"2026-10-31T06:24:41Z","published":"2026-05-18T09:56:53Z","created":"2026-03-15T05:10:08Z","license":"MIT","categories":[],"platforms":["levilamina"],"env":["server","client"],"gameVersions":["1.26.51","1.26.40","1.26.32","1.26.20","1.26.10"],"tags":["platform:levilamina","type:mod","minecraft-bedrock","litematica","schematic","projection"],"latest":{"variant":"","version":"3.0.1","install":"lip install github.com/copper-lamp/LitematicaBE@3.0.1"},"readmes":[{"file":"README.md","lang":"zh-Hans","text":"<div align=\"center\">\n  <img src=\"resources/pack_icon.png\" alt=\"LitematicaBE icon\" width=\"160\">\n  <h1>LitematicaBE</h1>\n  <p><strong>在基岩版里，用 Java 版 Litematica 的方式造建筑。</strong></p>\n  <p>加载与保存 <code>.litematic</code>，用半透明 ghost 方块显示投影，支持逐层建造、轻松放置与材料清单导出。</p>\n\n  <p>\n    <img src=\"https://img.shields.io/badge/release-v3.0.1-4c8bf5?style=flat-square\" alt=\"LitematicaBE v3.0.1\">\n    <img src=\"https://img.shields.io/badge/Minecraft%20Bedrock-1.21.132%2B-62b47a?style=flat-square\" alt=\"Minecraft Bedrock 1.21.132+\">\n    <img src=\"https://img.shields.io/badge/LeviLamina-26.10%2B-7b68ee?style=flat-square\" alt=\"LeviLamina 26.10+\">\n    <img src=\"https://img.shields.io/badge/LegacyScriptEngine-nodejs%200.22.x-ffb300?style=flat-square\" alt=\"LegacyScriptEngine nodejs 0.22.x\">\n    <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue?style=flat-square\" alt=\"MIT license\"></a>\n  </p>\n\n  <p>\n    <a href=\"#快速开始\">快速开始</a>\n    ·\n    <a href=\"https://github.com/copper-lamp/LitematicaBE/releases\">下载</a>\n    ·\n    <a href=\"CHANGELOG.md\">更新日志</a>\n    ·\n    <a href=\"https://github.com/copper-lamp/LitematicaBE/issues\">反馈问题</a>\n    ·\n    <a href=\"#贡献\">贡献</a>\n    ·\n    <a href=\"README_EN.md\">English</a>\n  </p>\n</div>\n\n> [!WARNING]\n> 3.x 仍在重构与预览阶段：Mega 投影、投影打印机等旧版功能尚未恢复。升级前请备份存档；插件与 addon 的版本必须一致，否则 ghost 写入会被禁用。\n\nLitematicaBE 是一个面向基岩版（BDS + LeviLamina）的投影插件：读取 Java 版 Litematica 的 `.litematic` 文件，用自定义 ghost 方块在世界中还原投影，并提供逐层建造、轻松放置、方块验证与材料清单等建筑辅助功能。保存出的 `.litematic` 可被 Java 版 Litematica 直接打开。\n\n## 快速开始\n\n> [!IMPORTANT]\n> LitematicaBE 由「服务端插件 + BP/RP 扩展包」组成。服务端与客户端都需要安装，且两者版本必须一致。\n\n1. 安装 lip（已安装可跳过）：\n\n   ```shell\n   npm install -g @levimc/lip\n   ```\n\n2. **服务端**：在 BDS 根目录执行：\n\n   ```shell\n   lip install github.com/copper-lamp/LitematicaBE\n   ```\n\n   插件会安装到 `plugins/LitematicaBE/`，BP/RP 分别安装到 `behavior_packs/` 与 `resource_packs/`。\n\n3. **客户端**：在 LeviLauncher 的「内容下载 → lip」中搜索 LitematicaBE 安装，或在客户端实例根目录执行：\n\n   ```shell\n   lip install github.com/copper-lamp/LitematicaBE#client\n   ```\n\n   无法使用 lip 的玩家可以直接导入 Release 里的 `LitematicaBE-client-<版本>.mcaddon`。\n\n4. **在世界中启用扩展包**：把 BP/RP 的 `pack_id` 与 `version` 写入 `worlds/<世界名>/world_behavior_packs.json` 和 `world_resource_packs.json`（或在世界设置界面勾选），然后重启服务器。\n\n   ```json\n   [\n     { \"pack_id\": \"<BP 的 header.uuid>\", \"version\": [1, 1, 8] }\n   ]\n   ```\n\n5. 把 `.litematic` 文件放进 `plugins/LitematicaBE/schematics/`，进游戏手持木剑蹲下点击打开主菜单。\n\n指定版本安装（推荐锁定版本）：\n\n```shell\nlip install github.com/copper-lamp/LitematicaBE@3.0.1          # 服务端\nlip install github.com/copper-lamp/LitematicaBE#client@3.0.1   # 客户端\n```\n\n升级用 `lip update github.com/copper-lamp/LitematicaBE`。`lip` 只管理服务端工作区；客户端实例由 LeviLauncher 管理，命令中的 `#client` 变体不可省略。\n\n## 兼容性\n\n| 组件 | 版本 |\n| ---- | ---- |\n| Minecraft Bedrock Server | 1.21.132+ |\n| LeviLamina | 26.10+ |\n| LegacyScriptEngine（nodejs 变体） | 0.22.x |\n| LitematicaBE 插件 / addon | 随 Release 一同发布，插件会校验两侧版本一致 |\n| 客户端平台 | Windows x64（其他平台请手动导入 `.mcaddon`） |\n\n## 功能特性\n\n| 功能 | 说明 |\n| ---- | ---- |\n| 原理图加载 | 加载 Java 版 `.litematic` 文件 |\n| 原理图保存 | 把基岩版建筑保存为 `.litematic`，与 Java 版 Litematica 互通 |\n| ghost 投影 | 自定义 ghost 方块渲染，半透明显示，贴近原版观感 |\n| 逐层建造 | 按 Y 层切换显示，抬头看上层 / 低头看下层 |\n| 轻松放置 | 手持材料对准投影精确放置，支持快速连续放置（重构中） |\n| 直接放置 | OP + 创造模式把投影方块直接写入世界（NBT 直放） |\n| 方块转换 | Java ↔ 基岩版双向映射，含 legacy 回退表 |\n| 投影管理 | 多投影存储、加载 / 卸载 / 删除、材料清单导出 |\n| Mega 投影 | 分块存储 + 流式加载 + LOD 渲染（重构中；未启用时自动回退普通渲染） |\n| 自检 | `/litematica selfcheck` 校验整条 ghost 写入链路 |\n\n### 操作方式\n\n| 操作 | 说明 |\n| ---- | ---- |\n| 手持木剑 + 蹲下 + 点击 | 打开主菜单 |\n| 抬头 / 低头 + 木剑点击 | 逐层模式时切换显示层 |\n| 平视 + 木剑点击 | 切换显示全部层 |\n| `/lit` / `/litematica` | 命令系统入口 |\n\n## 命令\n\n```shell\n# 基础命令\n/litematica menu          # 打开主菜单\n/litematica load <file>   # 加载原理图\n/litematica place <file>  # 加载并在脚下放置投影\n/litematica placeat X Y Z # 在指定坐标放置投影\n/litematica easyplace     # 切换轻松放置\n/litematica printer       # 切换投影打印机\n/litematica verify        # 验证方块放置正确性\n/litematica materials     # 生成材料清单 Excel\n/litematica save          # 保存原理图（选区模式）\n/litematica build         # 切换到建造（逐层）模式\n/litematica rotate        # 切换到旋转模式\n/litematica list          # 列出所有投影\n/litematica clear         # 清除当前投影显示\n/litematica info          # 查看投影详细信息\n/litematica debug <sub>   # 调试命令（mega/stats/config）\n/litematica selfcheck     # 投影流程自检\n\n# 工具命令\n/litematica:logclean status|clean|config   # 日志清理\n/litematica:config reload|reset|get <key>  # 配置管理\n/litematica:ghost lay|undo|info|restore    # ghost 测试\n```\n\n## 使用指南\n\n### 加载与放置投影\n\n1. 把 `.litematic` 放进 `plugins/LitematicaBE/schematics/`。\n2. 手持木剑蹲下点击打开主菜单，点击「加载投影」并选择文件。\n3. 在放置面板调整坐标（默认脚下），提交后投影显示在目标位置。\n\n### 逐层建造\n\n1. 投影操作面板中开启**逐层显示**。\n2. 木剑右键：**抬头**切到上一层，**低头**切到下一层，平视切回全部层。\n\n### 轻松放置\n\n1. 在投影操作面板开启**轻松放置**，手持材料对准投影即可精确放置。\n2. 需要连续放置时再开启**投影打印机**；再次点击菜单可关闭。\n\n### 直接放置（管理员）\n\n1. 需要 **OP 权限 + 创造模式**。\n2. 在「投影管理」中选择已放置的投影并进入详情，点击「直接放置全部方块」。\n\n### 保存原理图\n\n1. 打开菜单点击**保存投影**，点击「开始选区」，用木剑右键选取两个对角点。\n2. 选区完成后输入名称与描述，文件会保存为 `.litematic`。\n\n### 验证\n\n放置投影后在投影操作面板点击**验证投影**，系统会报告匹配 / 差异 / 缺失 / 错误方块。\n\n## 手动安装\n\n不使用 lip 时，可下载 Release 中的 `LitematicaBE-<版本>.zip`：\n\n1. 把 `plugins/LitematicaBE/` 解压到 BDS 的 `plugins/` 目录。\n2. 把 `LitematicaBE-server-BP/`、`LitematicaBE-server-RP/` 分别放到 BDS 的 `behavior_packs/` 与 `resource_packs/`。\n3. 按「快速开始」第 4 步在世界中启用扩展包，然后重启服务器。\n4. 把 `.mcaddon` 交给玩家导入客户端。\n5. 把 `.litematic` 放进 `plugins/LitematicaBE/schematics/`。\n\n## 目录结构\n\n```text\nLitematicaBE/\n├── index.js                        # 主入口\n├── manifest.json                   # LSE 插件清单\n├── tooth.json                      # lip 包描述（服务端 + 客户端变体）\n├── config.json                     # 默认配置\n├── resources/\n│   ├── pack_icon.png               # 项目图标\n│   ├── addon/                      # BP / RP / mcaddon 源\n│   └── data/                       # ghost 索引与 addon 期望版本\n├── src/                            # 核心、渲染、ghost、映射、UI 等模块\n├── tools/                          # 版本校验与发布打包脚本\n└── .github/workflows/              # CI 与 tag 发布\n```\n\n运行时目录（不随仓库提交）：`schematics/`、`mega_schematics/`、`exports/`、`data/`、`logs/`。\n\n## 从源码构建\n\n需要 Node.js 20+。构建产物输出到 `build/`：\n\n```shell\nnpm ci\nnode tools/check-version.mjs\nnpm run build\n```\n\n产物包括：\n\n| 文件 | 用途 |\n| ---- | ---- |\n| `LitematicaBE-server-<版本>.zip` | lip 服务端变体（插件 + BP/RP） |\n| `LitematicaBE-client-<版本>.zip` | lip 客户端变体（BP/RP） |\n| `LitematicaBE-<版本>.zip` | 手动安装包 |\n| `LitematicaBE-client-<版本>.mcaddon` | 手动导入兜底 |\n| `SHA256SUMS.txt` | 校验和 |\n\n## 发布流程\n\n1. 同步版本号：`package.json`、`manifest.json`、`tooth.json`，并在 `CHANGELOG.md` 写入 `## [<版本>]` 段落。\n2. 打 tag 并推送：\n\n   ```shell\n   git tag v3.0.1\n   git push origin v3.0.1\n   ```\n\n3. `.github/workflows/release.yml` 会自动校验版本一致性、构建全部产物并创建 GitHub Release；tag 含 `-preview` / `-beta` / `-rc` 时自动标记为 prerelease。\n\n## 常见问题\n\n**Q：为什么部分 3.x 功能无法使用？**\nA：第三代 LitematicaBE 正在重构，Mega 投影、投影打印机等功能暂未恢复，后续会陆续补齐。\n\n**Q：投影显示为空气或错误材质？**\nA：多为方块映射问题。Java 与基岩版方块差异较大，遇到请提交 Issue 并附上方块名与截图。\n\n**Q：ghost 写入被禁用 / 提示版本不一致？**\nA：插件、服务端 BP/RP、客户端 addon 必须同批。重新执行 `/litematica selfcheck` 查看具体项，并确认世界已启用对应扩展包。\n\n**Q：大型投影加载卡顿或失败？**\nA：Mega 模式仍在重构，当前版本对超过 30,000 方块的投影会自动回退普通渲染；超大投影仍建议先拆分或用逐层显示。\n\n**Q：轻松放置无法使用？**\nA：检查投影文件是否读取成功、方块映射是否完整，以及是否正确开启轻松放置。\n\n**Q：直接放置提示权限不足？**\nA：需要同时满足 **OP 权限** 与 **创造模式**。\n\n**Q：保存的原理图能在 Java 版打开吗？**\nA：可以，保存格式兼容 Java 版 Litematica。\n\n**Q：lip 安装后还需要做什么？**\nA：服务端仍需在世界设置中启用 BP/RP 并重启；客户端导入 addon 后同样需要在世界设置中启用。\n\n## 贡献\n\n欢迎提交 Issue 与 Pull Request。  \nQQ 群：861900673  \nGitHub：<https://github.com/copper-lamp/LitematicaBE>\n\n## 致谢\n\n- [Litematica](https://github.com/maruohon/litematica) — Java 版原理图模组，本项目数据结构兼容目标\n- [LeviLamina](https://github.com/LiteLDev/LeviLamina) — 基岩版模组加载器\n- [LegacyScriptEngine](https://github.com/LiteLDev/LegacyScriptEngine) — LSE 脚本引擎\n- [lip](https://github.com/LiteLDev/lip) — LeviLamina 包管理器\n\n## 许可证\n\nMIT License\n"},{"file":"README_EN.md","lang":"en","text":"<div align=\"center\">\n  <img src=\"resources/pack_icon.png\" alt=\"LitematicaBE icon\" width=\"160\">\n  <h1>LitematicaBE</h1>\n  <p><strong>Java Edition Litematica workflows, on Bedrock Edition.</strong></p>\n  <p>Load and save <code>.litematic</code> files, render projections with translucent ghost blocks, build layer by layer, and place blocks with easy-place and material lists.</p>\n\n  <p>\n    <img src=\"https://img.shields.io/badge/release-v3.0.1-4c8bf5?style=flat-square\" alt=\"LitematicaBE v3.0.1\">\n    <img src=\"https://img.shields.io/badge/Minecraft%20Bedrock-1.21.132%2B-62b47a?style=flat-square\" alt=\"Minecraft Bedrock 1.21.132+\">\n    <img src=\"https://img.shields.io/badge/LeviLamina-26.10%2B-7b68ee?style=flat-square\" alt=\"LeviLamina 26.10+\">\n    <img src=\"https://img.shields.io/badge/LegacyScriptEngine-nodejs%200.22.x-ffb300?style=flat-square\" alt=\"LegacyScriptEngine nodejs 0.22.x\">\n    <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue?style=flat-square\" alt=\"MIT license\"></a>\n  </p>\n\n  <p>\n    <a href=\"#quick-start\">Quick Start</a>\n    ·\n    <a href=\"https://github.com/copper-lamp/LitematicaBE/releases\">Releases</a>\n    ·\n    <a href=\"CHANGELOG.md\">Changelog</a>\n    ·\n    <a href=\"https://github.com/copper-lamp/LitematicaBE/issues\">Report an issue</a>\n    ·\n    <a href=\"#contributing\">Contributing</a>\n    ·\n    <a href=\"README.md\">简体中文</a>\n  </p>\n</div>\n\n> [!WARNING]\n> 3.x is still being refactored. Mega projections and the projection printer are not available yet. Back up your worlds before upgrading, and keep the plugin and addon versions identical — otherwise ghost writes are disabled.\n\nLitematicaBE is a projection plugin for Minecraft Bedrock Edition servers (BDS + LeviLamina). It reads Java Edition `.litematic` files, rebuilds the schematic in-world with custom ghost blocks, and provides layer-by-layer building, easy place, block verification, and material lists. Saved `.litematic` files can be opened in Java Edition Litematica.\n\n## Quick Start\n\n> [!IMPORTANT]\n> LitematicaBE ships as a server plugin plus BP/RP addon packs. Both the server and the client need them, and their versions must match.\n\n1. Install lip if you have not already:\n\n   ```shell\n   npm install -g @levimc/lip\n   ```\n\n2. **Server**: run this from the BDS root directory:\n\n   ```shell\n   lip install github.com/copper-lamp/LitematicaBE\n   ```\n\n   The plugin is installed to `plugins/LitematicaBE/`; BP and RP go to `behavior_packs/` and `resource_packs/`.\n\n3. **Client**: open **Content Download → lip** in LeviLauncher and install LitematicaBE, or run this from the client instance root:\n\n   ```shell\n   lip install github.com/copper-lamp/LitematicaBE#client\n   ```\n\n   Players who cannot use lip can import `LitematicaBE-client-<version>.mcaddon` from the release.\n\n4. **Enable the packs in your world**: add the BP/RP `pack_id` and `version` to `worlds/<world>/world_behavior_packs.json` and `world_resource_packs.json` (or tick them in the world settings), then restart the server.\n\n   ```json\n   [\n     { \"pack_id\": \"<header.uuid of the BP>\", \"version\": [1, 1, 8] }\n   ]\n   ```\n\n5. Put `.litematic` files into `plugins/LitematicaBE/schematics/`, then hold a wooden sword, sneak, and right-click to open the main menu.\n\nPin a version when installing:\n\n```shell\nlip install github.com/copper-lamp/LitematicaBE@3.0.1          # server\nlip install github.com/copper-lamp/LitematicaBE#client@3.0.1   # client\n```\n\nUpdate with `lip update github.com/copper-lamp/LitematicaBE`. `lip` only manages the server workspace; the client instance is managed by LeviLauncher, and the `#client` variant is required there.\n\n## Compatibility\n\n| Component | Version |\n| --------- | ------- |\n| Minecraft Bedrock Server | 1.21.132+ |\n| LeviLamina | 26.10+ |\n| LegacyScriptEngine (nodejs variant) | 0.22.x |\n| LitematicaBE plugin / addon | Published together; the plugin verifies both sides match |\n| Client platform | Windows x64 (use the `.mcaddon` manually on other platforms) |\n\n## Features\n\n| Feature | Description |\n| ------- | ----------- |\n| Schematic loading | Load Java Edition `.litematic` files |\n| Schematic saving | Save Bedrock builds as `.litematic`, interoperable with Java Litematica |\n| Ghost rendering | Custom ghost blocks with translucent textures, close to vanilla Litematica |\n| Layer building | Switch the visible Y layer; look up for the next layer, down for the previous |\n| Easy place | Aim at the projection with materials in hand for precise placement (being refactored) |\n| Direct placement | OP + Creative writes the whole projection with NBT |\n| Block conversion | Two-way Java ↔ Bedrock mapping with a legacy fallback table |\n| Projection management | Multiple projections, load/unload/delete, material list export |\n| Mega projections | Chunked storage + streaming + LOD (being refactored; falls back to normal rendering while disabled) |\n| Self check | `/litematica selfcheck` verifies the ghost write pipeline |\n\n### Controls\n\n| Action | Description |\n| ------ | ----------- |\n| Wooden sword + sneak + click | Open the main menu |\n| Look up / down + sword click | Switch the layer in layer mode |\n| Look straight + sword click | Show all layers |\n| `/lit` / `/litematica` | Command entry points |\n\n## Commands\n\n```shell\n# Core\n/litematica menu          # open the main menu\n/litematica load <file>   # load a schematic\n/litematica place <file>  # load and place under your feet\n/litematica placeat X Y Z # place at the given coordinates\n/litematica easyplace     # toggle easy place\n/litematica printer       # toggle the projection printer\n/litematica verify        # verify placed blocks\n/litematica materials     # export the material list as Excel\n/litematica save          # save a schematic (selection mode)\n/litematica build         # switch to build (layer) mode\n/litematica rotate        # switch to rotate mode\n/litematica list          # list projections\n/litematica clear         # clear the current projection\n/litematica info          # show projection details\n/litematica debug <sub>   # debug commands (mega/stats/config)\n/litematica selfcheck     # self check\n\n# Tools\n/litematica:logclean status|clean|config   # log cleaner\n/litematica:config reload|reset|get <key>  # configuration\n/litematica:ghost lay|undo|info|restore    # ghost diagnostics\n```\n\n## Usage\n\n### Load and place\n\n1. Put `.litematic` files into `plugins/LitematicaBE/schematics/`.\n2. Sneak + wooden sword click, choose **Load projection**, and pick a file.\n3. Adjust the position in the placement panel (default: under your feet) and submit.\n\n### Layer building\n\n1. Open the projection actions panel and enable **layer display**.\n2. Sword right-click: look **up** for the next layer, **down** for the previous, straight ahead for all layers.\n\n### Easy place\n\n1. Enable **easy place** in the projection actions panel, then aim at the projection with matching materials.\n2. Enable the **projection printer** for continuous placement; click the menu again to disable.\n\n### Direct placement (administrators)\n\n1. Requires **OP** and **Creative** mode.\n2. Open the projection details and choose **Place all blocks**.\n\n### Saving\n\n1. Click **Save projection**, start a selection, and mark two opposite corners with the sword.\n2. Enter a name and description; the file is saved as `.litematic`.\n\n### Verification\n\nChoose **Verify projection** to compare the world against the projection and report matches, differences, missing, and wrong blocks.\n\n## Manual installation\n\nDownload `LitematicaBE-<version>.zip` from the release:\n\n1. Extract `plugins/LitematicaBE/` into the BDS `plugins/` directory.\n2. Copy `LitematicaBE-server-BP/` and `LitematicaBE-server-RP/` into `behavior_packs/` and `resource_packs/`.\n3. Enable the packs as described in Quick Start step 4 and restart the server.\n4. Give `.mcaddon` to players to import on their clients.\n5. Put `.litematic` files into `plugins/LitematicaBE/schematics/`.\n\n## Repository layout\n\n```text\nLitematicaBE/\n├── index.js                        # entry point\n├── manifest.json                   # LSE plugin manifest\n├── tooth.json                      # lip package (server + client variants)\n├── config.json                     # default configuration\n├── resources/\n│   ├── pack_icon.png               # project icon\n│   ├── addon/                      # BP / RP / mcaddon sources\n│   └── data/                       # ghost index and expected addon version\n├── src/                            # core, renderer, ghost, mappings, UI\n├── tools/                          # version check and release packaging\n└── .github/workflows/              # CI and tag releases\n```\n\nRuntime directories (not committed): `schematics/`, `mega_schematics/`, `exports/`, `data/`, `logs/`.\n\n## Build from source\n\nNode.js 20+ is required. Artifacts are written to `build/`:\n\n```shell\nnpm ci\nnode tools/check-version.mjs\nnpm run build\n```\n\n| Artifact | Purpose |\n| ----- | ------- |\n| `LitematicaBE-server-<version>.zip` | lip server variant (plugin + BP/RP) |\n| `LitematicaBE-client-<version>.zip` | lip client variant (BP/RP) |\n| `LitematicaBE-<version>.zip` | manual installation |\n| `LitematicaBE-client-<version>.mcaddon` | manual import |\n| `SHA256SUMS.txt` | checksums |\n\n## Release process\n\n1. Sync the version in `package.json`, `manifest.json`, and `tooth.json`, and add a `## [<version>]` section to `CHANGELOG.md`.\n2. Tag and push:\n\n   ```shell\n   git tag v3.0.1\n   git push origin v3.0.1\n   ```\n\n3. `.github/workflows/release.yml` validates version consistency, builds every artifact, and creates the GitHub Release. Tags containing `-preview`, `-beta`, or `-rc` are published as prereleases.\n\n## FAQ\n\n**Q: Why are some 3.x features unavailable?**\nA: The third-generation rewrite is in progress. Mega projections and the projection printer are not restored yet.\n\n**Q: The projection shows air or wrong textures.**\nA: Usually a block mapping issue. Report it with the block name and a screenshot.\n\n**Q: Ghost writes are disabled / version mismatch.**\nA: The plugin, server BP/RP, and client addon must come from the same build. Run `/litematica selfcheck` and make sure the packs are enabled in the world.\n\n**Q: Large projections are slow or fail to load.**\nA: Mega mode is still being refactored; projections above 30,000 blocks now fall back to normal rendering. Very large ones are still better split or built layer by layer.\n\n**Q: Easy place does not work.**\nA: Check that the schematic loaded, the block mappings are complete, and easy place is enabled.\n\n**Q: Direct placement says permission denied.**\nA: It requires both **OP** and **Creative** mode.\n\n**Q: Can saved schematics be opened in Java Edition?**\nA: Yes, the format is compatible with Java Litematica.\n\n**Q: Anything else after installing with lip?**\nA: Enable BP/RP in the world settings and restart; client players also need to enable the packs after importing the addon.\n\n## Contributing\n\nIssues and pull requests are welcome.\nQQ group: 861900673\nGitHub: <https://github.com/copper-lamp/LitematicaBE>\n\n## Acknowledgements\n\n- [Litematica](https://github.com/maruohon/litematica) — the Java Edition schematic mod this project stays compatible with\n- [LeviLamina](https://github.com/LiteLDev/LeviLamina) — Bedrock mod loader\n- [LegacyScriptEngine](https://github.com/LiteLDev/LegacyScriptEngine) — LSE script engine\n- [lip](https://github.com/LiteLDev/lip) — LeviLamina package manager\n\n## License\n\nMIT License\n"}],"gallery":[],"variants":[{"label":"","versions":["3.0.1"]},{"label":"client","versions":["3.0.1"]}],"versions":[{"version":"3.0.1","prerelease":false,"released":"2026-10-31T06:24:41Z","releaseUrl":"https://github.com/copper-lamp/LitematicaBE/releases/tag/v3.0.1","manifestUrl":"https://github.com/copper-lamp/LitematicaBE/blob/v3.0.1/tooth.json","info":{"name":"LitematicaBE","description":"LSE投影插件：支持 .litematic格式的原理图，幽灵方块投影、逐层建造与轻松放置","tags":["platform:levilamina","type:mod","minecraft-bedrock","litematica","schematic","projection"],"avatar_url":"https://raw.githubusercontent.com/copper-lamp/LitematicaBE/main/resources/pack_icon.png"},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":">=26.10.0","github.com/LiteLDev/LegacyScriptEngine#nodejs":"^0.22.3"},"leviLamina":">=26.10.0","install":"lip install github.com/copper-lamp/LitematicaBE@3.0.1"},{"label":"client","platform":"win-x64","dependencies":{},"install":"lip install github.com/copper-lamp/LitematicaBE#client@3.0.1"}]}],"dependencies":{"github.com/liteldev/levilamina":{"tooth":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"},"github.com/liteldev/legacyscriptengine":{"tooth":"github.com/LiteLDev/LegacyScriptEngine","name":"LegacyScriptEngine","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LegacyScriptEngine/"}},"requiredBy":[]}