建造指南Build Guide

模组

· 作者 brentmaas

一款仅客户端的模组,可将圆形、球形等形状投影到世界中。它支持单人游戏和多人游戏,即使服务器未安装该模组也能正常工作。

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

最新 0.4.9-26.3 · 26.3 · Fabric / Forge

一键开服(送7天)

建造指南

一个仅客户端的模组,用于将圆形和球形等形状投射到世界中。它在单人游戏和多人游戏中均能工作,即使服务器未安装该模组也是如此。

简要使用指南

显示

使用方法

按下“打开建造指南”按键(默认为“B”)将打开建造指南 GUI,初始界面位于“形状”子 GUI。切换左上角的“启用”复选框可以决定是否渲染形状。在该复选框下方,有两个按钮用于循环切换可用的形状,这些形状可以在本使用指南底部的“形状”部分找到。“设置原点”按钮会将你脚下的小方块(默认为红色)设置为原点位置。这个方块是形状的基础(例如,直线的起点或圆形的中心)。也可以通过“设置原点”按钮下方的文本字段和按钮来更改原点。GUI 的中间或右侧列出了当前所选形状的属性列表,如半径或方向。某些属性还允许负值,这可以将形状沿负轴翻转,例如。

“可视化”按钮带你进入一个子 GUI,其中包含滑块,用于更改形状较大立方体(默认为白色)和较小原点立方体(默认为红色)的颜色。该子 GUI 还包含一个切换“深度测试”的选项;禁用深度测试后,你可以透过方块看到形状。

按下“形状列表”允许你同时使用多个形状。在此子 GUI 中,按下“添加”按钮会添加上方所示形状的实例。待添加的形状同样可以通过循环切换来更改。列表中的每个形状都有各自的原点,默认情况下在首次添加时位于你的脚下。点击屏幕中央列表中的形状即可选中它,选中状态由黑色条指示。被选中的形状是在形状 GUI 中可以更改的那个。切换“可见性”复选框可以暂时隐藏选中的形状,并在总方块数统计中忽略它。按下“删除”将删除选中的形状。“全局原点”按钮和文本字段以与主 GUI 中原点按钮相同的方式移动选中形状的原点,但未选中形状的原点也会进行相同的相对移动,从而保持相对的起源位置。

所有形状及其设置都绑定到世界名称(单人游戏)或服务器 IP(多人游戏)以及维度。通过启用 persistenceEnabled 配置选项,可以在客户端重启之间保留形状。否则,当客户端关闭时,形状将会丢失。

形状

悬链线 (Catenary): 两个点之间的悬链线(又称链条或绳索线),其弧长(绳索长度)为这两点之间的距离加上给定的额外距离。

圆形 (Circle): 围绕三个轴中任意一个轴的圆形,可以堆叠形成墙壁或管道。

圆锥 (Cone): 指向三个轴中任意一个轴的圆锥,具有给定的半径和高度。

长方体 (Cuboid): 具有可切换墙壁的空心长方体。

椭圆 (Ellipse): 围绕三个轴中任意一个轴的椭圆,可以堆叠形成墙壁或管道。

椭球 (Ellipsoid): 椭球,也可以根据沿轴的方向转换为六种可能的穹顶之一。

网格 (Grid): 具有给定步长和每个轴向步骤数的方块网格。

直线 (Line): 沿轴六个方向之一的直线。

抛物线 (Parabola): 具有给定半宽度和高度的抛物线,面向给定方向并按给定角度旋转。

抛物面 (Paraboloid): 指向三个轴中任意一个轴的抛物面,具有两个给定的半宽度和给定的高度。

多边形 (Polygon): 三角形、正方形、五边形、六边形等。可以围绕三个轴中的任意一个轴旋转,并且可以堆叠形成墙壁或管道。

多边形金字塔 (Polygonal pyramid): 底面为多边形的金字塔。可以围绕三个轴中的任意一个轴旋转。注意:给定的高度可能不是最终高度。

球体 (Sphere): 球体,也可以根据沿轴的方向转换为六种可能的穹顶之一。

