Blueprints+

为建造者打造的智能、可复用的蓝图。即时捕捉建筑,预览带有旋转/镜像的半透明轮廓(幽灵),并以单元为单位放置结果——支持单人游戏和服务器。
功能
- 幽灵预览(客户端)
- 在准星指向的方块面上切换蓝图的实时幽灵预览。
- 两种预览模式:带纹理的方块 + 轮廓线,或仅轮廓线(可切换)。
- 支持绕 Y 轴旋转(90°步进)、沿 X/Z 轴镜像,以及在 XYZ 方向上微调。
- 状态感知放置(客户端→服务器)
- 定向方块会随结构一起旋转/镜像(例如 FACING、HORIZONTAL_FACING、AXIS、16 步旋转以及常见的方向性侧面属性)。
- 门在镜像时会自动翻转合页方向,以获得自然的效果。
- 选取范围抓取(服务器命令)
/bp grab <name>:捕获与被注视方块相连的所有方块(6 个方向),排除地面方块,且不会低于起始 Y 坐标,不包含液体。
- 安全上限设为 8000 个方块。
- 本地/服务器浏览器(客户端)
- 按
I 打开浏览器窗口(对话框)。
- 标签页:本地(默认)和服务器。
- 本地列表显示
.minecraft/blueprints(开发环境:run/blueprints)。服务器列表通过联网显示服务器上的 blueprints/ 目录内容。
- 即时加载(无需确认)。服务器蓝图会流式传输到客户端进行预览(无需复制文件)。
- 可从任一标签页删除蓝图(本地直接移除文件;服务器端删除并刷新列表)。
- 可从任一标签页重命名已保存的蓝图(本地重命名文件;服务器端重命名并刷新列表)。
- 键盘导航:上下键翻页,PageUp/PageDown 翻页,Enter(加载),Delete(移除),R(刷新),Esc(关闭)。
- 多人联机就绪
- 客户端负责预览与控制,服务器负责放置与命令。要在客户端和服务器上均安装该模组以启用完整功能。
控制方式(默认)
Y — 切换幽灵开启/关闭
U — 顺时针旋转(按住 Shift 为逆时针)
T — 循环镜像(无 → X → Z → 无)
- 方向键左右 — 微调 X/Z 轴
- PageUp / PageDown — 微调 Y 轴
O — 切换预览模式(方块+轮廓线 ↔ 仅轮廓线)
I — 打开浏览器(本地/服务器标签页;支持加载/刷新/删除/关闭)
Enter — 放置幽灵(服务器执行方块放置;幽灵自动关闭)
Backspace — 取消/隐藏幽灵
命令(服务器)
所有 /bp 命令均在服务器端运行。需要创造模式以确保安全。
/bp grab <name> — 从被注视的方块处捕获相连的方块(严格限制:仅相连方块,无地面,无液体,不低于起始 Y 坐标)。
/bp list — 列出服务器上的文件。
/bp remove — 注视一个结构并打开确认对话框(Enter=是,Esc=否)以删除相连的建筑。安全机制:仅限相连方块,无地面/液体,不低于起始 Y 坐标,上限 8000 个方块。
捕获的文件保存在 server_root/blueprints/<name>.nbt。
文件位置
- 客户端本地标签页:
.minecraft/blueprints/(开发环境:run/blueprints/)。
- 服务器标签页:
server_root/blueprints/(自动列出/流式传输)。
旋转与镜像细节
在放置时,我们会转换每个方块的 BlockState 以匹配预览变换:
- 旋转(Y 轴):旋转 HORIZONTAL_FACING/FACING、AXIS/HORIZONTAL_AXIS、ROTATION(16 步)以及名为 north/east/south/west 的方向性侧面属性(例如墙壁高度)。
- 镜像(X 或 Z):镜像 HORIZONTAL_FACING/FACING;门的合页方向 LEFT↔RIGHT 翻转;方向性侧面属性相应镜像。
- 依赖邻居的形状(楼梯 SHAPE、墙/板/栅栏连接)通常在放置后自然更新。如果发现未更新的案例,请提交 Issue,我们将添加针对性的规则或刷新步骤。
安装
客户端(必需):
- Fabric Loader: 0.16.x
- Fabric API: 0.116.4+1.21.1
- Java: 21
- 将
blueprintsplus-<version>.jar 放入 .minecraft/mods/。
服务器:
- 相同的 Fabric Loader + Fabric API + Java 21。
- 将相同的
blueprintsplus-<version>.jar 放入 server_root/mods/ 并重启服务器。
注意:即使服务器未安装该模组,客户端预览仍可正常工作,但放置/命令以及服务器标签页需要服务器上安装了该模组。
故障排除
- “结构在服务器上无法旋转”:确保服务器模组 jar 的版本号(含构建编号 +buildN)与客户端 jar 一致。
- “浏览器服务器标签页显示为空”:在服务器上安装该模组,并在游戏中尝试
/bp list 以确认服务器文件存在。
- “预览不透明/性能沉重”:按
O 切换到仅轮廓线模式。默认启用了距离剔除(约 128 个方块)。
- “放置后墙壁/楼梯角落异常”:依赖邻居的形状可能需要一次世界刻更新。如需添加精确的形状规则,请报告具体的方块。
Blueprints+

