蓝图+

蓝图+

面向建造者的智能可重用蓝图。即时捕获建造内容,预览带旋转/镜像的虚影,并将结果作为整体放置——支持单人与服务器。

管理

Blueprints+

图标

为建造者打造的智能、可复用蓝图。即时捕捉建筑,预览带有旋转/镜像的幽灵投影,并将结果作为整体放置——支持单人和服务器。

特性

  • 幽灵预览(客户端)
    • 在准星所指的方块面上切换蓝图实时幽灵投影。
    • 两种预览模式:纹理方块+轮廓,或仅轮廓(可切换)。
    • 旋转(绕 Y 轴 90° 步进)、镜像(X/Z)以及 XYZ 方向微调。
  • 状态感知放置(客户端→服务器)
    • 有向方块会随结构旋转/镜像(例如 FACING、HORIZONTAL_FACING、AXIS、16 步旋转以及常见的方向侧面属性)。
    • 镜像时门的铰链方向会翻转,以获得自然的结果。
  • 抓取选择(服务器命令)
    • /bp grab :捕捉与所看方块相连的所有方块(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 — 从所看方块捕捉相连方块(严格:仅相连方块,无地面,无液体,永不低于起始 Y 坐标)。
  • /bp list — 列出服务器上的文件。
  • /bp remove — 看向一个结构并打开确认对话框(Enter=是,Esc=否)以删除相连的建筑。安全措施:仅相连方块,无地面/液体,永不低于起始 Y 坐标,上限 8000。 捕捉的文件保存在 server_root/blueprints/.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-.jar 放入 .minecraft/mods/。

服务器:

  • 相同的 Fabric Loader + Fabric API + Java 21。
  • 将相同的 blueprintsplus-.jar 放入 server_root/mods/ 并重启。

注意:客户端预览无需安装服务器模组即可工作,但放置/命令以及服务器标签页需要服务器安装该模组。

故障排除

  • “服务器上结构不旋转”:确保服务器模组 jar 与客户端 jar 版本相同(+buildN)。
  • “浏览器服务器标签页显示为空”:在服务器上安装模组,并在游戏内尝试 /bp list 以确认服务器文件存在。
  • “预览不透明/卡顿”:按 O 切换到仅轮廓。距离剔除(约 128 方块)默认启用。
  • “放置后墙壁/楼梯拐角异常”:依赖邻居的形状可能需要一个世界 tick。如果你希望添加精确成形规则,请报告具体方块。