环形 (Torus): 类似甜甜圈的形状,具有可配置的半径和厚度,可以围绕三个轴中的任意一个轴放置。

完整使用指南

显示

建造指南 GUI

可以使用快捷键访问建造指南 GUI。默认情况下,此快捷键为“B”,但像任何快捷键一样,可以通过 Minecraft 的设置进行更改(对于 Minecraft 1.17 及更低版本,在 GUI 关闭状态下,按 Escape -> Options -> Controls;对于 Minecraft 1.18 及更高版本,按 Escape -> Options -> Controls -> Key Binds)。在此子 GUI 中,你一次只能处理一个形状。GUI 分为四个子 GUI,可通过顶部的四个按钮访问:“Shape”、“Visualization”、“Shape list”和“Configuration”。左上角有一个全局“启用”复选框,用于切换形状的渲染。还存在一个名为“Toggled enabled”的快捷键,默认未绑定,作为“Enable”复选框的替代方案。所选形状的总方块数和所有形状的总方块数显示在顶部。第一行是方块的精确数量。第二行以堆栈数量和余数的形式显示该数量。右上角的“X”按钮将关闭 GUI,就像按 Escape 键一样。

形状子 GUI

形状子 GUI 分为三个部分:“Shape”、“Origin”和“Shape properties”。

形状 (Shape)

“形状”部分确定显示哪种形状。最初,这将是模组知道的第一个形状,应该是一个圆形。按下当前形状名称左右两侧的箭头按钮将在可用形状之间循环切换。

原点 (Origin)

到目前为止,你应该已经看到一个随机形状被渲染出来(如果你勾选了“启用”复选框)。你很可能会想要移动这个形状,而这正是子 GUI 中这一部分的功能所在。假设你尚未触碰过可视化 GUI,你会看到两种类型的方块被渲染出来:大量白色方块勾勒出形状轮廓,以及一个红色小方块,称为形状的“原点”。该原点是形状的基础,通常类似于圆心或直线的起点。初始原点将是你在首次打开 GUI 时所处的位置。“原点”部分中的所有按钮都会改变原点的位置,而勾勒形状的方块也会随之移动。第一个按钮“设置原点”会将原点直接移动到你脚下。其余三行则允许对位置的三个分量(X、Y 和 Z)进行更精细的控制。“-”和“+”按钮分别用于递减和递增相应的分量。可以在黑色文本框中输入精确数值。点击“设置”按钮会尝试将分量设置为文本框中的值。如果该值不是有效的整数,分量将不会更新,且文本会变红。输入有效数字后,文本会再次变白。此外,还存在一个快捷键绑定,默认未绑定,其作用类似于“设置原点”按钮,且名称相同。

形状属性

最后,“形状属性”包含形状的参数;长度、半径、方向等。每种形状的参数及其说明可在本使用指南后面的“形状”部分找到。在切换形状时,它们的参数会被保留。

可视化子 GUI

按“可视化”按钮即可打开可视化子 GUI。可视化子 GUI 主要包含两组四个滑块和两个按钮。左侧一组控制勾勒形状的方块的颜色,右侧一组控制原点小方块的颜色。每个滑块的四个通道分别控制相应类型方块颜色的一个分量:红色、绿色、蓝色和 Alpha。其中,Alpha 是方块的透明度。将滑块调整到所需位置后,按“设置”即可应用颜色。按“默认”会将颜色恢复为默认的勾勒形状方块的白色和原点方块的红色。底部的“深度测试”复选框决定渲染时是否使用深度测试,这是“仅在没有物体介于它与相机之间时才绘制此物体”的技术术语。换句话说,取消勾选“深度测试”将使你能透过世界看到勾勒形状的方块和原点方块。这不能用作透视作弊或其他类型的作弊手段,因为该模组与游戏世界没有任何交互。

形状列表子 GUI

按“形状列表”按钮将进入形状列表子 GUI。与形状子 GUI 类似,形状列表子 GUI 也分为四个部分:“添加新形状”、“选中形状”、“全局原点”和“形状”。

添加新形状

