| name | structs-building |
| description | 在Structs中构建和管理各种结构体。负责结构的创建、激活、停用、移动、防御定位、隐身功能以及能量生成器的注入等操作。适用于构建结构体、激活或停用结构体、在不同位置之间移动结构体、设置防御任务、启用隐身功能或注入能量生成器等场景。构建时间因具体结构体类型而异：Command Ship的构建时间约为17分钟，World Engine的构建时间则长达约6.4小时。 |
结构体建造
重要提示：包含连字符的实体ID（例如1-42、5-10）会被CLI解析器误认为是标志（flags）。因此，在使用所有与结构体建造相关的命令时，必须在参数前添加--来避免这种误解。
建造流程
- 检查条件：玩家必须在线，拥有足够的阿尔法物质（Alpha Matter），并且有可用的建造槽位（每个建造领域最多3个槽位）；建造所需的指挥舰（Command Ship）必须在线，舰队（fleet）必须位于建造站点（适用于行星建造）。需要查询玩家信息、行星信息和舰队状态。
- 启动建造：执行命令
structsd tx structs struct-build-initiate --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [player-id] [struct-type-id] [operating-ambit] [slot]。其中[operating-ambit]参数必须是一个小写字符串，可以是"space"、"air"、"land"或"water"（不能使用位掩码数字）。
- 工作量证明（Proof-of-Work）：执行命令
structsd tx structs struct-build-compute -D 3 --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id]。该命令会计算结构体的哈希值并自动提交建造请求，结构体会随之自动激活。无需额外的激活步骤。
- 可选操作：根据需要移动结构体、设置防御措施或开启隐身功能。
自动激活：结构体会在建造完成后自动激活。只有在使用struct-deactivate命令将其停用后，才需要使用struct-activate命令重新激活结构体。
struct-build-compute与struct-build-complete的区别
struct-build-compute是一个辅助命令，它会执行工作量证明并自动提交struct-build-complete请求。struct-build-complete命令仅在您通过外部工具计算出哈希值并希望手动提交结果时使用。
-D标志的用法
-D标志（取值范围1-64）用于指定结构体开始计算哈希值之前的难度等级。随着结构体老化，计算难度会呈对数级降低。例如，设置-D 3时，计算过程几乎瞬间完成且不会消耗任何CPU资源。较低的-D值会延长计算时间，但在处理高难度结构体时能更有效地利用计算资源。
能量消耗
每个操作都会消耗能量。能量以每块时间单位1单位的速率被动积累（大约每6秒积累1单位能量）。
| 操作 | 能量消耗 | 等待时间 |
|---|
| 建造完成 | 8 | 约48秒 |
| 移动 | 8 | 约48秒 |
| 激活（仅限重新激活） | 1 | 约6秒 |
| 设置防御 | 1 | 约6秒 |
| 安装主武器 | 1-20 | 根据结构体类型而异 |
如果出现“所需能量为X，但玩家当前只有Y”的错误，请等待能量积累足够。详细能量消耗信息请参见knowledge/mechanics/building。
预计建造时间
从启动到计算完成的总时间（假设每块时间单位计算6秒，难度等级为3）：
| 结构体类型 | 类型ID | 建造难度 | 等待达到目标难度所需时间 |
|---|
| 指挥舰 | 1 | 200 | 约17分钟 |
| 星际战斗机 | 3 | 250 | 约20分钟 |
| 采矿提取器 | 14 | 700 | 约57分钟 |
| 矿石精炼厂 | 15 | 700 | 约57分钟 |
| PDC（行星防御系统） | 19 | 2,880 | 约3.7小时 |
| 矿石储存库 | 18 | 3,600 | 约4.6小时 |
| 行星引擎 | 22 | 5,000 | 约6.4小时 |
建议：尽早启动建造流程，然后后台执行计算任务。可以批量启动所有计划中的建造任务，同时在等待期间进行其他操作。更多相关信息请参见awareness/async-operations。
注意事项：每个签名密钥（signing key）只能同时执行一个计算任务。如果使用相同的签名密钥同时运行两个*-compute任务，可能会导致计算结果冲突，从而导致其中一个任务失败。请为不同的玩家使用不同的签名密钥，并为同一玩家的不同建造任务分别安排计算时间。
命令参考
| 操作 | CLI命令 |
|---|
| 启动建造 | structsd tx structs struct-build-initiate --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [player-id] [struct-type-id] [operating-ambit] [slot] |
| 计算哈希值并自动完成 | structsd tx structs struct-build-compute -D 3 --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] |
| 手动完成建造 | structsd tx structs struct-build-complete --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] |
| 取消建造 | structsd tx structs struct-build-cancel --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] |
| 重新激活 | structsd tx structs struct-activate --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] |
| 停用结构体 | structsd tx structs struct-deactivate --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] |
| 移动结构体 | structsd tx structs struct-move --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] [new-ambit] [new-slot] [new-location] |
| 设置防御 | structsd tx structs struct-defense-set --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [defender-struct-id] [protected-struct-id] |
| 清除防御 | structsd tx structs struct-defense-clear --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [defender-struct-id] |
| 开启隐身 | structsd tx structs struct-stealth-activate --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] |
| 关闭隐身 | structsd tx structs struct-stealth-deactivate --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] |
| 为结构体注入能量 | structsd tx structs struct-generator-infuse --from [key-name] --gas auto --gas-adjustment 1.5 -y -- [struct-id] [amount] |
限制：
- 每个玩家最多只能拥有1个PDC（行星防御系统）和1艘指挥舰。
- 指挥舰必须属于玩家的舰队。
- 为结构体注入能量是不可逆的操作。
常用命令参数：
--from [key-name] --gas auto --gas-adjustment 1.5 -y。
验证方法
- 使用
structsd query structs struct [id] 查询结构体状态（在线、已建造或离线）。
- 确认结构体已出现在相应的行星或舰队列表中。
错误处理
| 错误类型 | 原因 | 处理方法 |
|---|
| “所需能量为X，但玩家当前只有Y” | 能量不足 | 等待约48秒（每6秒积累1单位能量）后再尝试建造 |
| “资源不足” | 阿尔法物质不足 | 先开采并精炼矿石；使用 structsd query structs player [id] 检查玩家能量余额 |
| “能量容量不足” | 结构体无法上线 | 停用非必要的结构体或增加能量容量（参见 structs-energy 技能） |
| “舰队未在站点” | 舰队远离建造站点 | 等待舰队返回或使用 fleet-move 命令将其移回站点 |
| “需要指挥舰” | 指挥舰未建造或已离线 | 先建造或重新激活指挥舰 |
| “槽位已被占用” | 槽位已被其他结构体占用 | 检查行星上的现有结构体布局 |
| “不支持的建造领域” | 选定的结构体类型不支持当前建造领域 | 查看结构体类型的 possibleAmbit 标志 |
| “连接失败” | 本地节点缺失或远程节点配置错误 | 在 ~/.structs/config/client.toml 中配置 node 参数，或使用 --node 标志 |
相关文档
