BluePrints+

模组

· 作者 romanjcweaver

面向建筑师的智能、可重复使用的蓝图。即时捕捉建筑作品,预览带有旋转/镜像功能的幽灵模型,并将结果作为单元放置——支持单人模式与服务器。

0 本站下载 0 关注 更新于 1 年前

最新 0.1.0+build31 · 1.21.1 · Fabric

一键开服(送7天)

Blueprints+

Icon

为建造者打造的智能、可复用的蓝图。即时捕捉建筑,预览带有旋转/镜像的半透明轮廓(幽灵),并以单元为单位放置结果——支持单人游戏和服务器。

功能

  • 幽灵预览(客户端)
    • 在准星指向的方块面上切换蓝图的实时幽灵预览。
    • 两种预览模式:带纹理的方块 + 轮廓线,或仅轮廓线(可切换)。
    • 支持绕 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 个方块)。
  • “放置后墙壁/楼梯角落异常”:依赖邻居的形状可能需要一次世界刻更新。如需添加精确的形状规则,请报告具体的方块。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源