在此部分,你可以再次在形状之间循环切换。切换到目标形状并按下方的“添加”按钮,即可将该形状添加到“形状”部分的列表中。新添加的形状的原点将位于你脚下。你可以自由循环并添加其他形状,而不会影响之前已添加的形状。

选中形状

禁用“可见性”复选框将隐藏选中的形状,这在形状列表中会以删除线标示。按“删除”按钮将从形状列表中删除该形状。

全局原点

此部分的工作原理与形状子 GUI 中的普通“原点”部分类似。使用按钮和文本字段将设置当前选中形状的原点。然而,所有其他形状的原点也会随之改变,以保持形状之间的相对位置不变。与普通原点处理一样,“设置全局原点”按钮也有同名的快捷键替代方案,默认未绑定。

形状

“形状”部分下方的列表列出了当前激活的形状。点击列表中的某个形状即可选中它,选中状态由围绕它的黑色方框标示。如果添加的形状太多导致无法全部显示在屏幕上,列表右侧会出现滚动条。拖动滚动条或使用鼠标滚轮均可滚动列表。在可视化 GUI 中设置的配色也只会影响当前选中的形状。不过,目前深度测试复选框仍然是全局设置,意味着它会影响所有形状,而不仅仅是选中的那个。这种行为未来可能会更改,以更好地与其他可视化功能保持一致。如果你从列表中删除了所有形状,大部分子 GUI 中的许多按钮将被禁用,因为此时没有可操作的形状。重新添加形状后,这些按钮将再次启用。

配置子 GUI

按“配置”按钮将打开配置子 GUI。该子 GUI 提供了对配置文件(参见模组描述末尾的“配置”部分)的直接且即时的接口。更改值无需重启即可生效。

形状

大多数形状默认只能生成奇数尺寸,因为原点位于单个方块的中心(例如,这样圆圈只能是 3x3、5x5、7x7 等)。这类形状都有一个“偶数模式”复选框,用于将原点沿相关方向偏移半个方块(从前面的例子来看,圆圈现在只能是 4x4、6x6、8x8 等)。某些参数还允许负值,从而可以将形状向负轴翻转,例如。

悬链线

悬链线,也称为链线或绳索线,是绳索悬挂在两点之间所形成的形状。悬链线基于的两个点是原点和由参数“Delta X”、“Delta Y”和“Delta Z”描述的相对于原点的点。第二个点也可以使用“Set endpoint(设置端点)”按钮进行设置,该按钮会将此位置放置在您的脚下。悬链线的弧长(即绳索的长度)由两点之间的距离加上“Additional distance(额外距离)”中给出的值定义,该值必须为 1 或更大。

圆形

一个简单的圆形。“Direction(方向)”属性决定了圆形围绕哪个轴旋转。例如,当设置为“X”时,圆形将在 Y 和 Z 方向上延伸。“Radius(半径)”将设置圆形的半径,可以是任何正整数。增加“Depth(深度)”会在“Direction(方向)”给定的方向上创建一个圆柱形管道。

圆锥体

一个圆锥体。“Direction(方向)”属性决定了圆锥体指向哪个轴。“Radius(半径)”将设置圆锥体的半径,可以是任何正整数。“Height(高度)”设置圆锥体的高度,可以为负数。

长方体

长方体是一种空心的类立方体形状,每条边的长度由参数“X”、“Y”和“Z”给出,它们都必须是正整数。“Walls(墙壁)”参数显示当前激活的墙壁,例如,“X”的存在意味着朝向负 X 方向和正 X 方向的墙壁已启用,Y 和 Z 同理。“-”表示未启用任何墙壁,长方体仅是一个线框。您可以选择原点作为长方体的角还是中心。

椭圆

椭圆与圆形非常相似。唯一的区别是,它不使用半径,而是使用两个半轴。这些半轴的作用类似于半径,但如果认为半径在两个方向上起作用,那么这些半轴只在一个方向上起作用,即参数名称中显示的那个方向。

椭球体

椭球体对于球体,就像椭圆对于圆形一样。它与球体的唯一区别在于它现在有三个半轴而不是一个半径。像球体一样,它也具有穹顶模式。

