Craftpilot

Craftpilot

Craftpilot 是你在 Minecraft 中的私人建筑助手。当你建造时，它会通过易于使用的叠加层提供相关建议。无论你是在为新建筑寻找灵感，还是纠结于复杂细节，Craftpilot 都能帮助你实现创意构想。该助手支持多种建筑风格和方块配色方案，是任何 Minecraft 建筑玩家的通用工具。

设置

Craftpilot 需要一个运行 ML 模型的配套程序。以下是入门方法：

快速开始（推荐）

1. 从 releases 页面 下载最新版本
2. 运行配套程序

   ⚠️ 注意：ML 模型需要现代 GPU（推荐 NVIDIA）才能获得最佳性能。如果没有 GPU，生成时间可能会显著变慢。

3. 启动 Minecraft - Craftpilot 将自动连接到本地实例

其他设置选项

• 面向开发者：你可以直接从源代码运行配套程序。克隆 仓库，安装 Python 依赖，并在本地运行。这对于自定义或故障排除很有用。
• 高级配置：配套程序可以运行在远程服务器上。在模组设置中配置连接 URL，将其指向你想要的服务器地址。

使用方法

1. 触发建议

   • 放置任意方块以开始新建筑或继续现有建筑。建议将自动出现。
   • 你也可以在不放置任何方块的情况下，按触发键（默认 R）手动触发建议。
   • Craftpilot 将以透明叠加层显示建议的方块。

2. 使用建议

   • 在显示建议的位置放置方块以接受建议。
   • 使用便捷放置模式（默认启用）时，你可以完全按照建议中显示的方式放置方块，无需担心朝向或相邻方块。只需右键点击建议的方块，即可按正确的朝向和状态放置。在创造模式下，你甚至可以空手放置方块。
   • 当你建造时，新建议会自动出现。
   • 对建议使用选取方块功能（鼠标中键）可快速选择方块。
   • 按清除键（默认 Z）清除所有当前建议。
   • 通过左键点击（击打）建议来移除单个建议。
   • 按接受键（默认 V）一次性接受所有建议的方块。

3. 建造灵活性

   • 你可以随意偏离建议 - 系统会自适应。
   • 有一个宽限期，允许你在重新生成建议前放置少量不同的方块。
   • 这有助于容纳支撑方块和进行细微调整。

4. 选择备选方案

   • 除了主要建议外，还可以生成多个备选方案。它们显示为屏幕右上角 Craftpilot 标志旁边的方框。
   • 按住选择备选键（默认左 Alt），使用滚轮或快捷栏按键选择一个选项。

性能调优

运行 ML 模型非常消耗性能，并且依赖硬件。因此有多个性能选项/权衡。如果建议生成非常慢，请尝试降低这些值。如果生成速度可以接受，可以尝试提高它们。有 3 个主要选项会影响性能：

• 模型类型 - 目前有 2 种不同大小的模型：Iron 和 Diamond。Iron 比 Diamond 小得多且快得多，但提供的建议质量较低。如果在 CPU 上运行，Diamond 几乎不可能运行。此设置保持默认时，它会使用配套程序为你的硬件自动选择的模型。
• 建议范围 - 这会改变发送给模型的结构大小，因此直接影响其需要执行的计算量。范围越大，计算和内存需求会呈指数级增加。降低此值会加快速度，但建议会考虑的周围区域更少。
• 最大备选数 - 模型计算的每个备选方案都需要额外的计算和内存。将此值设为 1 会最快。

自定义

可以在配置文件 “craftpilot.json” 中，或通过 Mod Menu 访问的配置界面中编辑设置。可用设置包括视觉选项（如叠加层外观）、建造行为和 ML 模型参数。