
开放结构
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 以获得更快的回复。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。