开放结构

开放结构

OpenStructures 是一个面向 Hytale 生成/粘贴引擎的开放世界生成结构中心,提供管理工具和公共 API,以便其他模组可以发布结构包。

世界生成

OpenStructures 是一个开放的世界生成结构中枢。它会在新生成的区块上按照整合包生成规则放置结构,并提供粘贴引擎、管理界面和面向其他模组的公共 API。

本模组不附带固定的结构目录。内容包(及创作者)需在 Server/WorldGen/OpenStructures/Prefabs/ 下添加自己的预制体和规则。位于 Server/WorldGen/StructureV2/Prefabs 下的旧版 StructureV2 规则包在迁移期间仍会被扫描。

注意: 结构只会在新的或未探索的区块中生成。已有地形不会被更新。


0.1.0 版本新增内容

  • 结构中枢 —— 为 OpenStructures 内容包提供共享的世界生成放置、预制体粘贴保真度以及生成规则加载
  • 管理面板(/os admin),用于管理生成规则、世界生成选项和逐条目覆盖
  • 创作者工具 —— 游戏内指南、/os validate、/os why 和 /os status,用于调试放置
  • 公共 API —— 其他模组可依赖 OpenStructures 实现生成规则、粘贴和事件

面向创作者

在添加结构之前,请阅读以下两项:

  • 游戏内指南 —— 打开 /os admin 并进入 Guide 标签页(包含架构说明、Pattern / GridGenerator、路径、常见错误)

然后以 JSON 形式提供生成规则,放在:

  • Server/WorldGen/OpenStructures/Prefabs/*.json

使用带顶层 GridGenerator 的 Pattern,将预制体指向 Server/Prefabs/,并通过 /os validate 和 /os why <entryId> 进行验证。


兼容性

OpenStructures 可独立作为结构中枢使用。可选集成:

  • 内容包 —— 任何附带 OpenStructures(或旧版 StructureV2)生成规则 JSON 的整合包。

并非 StructureV2 内容的直接替代品: StructureV2 仍是一个独立的结构包,拥有自己的预制体和 Boss 岛。OpenStructures 是共享中枢 + API;如果你想要那部分内容,请保留 StructureV2,或将规则迁移到 OpenStructures 路径。


命令

权限:openstructures.admin · 别名:/os、/openstructures

  • /os admin —— 打开管理面板
  • /os status —— 世界生成状态与计数
  • /os why [entryId] —— 诊断为什么你脚下没有任何东西被放置
  • /os reload —— 重新加载生成规则
  • /os list [world] —— 列出生成记录
  • /os tp <index> —— 传送到列表中的某个生成点
  • /os spawn <prefab> —— 在你的位置粘贴一个预制体(例如 Structure.Camp)
  • /os entries —— 列出已加载的生成规则条目
  • /os validate —— 检查预制体解析和 Pattern 编译
  • /os nearby [radius] —— 显示附近的生成记录
  • /os flush —— 强制保存生成数据
  • /os clear —— 清除当前世界的生成记录

安装提示: 更新 jar 文件后,请完全重启世界。不要在 Hytale 运行时替换 jar。

反馈: 发现 bug 或有建议?请留言或在 Discord 上联系 joszza 以获得更快的回复。