网格

由方块组成的网格。每个方向的方块数量和方块之间的步长都可以更改。

直线

一条简单的直线。直线基于的两个点是原点和由参数“Delta X”、“Delta Y”和“Delta Z”描述的相对于原点的点。第二个点也可以使用“Set endpoint(设置端点)”按钮进行设置,该按钮会将此位置放置在您的脚下。

抛物线

一条抛物线。其形状由参数“Half-width(半宽)”和“Height(高度)”描述,使得点 (Half-width, Height) 成为抛物线的一部分。“Direction(方向)”和“Rotation(旋转)”允许抛物线面向特定方向并按给定量旋转。“Depth(深度)”将向“Direction(方向)”添加层,且可以为负数。

抛物面

一个抛物面。它的工作原理类似于抛物线,但现在在由参数名称给定的方向上有两个半宽。旋转现在仅由“Direction(方向)”参数给出。

多边形

多边形是具有给定边数的规则形状。这个边数由“Sides(边数)”参数给出;3 给出三角形,4 给出正方形,5 给出五边形,等等。“Sides(边数)”参数必须是 3 或更高的整数。“Radius(半径)”是对半径的一种较为宽松的解释,它是原点到其中一条边的距离。“Radius(半径)”必须是正整数。“Direction(方向)”的工作方式与圆形类似,因为它决定了多边形围绕哪个轴旋转。“Rotation(旋转)”是多边形将旋转的 90° 的倍数。最后,“Depth(深度)”的工作方式再次与圆形相同。

多边形金字塔 底面为多边形的金字塔。它的工作原理与普通多边形完全相同,但用“Height(高度)”代替了“Depth(深度)”来表示金字塔的高度。

球体

一个球体,其半径由“Radius(半径)”给出,这是一个正整数。“Dome(穹顶)”设置球体的穹顶模式:“-”表示禁用,任何其他选项将仅在它所描述的方向上显示球体的一个半球。

环形体

也被称为甜甜圈。像圆形一样,“Direction(方向)”参数决定了它围绕哪个轴旋转。如果你想象环形体是一个围绕环的管道,那么“Outer radius(外半径)”是环的半径,“Inner radius(内半径)”是管道的半径。两者都必须是正整数,并且“Outer radius(外半径)”必须始终大于或等于“Inner radius(内半径)”。如果“Outer radius(外半径)”设置为小于“Inner radius(内半径)”,或者“Inner radius(内半径)”设置为大于“Outer radius(外半径)”,另一个参数将被设置为相同的值。

在世界、服务器和维度之间移动

通常是在非常特定的环境中规划形状;单人世界中的形状在你的首选服务器或其他世界中可能无法感知,而你在主世界规划的建筑在末地中完全无用,因为那里它悬浮在你身后 500 块的虚空中。因此,最新版本将为每种独特的世界/服务器 IP 和维度组合拥有不同的状态。截至撰写本文时,无论如何都没有办法将这些状态转移到另一个世界/服务器/维度,但未来的模组版本将实现此行为的切换以及状态的移动/复制。默认情况下,客户端重启后形状和状态会丢失。启用配置选项 persistenceEnabled 允许模组将形状和状态保存到文件,并在客户端重启时恢复它们。由于技术限制,状态恢复将在你打开 GUI 时开始。

最低要求

例如标注为 1.21/1.21.1 的版本是基于 1.21 构建的,但应该可以在 1.21.1 上运行。

Forge 1.20/1.20.1: Minecraft Forge 46.0.14.
Forge 1.20.2/1.20.3: Minecraft Forge 48.1.0.
Forge 1.20.4/1.20.5: Minecraft Forge 49.2.8.
Forge 1.20.6: Minecraft Forge 50.2.9.
Forge 1.21/1.21.1: Minecraft Forge 51.0.33.
Forge 1.21.3: Minecraft Forge 53.1.11.
Forge 1.21.4: Minecraft Forge 54.1.17.
Forge 1.21.5: Minecraft Forge 55.1.11.
Forge 1.21.8: Minecraft Forge 58.1.19.
Forge 1.21.10: Minecraft Forge 60.1.11.
Forge 1.21.11: Minecraft Forge 61.1.19.
Forge 26.1.2: Minecraft Forge 64.0.11.
Forge 26.2: Minecraft Forge 65.0.4.
Forge 26.3: Minecraft Forge 66.0.9.