Smart, reusable blueprints for builders. Capture builds instantly, preview a ghost with rotation/mirror, and place the result as a unit — single‑player and servers.
Features
- Ghost Preview (client)
- Toggle a live ghost of your blueprint at the block face under the crosshair.
- Two preview modes: textured blocks + outlines, or outlines‑only (toggle)
- Rotate (90° steps around Y), mirror (X/Z), and nudge in XYZ.
- State‑aware placement (client→server)
- Oriented blocks rotate/mirror with the structure (e.g., FACING, HORIZONTAL_FACING, AXIS, 16‑step rotations, and common directional side properties).
- Doors flip hinge in mirror for a natural result.
- Grab selection (server command)
- /bp grab <name>: capture all blocks attached to the looked‑at block (6‑dir), never ground, never below your start Y, no liquids.
- Hard cap 8000 blocks for safety.
- Local/Server Browser (client)
- Press I to open the Browser window (dialog).
- Tabs: Local (default) and Server.
- Local lists .minecraft/blueprints (dev: run/blueprints). Server lists the server’s blueprints/ via networking.
- Load instantly (no confirmation). Server blueprints stream to the client for preview (no copying required).
- Delete from either tab (Local removes file; Server deletes on server and refreshes list).
- Rename saved blueprints from either tab (Local renames the file; Server renames on server and refreshes list).
- Keyboard navigation: Up/Down, PageUp/PageDown, Enter (Load), Delete (Remove), R (Refresh), Esc (Close).
- Multiplayer ready
- Client preview + controls, server placement + commands. Install the mod on both client and server for full functionality.
Controls (default)
- Y — Toggle ghost on/off
- U — Rotate CW (hold Shift for CCW)
- T — Mirror cycle (None → X → Z → None)
- Arrow keys — Nudge X/Z
- PageUp / PageDown — Nudge Y
- O — Toggle preview mode (Blocks+Outlines ↔ Outlines‑only)
- I — Open Browser (Local/Server tabs; Load/Refresh/Delete/Close)
- Enter — Place the ghost (server places blocks; ghost auto‑closes)
- Backspace — Cancel/hide ghost
Commands (server)
All /bp commands are server‑side. Creative‑mode required for safety.
- /bp grab <name> — capture attached blocks from the looked‑at block (strict: attached‑only, no ground, no liquids, never below start Y).
- /bp list — list files on the server.
- /bp remove — look at a structure and open a confirm dialog (Enter=Yes, Esc=No) to delete the attached build. Safety: attached‑only, no ground/liquids, never below start Y, cap 8000.
Captured files are saved under server_root/blueprints/<name>.nbt.
File locations
- Client Local tab: .minecraft/blueprints/ (dev: run/blueprints/).
- Server tab: server_root/blueprints/ (auto‑listed/streamed).
Rotation & mirroring details
On placement we transform every block’s BlockState to match the preview transform:
- Rotate (Y axis): HORIZONTAL_FACING/FACING, AXIS/HORIZONTAL_AXIS, ROTATION (16‑step), and directional side properties named north/east/south/west (e.g., wall heights) are rotated.
- Mirror (X or Z): HORIZONTAL_FACING/FACING mirrored; door hinge flips LEFT↔RIGHT; directional sides mirrored appropriately.
- Neighbor‑dependent shapes (stairs SHAPE, wall/pane/fence connections) often update naturally after placement. If you find cases that don’t, open an issue and we’ll add targeted rules or a refresh step.
Installation
Client (required):
- Fabric Loader: 0.16.x
- Fabric API: 0.116.4+1.21.1
- Java: 21
- Place blueprintsplus-<version>.jar in .minecraft/mods/.
Server:
- Same Fabric Loader + Fabric API + Java 21.
- Place the same blueprintsplus-<version>.jar in server_root/mods/ and restart.
Note: Client preview works without the server installed, but placement/commands and the Server tab require the server to have the mod.
Troubleshooting
- “Structures don’t rotate on server”: ensure the server mod jar is the same version (+buildN) as the client jar.
- “Browser Server tab shows nothing”: Install the mod on the server and try /bp list in‑game to confirm server files exist.
- “Preview opaque/heavy”: press O to switch to outlines‑only. Distance culling (~128 blocks) is enabled by default.
- “Walls/stairs corners odd after place”: neighbor‑dependent shapes may need a world tick. Report specific blocks if you want exact shaping rules added.
评论 0
登录后参与评分
还没有评论,来抢沙发吧