结构图集

🗺️ Structure Atlas

你的世界，为你铭记。

你深入一片陌生的领地。你潜入一座爬满骷髅的地穴，一路杀出重围，继续游荡。一周后，每一片山谷看起来都一样，而你就算命悬一线，也再也找不到那座地穴了。

Structure Atlas 就是那个默默帮你解决这个问题的宁静制图师。 当你探索时，它会注意到你经过的地牢、营地、蜂巢和塔楼——根据里面的生物为它们命名——并将它们标记在你的地图上。你无需按下任何按钮。你只管探索，你的图集便会自动填充。

它的功能

当你漫步在 Hytale 世界时，Structure Atlas 会记录下它看到的每一个地牢、神庙、蜂巢、法师塔、营地、定居点、克洛普斯住所、神龛、龙巢和塔楼。每一个都会获得：

• 在你世界地图上的一个彩色图钉，标注着它的真实身份；
• 当你回到已经发现过的结构约 120 格范围内时的距离提示聊天消息；
• 在你的 /atlas 发现日志中，以该类别主题色显示的一条记录。

无需召唤。无需手动标记（尽管你可以这样做）。它伴随着你的探索默默运行，记录一切——并且你的发现在重启后依然保留。

它根据内部生物来命名结构

这是让地图感觉栩栩如生的部分。Structure Atlas 根据结构的居民来识别它——并相应地为其标注：

你偶然闯入...	它被标记为...
一座爬满骷髅的地穴	骷髅地穴 (地牢)
一座由地精公爵统治的地牢	地精公爵的巢穴 (地牢)
一个有育母蝎的斯卡拉克巢穴	斯卡拉克育母蝎的蜂巢
守卫着尖塔的水晶魔像	魔像塔 (法师塔)
一个特洛克战争营地	特洛克营地
一个奎比克定居点	奎比克村庄 (定居点)

当有一个首领或精英守护该地点时，该结构会以他们的名字命名。否则，它会取用占主导地位的生物的名字。无论哪种方式，结构的类型都会在标签中附带显示，因此"魔像塔 (法师塔)"永远不会被误认为是普通的瞭望塔。

十个类别

每个类别都有其主题色（所有颜色均可配置——请参阅下方的"自定义"章节）：

• 地牢 — 暗血红色 — 充满战利品和危险的地方
• 神庙 — 暖金色 — 神圣的遗迹
• 蜂巢 — 橄榄壳甲绿色 — 斯卡拉克的据点
• 法师塔 — 奥术紫色 — 施法者的尖塔
• 营地 — 营火橙色 — 匪徒和外地人
• 定居点 — 友好绿色 — 安全的村庄
• 克洛普斯住所 — 暖棕色 — 洞穴居民的家
• 神龛 — 淡金色 — 神圣与宁静之地
• 龙巢 — 炽热红橙色 — 想要杀死你的地方
• 塔楼 — 冷石灰蓝色 — 前哨站和瞭望塔

发现机制

一个自动引擎：被动实体扫描。 每分钟一次，Structure Atlas 会静默读取你周围已加载区块中的实体。骷髅会暴露一座地穴；斯卡拉克育母蝎会暴露一座蜂巢；水晶魔像会暴露一座法师塔。它会根据它们所属的结构进行分组，让首领锚定其自身位置的地图标记，并聚类附近同类型的结构，这样一片广阔的蜂巢区域最终会变成一两个清晰的图钉，而不是五十个。

它不需要特殊权限，也不会向你的世界写入任何东西——它只是在你探索时注意到你周围的东西，这也意味着它可以记录在你安装它之前很久就已经生成的结构。

命令

一个带有子命令的单一主命令：

命令	功能
/atlas	按类别统计你已发现内容的摘要
/atlas nearby [range]	按名称列出附近的结构（默认 200 格）
/atlas mark <type>	在你当前位置手动标记一个结构
/atlas help	显示子命令列表
/atlas save	在自动保存之间强制保存发现记录
/atlas clear	清除所有发现记录（无确认提示——请谨慎操作）
/atlas debug	如果感觉有问题，提供诊断信息

/atlas mark 可用类别：dungeon， temple， hive， magetower， camp， settlement， klops， shrine， dragonlair， tower。

自定义 — 配置

首次运行时，一个带注释的配置文件会出现在 mods/structure_atlas/structure_atlas_config.json。对于每个类别，你可以设置颜色、显示名称、地图图标、是否追踪它，以及它的标记是否在任何地图缩放级别下保持可见。你还可以调整距离警报范围和自动保存间隔。默认值会重现标准行为，格式错误的文件也会安全回退，而不会导致崩溃。

不关心营地？设置为 "enabled": false。希望龙巢是热洋红色？设置颜色即可。图集随你塑造。

更新内容

v1.5.0 — 修复的命令和地图颜色