Fabric 1.20/1.20.1: Fabric Loader 0.19.3 and Fabric API 0.83.0.
Fabric 1.20.2/1.20.3: Fabric Loader 0.19.3 and Fabric API 0.91.6.
Fabric 1.20.4/1.20.5: Fabric Loader 0.19.3 and Fabric API 0.97.3.
Fabric 1.20.6: Fabric Loader 0.19.3 and Fabric API 0.100.8.
Fabric 1.21/1.21.1: Fabric Loader 0.19.3 and Fabric API 0.102.0.
Fabric 1.21.3: Fabric Loader 0.19.3 and Fabric API 0.114.1.
Fabric 1.21.4: Fabric Loader 0.19.3 and Fabric API 0.119.4.
Fabric 1.21.5: Fabric Loader 0.19.3 and Fabric API 0.128.2.
Fabric 1.21.8: Fabric Loader 0.19.3 and Fabric API 0.136.1.
Fabric 1.21.10: Fabric Loader 0.19.3 and Fabric API 0.138.4.
Fabric 1.21.11: Fabric Loader 0.19.3 and Fabric API 0.141.4.
Fabric 26.1.2: Fabric Loader 0.19.3 and Fabric API 0.154.2.
Fabric 26.2: Fabric Loader 0.19.3 and Fabric API 0.154.2.
Fabric 26.3: Fabric Loader 0.19.5 and Fabric API 0.161.0.

NeoForge 1.21/1.21.1: NeoForge 21.0.167.
NeoForge 1.21.3: NeoForge 21.3.96.
NeoForge 1.21.4: NeoForge 21.4.157.
NeoForge 1.21.5: NeoForge 21.5.97.
NeoForge 1.21.8: NeoForge 21.8.53.
NeoForge 1.21.10: NeoForge 21.10.64.
NeoForge 1.21.11: NeoForge 21.11.42.
NeoForge 26.1.2: NeoForge 26.1.2.80.
NeoForge 26.2: NeoForge 26.2.0.18-beta.
NeoForge 26.3: NeoForge 26.3.0.45-beta.

兼容性

通过 Optifine 兼容光影的功能无法得到保证。已知 Optifine 中的光影会因看似属于 Optifine 自身的问题而导致投影失效。Optifine 中非光影相关的功能似乎运行完全正常。

从 Minecraft 1.21.5 开始,该模组明确与 Iris 兼容,即使启用光影也是如此。

本模组设计为仅在客户端运行。不建议在服务器上安装此模组,但已采取措施防止服务器立即崩溃,且未安装(正确版本)模组的客户端不应被拒绝访问。不过,这种服务端行为既不受支持也无法保证。

配置

配置文件位于游戏目录下的 config 文件夹中,文件名为 buildguide.cfg。你也可以使用配置子 GUI 进行编辑。可配置的选项如下:

debugGenerationTimingsEnabled(默认值:false)
一个调试选项,用于将生成形状所需的时间打印到日志中。

asyncEnabled(默认值:true)
启用此选项后,形状将在后台异步生成,无需阻塞你的客户端。启用此选项可能导致形状投影出现闪烁,因此如果你对标有闪烁的图像敏感,尤其是使用该模组时感到不适,请考虑禁用此选项。此问题有望在未来得到解决。

shapeListRandomColorsDefaultEnabled(默认值:false)
启用此选项后,向“形状列表”子 GUI 添加新形状时,将随机生成其颜色,而不是使用默认的红色和白色。

persistenceEnabled(默认值:false)
实验性选项,由于 Forge 上存在一些奇怪的问题,默认处于禁用状态。启用此选项后,形状和状态将被保存到文件中,从而允许模组在客户端重启后恢复形状。

整合包

欢迎将其添加到你的整合包中!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源