{"url":"https://levimc.org/mods/github.com/copper-lamp/LitematicaBE/","id":"github.com/copper-lamp/LitematicaBE","name":"LitematicaBE","description":"LLBDS 服务端投影插件，基岩版服务器一站式投影集成的最佳方案","owner":"copper-lamp","logo":"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":23,"downloads":461,"updated":"2026-11-13T20:12:11Z","published":"2026-05-18T09:56:53Z","created":"2026-03-15T05:10:08Z","license":"AGPL-3.0","side":["server"],"platform":["win-x64"],"gameVersions":["1.26.60","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.1.0","install":"lip install github.com/copper-lamp/LitematicaBE@3.1.0"},"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>基岩版服务器一站式投影集成的最佳方案</strong></p>\n  <p>兼容 bedrock / java 双版本结构投影文件，使用 georetry 原生渲染，全服共享并发控制，优秀版本兼容性，一站式集成投影功能</p>\n\n  <p>\n    <img src=\"https://img.shields.io/badge/release-v3.1.0-4c8bf5?style=flat-square\" alt=\"LitematicaBE v3.1.0\">\n    <img src=\"https://img.shields.io/badge/Minecraft%20Bedrock-1.21.70%2B-62b47a?style=flat-square\" alt=\"Minecraft Bedrock 1.21.70+\">\n    <img src=\"https://img.shields.io/badge/LeviLamina-1.2.0%2B-7b68ee?style=flat-square\" alt=\"LeviLamina 1.2.0+\">\n    <img src=\"https://img.shields.io/badge/LegacyScriptEngine-nodejs%200.11.1+-ffb300?style=flat-square\" alt=\"LegacyScriptEngine nodejs 0.11.1+\">\n    <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-AGPL 3.0-blue?style=flat-square\" alt=\"AGPL-3.0 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\nLitematicaBE 是一个面向基岩版（BDS + LeviLamina）服务端的投影集成插件：跨版本兼容能力，适用大部分服务端。同时支持读取 .litematica 及 .mcstructure 双格式。采用 geometry 原生自定义方块写入投影，支持超大文件、逐层查看、投影打印机、一键放置、投影及结构文件导出等实用功能。致力于为基岩版服务器提供一站式投影服务。\n\n## 快速开始\n\n> [!IMPORTANT]\n> LitematicaBE 由「服务端插件 + BP/RP 扩展包」组成，全部内容在 LLBDS 服务端装载，玩家进入服务器自动推送资源包。\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. **启用扩展包**：把 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\n4. 上传结构或投影文件：\n- 服务器管理员：把需要加载的文件手动放入 `plugins/LitematicaBE/schematics/`\n- 普通玩家：访问本插件提供的服务器上传站地址并上传你的文件（见使用指南部分）\n\n指定版本安装（推荐锁定版本）：\n\n```shell\nlip install github.com/copper-lamp/LitematicaBE@3.1.0\n```\n\n升级用 `lip update github.com/copper-lamp/LitematicaBE`。\n\n## 兼容性\n\n| 组件 | 版本 |\n| ---- | ---- |\n| Minecraft Bedrock Server | 1.21.70+ |\n| LeviLamina | 1.2.0+ |\n| LegacyScriptEngine（nodejs 变体） | 0.11.0+ |\n| LitematicaBE 插件 / addon | 随 Release 一同发布 |\n- tip：本插件对服务端版本不敏感，以上为理论兼容范围，若存在兼容问题请报告处理。\n\n## 功能特性\n\n| 功能 | 说明 |\n| ---- | ---- |\n| 原理图加载 | 支持加载 Java 版 `.litematic` 或基岩版 `.mcstructure` 文件 |\n| 原理图保存 | 把选区保存为 `.litematic`（与 Java 版 Litematica mod 互通）或基岩版 `.mcstructure`（可直接用结构方块加载）；导出时可选格式，也可两者同时导出 |\n| 投影放置 | geometry 方块原生渲染，半透明显示，最贴近原版观感 |\n| 逐层建造 | 手持木剑右键切换显示，抬头看上层 / 低头看下层 |\n| 轻松放置 | 手持材料对准投影即可精确放置 |\n| 投影打印机 | 开启后自动打印范围内投影，可限速、可逐层 |\n| 直接放置 | OP + 创造模式把投影直接写入世界（NBT 直放） |\n| 投影管理 | 多投影同时储存，全服玩家共享可见，自由切换控制，支持材料清单导出 |\n| Mega 投影 | 分块存储、流式加载，最高可支持百万级超大型投影加载 |\n| http上传站 | 插件内置 http 服务器，允许全体玩家自助上传投影文件，且无需重启即生效 |\n| 更新检查 | 插件激活时自动检查仓库并提示新版本（可在 config 关闭该功能） |\n\n### 操作方式\n\n| 操作 | 说明 |\n| ---- | ---- |\n| 手持木剑 + 蹲下 + 点击 | 打开主菜单 |\n| 抬头 / 低头 + 木剑右键 | 建造模式时切换显示层 |\n| 平视 + 木剑点击 | 切换显示全部层 |\n| `/lit` / `/litematica` | 命令系统入口 |\n\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       # 切换投影打印机（也可用 /lit 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:web status|start|stop|restart  # 网页上传站\n/litematica:web token|url                  # 查看/重生成上传令牌、访问地址\n```\n\n## 使用指南\n\n### 加载与放置投影\n\n1. 把 `.litematic` 或 `.mcstructure` 文件放进 `plugins/LitematicaBE/schematics/`。\n2. 手持木剑蹲下点击打开 LitematicaBE 主菜单，点击「加载投影」并选择文件。\n3. 在放置面板调整坐标，提交后投影显示在目标位置。\n\n### 网页上传投影结构文件\n\n服务器启动时插件会拉起一个轻量 HTTP 上传站。\n\n1. 在 `config.json` 中设置服务器公网 IP 并开放相应端口（默认8080）（NAT 网络需部署反代）；\n2. 服务端启动后控制台输出：`[Web] 上传站已启动 http://<地址>:8080/`；\n3. 若启用令牌认证：令牌首次自动生成并写入 `plugins/LitematicaBE/data/web_token.txt`；也可用 `/litematica:web token` 重新生成（旧地址立即失效）；\n4. 浏览器打开地址，选择上传 `.litematic` / `.mcstructure` ，文件自动放入 `plugins/LitematicaBE/schematics/`，游戏内立刻可用，无需重启。\n5. 上传方式为分片 + base64，单文件上限 `web.maxFileMB`（默认 64MB），支持断点续传。\n\n上传站配置参数见 `config.json`\n\n### 逐层建造\n\n1. 投影操作面板中开启**逐层显示**。\n2. 木剑右键：**抬头**切到上一层，**低头**切到下一层，平视切回全部层。\n\n### 轻松放置\n\n1. 在投影操作面板开启**轻松放置**，手持材料对准投影即可精确放置。\n2. 同时具有**投影打印机**功能（`/litematica printer` 或 `/lit printer`）；再次点击菜单可关闭。\n3. 打印机只填 ghost / 空气 / 花草雪水这类可替换方块，**不会覆盖其它方块**；逐层模式下只放当前层。\n\n打印机配置参数见 `config.json`\n\n### 直接放置（管理员）\n\n1. 需要 **OP 权限 + 创造模式**；\n2. 在「投影管理」中选择已放置的投影并进入详情，点击「直接放置全部方块」。\n\n### 保存原理图\n\n1. 打开菜单点击**保存投影**，点击「开始选区」，用木剑右键选取两个对角点；\n2. 选区完成后先在表单顶部的「导出格式」里选：`.litematic`（Java 版投影文件）/ `.mcstructure`（基岩版结构文件）/ 两者都导出；\n3. 再输入名称与描述（可选）即可保存。\n\n### 验证\n\n放置投影后在投影操作面板点击**验证投影**，系统会报告匹配 / 差异 / 缺失 / 错误方块。\n\n### 版本更新检查\n\n服务端启动、插件被激活时，向 GitHub Release 联网检查版本更新。\n\n更新检查配置见 `config.json`\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 步在世界中启用扩展包，然后重启服务器。\n\n## 目录结构\n\n```text\nLitematicaBE/\n├── index.js                        # 插件入口\n├── manifest.json                   # LSE 插件清单\n├── tooth.json                      # lip 包清单（v3）\n├── config.json                     # 用户配置\n├── package.json                    # 运行时依赖（仅 xlsx）\n├── src/\n│   ├── core/                       # 功能核心\n│   ├── render/                     # 渲染调度\n│   ├── ghost/                      # ghost 方块注册/守护/校验，addon 版本一致性检查\n│   ├── easyplace/                  # 轻松放置：射线、库存、放置校验\n│   ├── mappings/                   # Java ↔ 基岩方块/状态映射\n│   ├── net/                        # 更新检查\n│   ├── ui/                         # 表单 UI\n│   ├── utils/                      # 材质统计等工具\n│   ├── data/                       # 存档、世界快照\n│   ├── world/                      # 世界相关模块\n│   └── web/                        # 内置 HTTP 上传站\n├── resources/\n│   ├── pack_icon.png               # 项目图标\n│   ├── addon/                      # BP / RP 源文件（LitematicaBE_BP、_RP）\n│   └── data/                       # 运行时索引：ghost_index.json、addon_expected.json\n├── tools/                          # 构建工具\n├── tests/                          # 离线回归测试\n└── .github/workflows/              # ci.yml（push/PR 校验 + 测试 + 构建）、release.yml（tag → Release）\n```\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-<版本>.zip` | 手动安装包（包含插件本体与资源包） |\n| `SHA256SUMS.txt` | 校验和 |\n\n## 常见问题\n\n**Q：为什么我发现部分功能存在问题？**\nA：第三代 LitematicaBE 正在重构更新中，部分功能尚未经大范围严格测试，若发现问题请向开发者反馈处理。\n\n**Q：投影显示为未知或错误材质？**\nA：多为方块映射问题。Java 与基岩版方块差异较大，遇到请提交 Issue 并附上方块名与截图。\n\n**Q：ghost 写入被禁用 / 提示版本不一致？**\nA：插件与服务端 addon（BP/RP） 必须为同批版本。重新执行 `/litematica selfcheck` 查看具体项，并确认世界已启用对应扩展包。\n\n**Q：大型投影加载卡顿？**\nA：受限于基岩版，帧率取决于玩家客户端渲染能力，服务端插件无法直接解决该问题。数十万级超大投影建议先拆分或用逐层显示。（后期将推出相应优化）\n\n**Q：保存的原理图能在 Java 版打开吗？**\nA： 以 `.litematic` 格式导出能接兼容 Java 版 Litematica 并直接使用。\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 版原理图模组，对 Minecraft 投影生态影响深远\n- [LeviDev](https://github.com/LiteLDev) — 由 LeviMC 开发的 Levilamina 及 LegacyScriptEngine 为本项目功能实现提供了基础\n- [EasyPlace](https://github.com/wyl-gq/EasyPlace) — 借鉴其部分功能实现\n- 以及所有为 LitematicaBE 作出贡献的开发者\n\n## 许可证\n\n- LitematicaBE 项目使用 AGPL-3.0 许可证。\n- 使用修改版本并分发或用于提供服务时必须继续使用 AGPL-3.0，并公开源代码。\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>The Optimal Solution for One-Stop Projection Integration on Minecraft Bedrock Servers</strong></p>\n  <p>Compatible with both bedrock / java dual-version structure projection files, uses native geometry rendering, server-wide shared concurrency control, excellent version compatibility, and one-stop projection integration.</p>\n\n  <p>\n    <img src=\"https://img.shields.io/badge/release-v3.1.0-4c8bf5?style=flat-square\" alt=\"LitematicaBE v3.1.0\">\n    <img src=\"https://img.shields.io/badge/Minecraft%20Bedrock-1.21.70%2B-62b47a?style=flat-square\" alt=\"Minecraft Bedrock 1.21.70+\">\n    <img src=\"https://img.shields.io/badge/LeviLamina-1.2.0%2B-7b68ee?style=flat-square\" alt=\"LeviLamina 1.2.0+\">\n    <img src=\"https://img.shields.io/badge/LegacyScriptEngine-nodejs%200.11.1+-ffb300?style=flat-square\" alt=\"LegacyScriptEngine nodejs 0.11.1+\">\n    <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-AGPL 3.0-blue?style=flat-square\" alt=\"AGPL-3.0 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\">Downloads</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\nLitematicaBE is a projection integration plugin for Bedrock Edition (BDS + LeviLamina) servers: cross-version compatibility that works with most servers. It reads both `.litematic` and `.mcstructure` formats. Projections are written with native geometry custom blocks, and it supports very large files, layer-by-layer viewing, a projection printer, one-click placement, and schematic/structure file export. It aims to provide one-stop projection services for Bedrock servers.\n\n## Quick Start\n\n> [!IMPORTANT]\n> LitematicaBE consists of a server plugin plus BP/RP addon packs. Everything is loaded on the LLBDS server, and the resource pack is automatically pushed to players when they join.\n\n1. Install lip (skip if already installed):\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/`; the BP and RP are installed to `behavior_packs/` and `resource_packs/` respectively.\n\n3. **Enable the packs**: write the BP/RP `pack_id` and `version` into `worlds/<world name>/world_behavior_packs.json` and `world_resource_packs.json` (or enable them in the world and upload the world to the server), then restart the server.\n\n   ```json\n   [\n     { \"pack_id\": \"<header.uuid of the BP>\", \"version\": [1, 1, 8] }\n   ]\n   ```\n\n4. Upload the structure or projection file:\n- Server administrators: manually place the files to load into `plugins/LitematicaBE/schematics/`\n- Regular players: visit the plugin's server upload station and upload your files (see the Usage guide below)\n\nInstall a specific version (recommended to pin a version):\n\n```shell\nlip install github.com/copper-lamp/LitematicaBE@3.1.0\n```\n\nUpgrade with `lip update github.com/copper-lamp/LitematicaBE`.\n\n## Compatibility\n\n| Component | Version |\n| --------- | ------- |\n| Minecraft Bedrock Server | 1.21.70+ |\n| LeviLamina | 1.2.0+ |\n| LegacyScriptEngine (nodejs variant) | 0.11.0+ |\n| LitematicaBE plugin / addon | Published together with each release |\n- Note: this plugin is not sensitive to the server version; the above is the theoretical compatibility range. Please report any compatibility issues you find.\n\n## Features\n\n| Feature | Description |\n| ------- | ----------- |\n| Schematic loading | Load Java Edition `.litematic` or Bedrock `.mcstructure` files |\n| Schematic saving | Save a selection as `.litematic` (interoperable with the Java Edition Litematica mod) or Bedrock `.mcstructure` (loadable directly with structure blocks); the format is chosen at export, or you can export both at once |\n| Projection placement | Rendered with native geometry blocks, translucent display, closest to the vanilla look |\n| Layer-by-layer building | Right-click with a wooden sword to switch the display; look up for the upper layer, down for the lower layer |\n| Easy place | Aim at the projection with materials in hand to place precisely |\n| Projection printer | When enabled, automatically prints the projection in range; rate-limited and layer-aware |\n| Direct placement | OP + Creative writes the projection directly into the world (NBT placement) |\n| Projection management | Store multiple projections at once, visible to all players on the server, freely switch control, material list export |\n| Mega projection | Chunked storage, streaming load, supports up to million-block ultra-large projections |\n| HTTP upload station | Built-in HTTP server that lets all players upload projection files themselves, effective without a restart |\n| Update check | Automatically checks the repository when the plugin is activated and notifies of a new version (can be disabled in config) |\n\n### Controls\n\n| Action | Description |\n| ------ | ----------- |\n| Wooden sword + sneak + click | Open the main menu |\n| Look up / down + sword right-click | Switch the displayed layer in build mode |\n| Look straight + sword click | Show all layers |\n| `/lit` / `/litematica` | Command entry points |\n\n## Commands\n- The commands below can also be operated visually through the wooden sword main menu\n\n```shell\n# Core commands\n/litematica menu          # open the main menu\n/litematica load <file>   # load a schematic\n/litematica place <file>  # load and place a projection at your feet\n/litematica placeat X Y Z # place a projection at the given coordinates\n/litematica easyplace     # toggle easy place\n/litematica printer       # toggle the projection printer (also `/lit printer`)\n/litematica verify        # verify block placement correctness\n/litematica materials     # generate the material list 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 all projections\n/litematica clear         # clear the current projection display\n/litematica info          # show projection details\n/litematica debug <sub>   # debug commands (mega/stats/config)\n/litematica selfcheck     # self-check the projection generation pipeline\n\n# Utility commands\n/litematica:logclean status|clean|config   # log cleaner\n/litematica:config reload|reset|get <key>  # configuration\n/litematica:web status|start|stop|restart  # web upload station\n/litematica:web token|url                  # view/regenerate the upload token and access URL\n```\n\n## Usage\n\n### Loading and placing a projection\n\n1. Put the `.litematic` or `.mcstructure` file into `plugins/LitematicaBE/schematics/`.\n2. Sneak and click with a wooden sword to open the LitematicaBE main menu, click **Load projection**, and pick a file.\n3. Adjust the coordinates in the placement panel; after submitting, the projection appears at the target position.\n\n### Uploading projection files via the web\n\nThe plugin starts a lightweight HTTP upload station when the server starts.\n\n1. Set the server's public IP in `config.json` and open the corresponding port (default 8080) (NAT networks need a reverse proxy);\n2. After the server starts, the console prints: `[Web] Upload station started at http://<address>:8080/`;\n3. If token authentication is enabled: the token is auto-generated on first use and written to `plugins/LitematicaBE/data/web_token.txt`; you can also use `/litematica:web token` to regenerate it (the old address stops working immediately);\n4. Open the address in a browser, choose to upload a `.litematic` / `.mcstructure`, and the file is automatically placed into `plugins/LitematicaBE/schematics/`, usable in-game immediately with no restart.\n5. Upload uses chunked + base64 transfer, with a per-file limit of `web.maxFileMB` (default 64MB) and resumable upload support.\n\nSee `config.json` for the upload station configuration.\n\n### Layer-by-layer building\n\n1. Enable **layer display** in the projection actions panel.\n2. Sword right-click: look **up** for the next layer, look **down** for the previous layer, look straight ahead to return to all layers.\n\n### Easy place\n\n1. Enable **easy place** in the projection actions panel, then aim at the projection with materials in hand to place precisely.\n2. It also has the **projection printer** feature (`/litematica printer` or `/lit printer`); click the menu again to disable it.\n3. The printer only fills ghost / air / replaceable blocks such as grass, flowers, snow, and water; it will **never overwrite other blocks**; in layer mode it only places the current layer.\n\nSee `config.json` for the printer configuration.\n\n### Direct placement (administrators)\n\n1. Requires **OP** and **Creative** mode;\n2. In **Projection management**, choose the placed projection, open its details, and click **Place all blocks directly**.\n\n### Saving a schematic\n\n1. Open the menu, click **Save projection**, click **Start selection**, and mark two opposite corners with a wooden sword right-click;\n2. After selecting, first choose the **export format** at the top of the form: `.litematic` (Java Edition projection file) / `.mcstructure` (Bedrock structure file) / export both;\n3. Then enter a name and an optional description to save.\n\n### Verification\n\nAfter placing a projection, click **Verify projection** in the projection actions panel; the system reports matching / differing / missing / wrong blocks.\n\n### Version update check\n\nWhen the server starts and the plugin is activated, it checks GitHub Releases over the network for version updates.\n\nSee `config.json` for the update check configuration.\n\n## Manual installation\n\nWhen not using lip, download `LitematicaBE-<version>.zip` from the release:\n\n1. Extract `plugins/LitematicaBE/` into the BDS `plugins/` directory;\n2. Place `LitematicaBE-server-BP/` and `LitematicaBE-server-RP/` into the BDS `behavior_packs/` and `resource_packs/` respectively;\n3. Enable the packs in the world as described in Quick Start step 4, then restart the server.\n\n## Repository layout\n\n```text\nLitematicaBE/\n├── index.js                        # plugin entry point\n├── manifest.json                   # LSE plugin manifest\n├── tooth.json                      # lip package manifest (v3)\n├── config.json                     # user configuration\n├── package.json                    # runtime dependency (xlsx only)\n├── src/\n│   ├── core/                       # feature core\n│   ├── render/                     # rendering scheduling\n│   ├── ghost/                      # ghost block registration/guard/validation, addon version consistency check\n│   ├── easyplace/                  # easy place: ray, inventory, placement validation\n│   ├── mappings/                   # Java ↔ Bedrock block/state mappings\n│   ├── net/                        # update check\n│   ├── ui/                         # form UI\n│   ├── utils/                      # material stats and other utilities\n│   ├── data/                       # save data, world snapshots\n│   ├── world/                      # world-related modules\n│   └── web/                        # built-in HTTP upload station\n├── resources/\n│   ├── pack_icon.png               # project icon\n│   ├── addon/                      # BP / RP source files (LitematicaBE_BP, _RP)\n│   └── data/                       # runtime index: ghost_index.json, addon_expected.json\n├── tools/                          # build tools\n├── tests/                          # offline regression tests\n└── .github/workflows/              # ci.yml (push/PR validation + tests + build), release.yml (tag → Release)\n```\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\nArtifacts include:\n\n| File | Purpose |\n| ---- | ------- |\n| `LitematicaBE-<version>.zip` | Manual installation package (contains the plugin and resource packs) |\n| `SHA256SUMS.txt` | Checksums |\n\n## FAQ\n\n**Q: Why do I find some features problematic?**\nA: The third-generation LitematicaBE is still being refactored; some features have not been widely and strictly tested yet. If you find an issue, please report it to the developer.\n\n**Q: The projection shows unknown or wrong textures.**\nA: Usually a block mapping issue. Java and Bedrock blocks differ significantly; if you run into this, submit an Issue with the block name and a screenshot.\n\n**Q: Ghost writes are disabled / a version mismatch is reported?**\nA: The plugin and the server addon (BP/RP) must be from the same batch version. Re-run `/litematica selfcheck` to see the specific items, and confirm the world has the corresponding packs enabled.\n\n**Q: Large projections lag when loading?**\nA: Due to Bedrock limitations, the frame rate depends on the player client's rendering capability; the server plugin cannot directly solve this. For ultra-large projections of hundreds of thousands of blocks, split them first or use layer-by-layer display. (Optimizations will be released later.)\n\n**Q: Can saved schematics be opened in Java Edition?**\nA: Exports in `.litematic` format are compatible with Java Edition Litematica and can be used directly.\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, which has had a profound impact on the Minecraft projection ecosystem\n- [LeviDev](https://github.com/LiteLDev) — LeviLamina and LegacyScriptEngine developed by LeviMC provide the foundation for this project's features\n- [EasyPlace](https://github.com/wyl-gq/EasyPlace) — some feature implementations are borrowed from it\n- And all the developers who have contributed to LitematicaBE\n\n## License\n\n- The LitematicaBE project is licensed under AGPL-3.0.\n- Modified versions that are distributed or used to provide a service must remain under AGPL-3.0 and provide the corresponding source code.\n"}],"gallery":[],"versions":[{"version":"3.1.0","prerelease":false,"released":"2026-11-13T20:12:11Z","releaseUrl":"https://github.com/copper-lamp/LitematicaBE/releases/tag/v3.1.0","manifestUrl":"https://github.com/copper-lamp/LitematicaBE/blob/v3.1.0/tooth.json","info":{"name":"LitematicaBE","description":"LLBDS 服务端投影插件，基岩版服务器一站式投影集成的最佳方案","tags":["platform:levilamina","type:mod","minecraft-bedrock","litematica","schematic","projection"],"logo":"https://raw.githubusercontent.com/copper-lamp/LitematicaBE/main/resources/pack_icon.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":">=26.10.0","github.com/LiteLDev/LegacyScriptEngine#nodejs":"^0.22.3"}}]}},{"version":"3.0.2","prerelease":false,"released":"2026-11-01T11:02:08Z","releaseUrl":"https://github.com/copper-lamp/LitematicaBE/releases/tag/v3.0.2","manifestUrl":"https://github.com/copper-lamp/LitematicaBE/blob/v3.0.2/tooth.json","info":{"name":"LitematicaBE","description":"LSE投影插件：支持 .litematic格式的原理图，幽灵方块投影、逐层建造与轻松放置","tags":["platform:levilamina","type:mod","minecraft-bedrock","litematica","schematic","projection"],"logo":"https://raw.githubusercontent.com/copper-lamp/LitematicaBE/main/resources/pack_icon.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":">=26.10.0","github.com/LiteLDev/LegacyScriptEngine#nodejs":"^0.22.3"}}],"client":[{"side":"server","platform":"win-x64","deps":{}},{"side":"client","platform":"win-x64","deps":{}}]}},{"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"],"logo":"https://raw.githubusercontent.com/copper-lamp/LitematicaBE/main/resources/pack_icon.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":">=26.10.0","github.com/LiteLDev/LegacyScriptEngine#nodejs":"^0.22.3"}}],"client":[{"side":"server","platform":"win-x64","deps":{}},{"side":"client","platform":"win-x64","deps":{}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"},"github.com/liteldev/legacyscriptengine":{"id":"github.com/LiteLDev/LegacyScriptEngine","name":"LegacyScriptEngine","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LegacyScriptEngine/"}},"requiredBy":[]}