• /atlas mark 和 /atlas nearby 重新可用 — 两者都需要你的位置，但更新 5 改变了定位方式，导致之前两者都只会显示"无法确定你的位置。"已修复。
• 地图图钉重新显示其类别颜色 — 标记色调在更新 5 后无声失效，导致每个图钉都使用默认颜色；"色调与聊天调色板匹配"功能现在确实在地图上生效了。
• 崩溃安全保存 — 你的发现文件现在以原子方式写入，因此保存中途崩溃不会再清空你的整个图集。
• 限定了地图标记绘制（在长期探索的世界中更流畅），断线清理能阻止多人模式下缓慢的内存泄漏，移除了一个失效的检测路径，以及准确的版本报告。

v1.4.2 — 警报再次触及你

• 距离警报、加入欢迎消息和自动检测通知已恢复 — Hytale 的一次更新更改了聊天 API，旧消息会无声失败。现已适配当前 API，并为旧版本提供了回退方案。
• 更干净的下载 — zip 文件内附有简单的安装说明；如果你遇到"找不到命令！atlas"，请参阅下方的安装部分。

v1.4.1 — 地图标记显示完整的结构名称

• 地图图钉现在读取完整的首领感知名称（例如骷髅地穴 (地牢)），而不是仅仅显示类别，并且距离警报已停止重复类别。

v1.4.0 — 首领感知名称 + 可用的距离警报

• 结构根据其居民命名 — 地精公爵的巢穴， 骷髅地穴， 特洛克营地 — 并且始终显示结构类型。
• 距离聊天警报会在你靠近已发现的结构时再次提示你，通过更新 5 的实体 API 读取你的实时位置。

更早版本： v1.3.3 为更新 5 重建了自动检测；v1.3 增加了服务器管理员配置文件并统一了地图/聊天颜色调色板；v1.2 是对更新 5 的稳定性强化；v1.1 将命令整合到 /atlas 下并增加了首领优先级聚类。

如何与 Hytale 的 /locate 配合使用

更新 5 新增了内置的 /locate 用于查找生物群系、区域、地域和预制结构。Structure Atlas 做了不同的事情。 /locate 是一个主动先知——"带我去最近的 X。" Structure Atlas 是一个被动日志——"我去过哪里，那里是什么？"它们互不冲突；请两者都用。

兼容性

• Hytale 更新 4 和更新 5 — 声明了一个通配符 ServerVersion，并已验证可在当前最新的更新 5 版本线（0.5.x）上运行。
• 仅服务端。 玩家无需安装任何东西；他们只需看到地图图钉。
• 与其他游戏玩法、生物群系和天气模组良好兼容 — 它不会写入世界、不会覆盖世界生成、也不会拦截除自身命令以外的其他命令。
• 发现记录会持久保存在你的存档中，位于 mods/structure_atlas/；将存档复制到另一台电脑即可一并携带。

如果你正在运行我的其他模组，它们的设计风格保持一致：

• Project Sakura — 一个宁静的樱花碎片的维度
• Turning Seasons — 自动的季节性氛围变化
• HAARP Weather Control — 随时召唤任何天气

安装

1. 下载 StructureAtlas-1.5.0.zip 并解压缩（右键单击 → 全部提取）。
2. 将仅 StructureAtlas-1.5.0.jar 复制到 %APPDATA%\Hytale\UserData\Mods\ 中。 ⚠️ 是 .jar，不是 .zip — zip 文件只是下载外壳，模组无法在其中运行。
3. 升级？请先删除旧的 StructureAtlas-1.x.x.jar，以免加载两个副本（以及任何意外放入 Mods 文件夹的 StructureAtlas .zip 文件）。
4. 启动 Hytale，加载一个世界，然后在模组设置中启用 Structure Atlas。
5. 开始探索。图集将自行构建。

⚠️ 遇到"找不到命令！atlas"？

模组的代码没有被加载——目前为止所有案例中，原因都是 .zip 文件被放入了 Mods 文件夹而不是 .jar（它甚至可能以这种方式出现在模组列表中，看似已安装，却包含无法运行的代码）。解决方法：从 Mods 文件夹中删除 StructureAtlas .zip 文件，将 jar 文件复制进去，确保该模组在你的世界中已勾选启用，然后重启世界。

开发路线图

当我确实有新内容要添加时，我就会更新这个模组。

计划中

• /atlas teleport <category|id> — 管理员直接跳转到指定结构
• /atlas nearest 带屏幕方向指示前往最近的结构
• 停用已废弃的 v1.1 短命令（它们仍然可用，但会附带提示）

考虑中 (v2.0)

• /atlas find <query> 按名称或类别进行模糊搜索
• 可选的全服发现广播
• 除了共享的默认图集外，支持每个玩家私有图集

作者的话

Structure Atlas 的存在是因为我总在自己的世界里找不到那些好废墟的位置。如果有某种结构类型无法被正确分类，或者你有什么想法，请留言——我会阅读每一条。

— LordDionysus