Antique Atlas 4

一款手绘风格的客户端世界地图，支持地图共享、结构发现等功能！

这是对 Antique Atlas 的重写版本，最初由 Hunternif 开发，后续由 Kenkron、asie 和 tyra314 继续维护。

需要 Surveyor Map Framework。
在 (neo)forge 上需要 Connector 和 FFAPI。

随时按下 [M] 键即可打开世界地图。

拖动地图即可平移，滚动鼠标滚轮即可缩放，还可以使用书签按钮创建和移除地图标记。

客户端功能

具有实体感的地图界面，使用手绘风格的区块贴图来呈现世界中的区块：

提供多种样式和强调色的路径点标记：

在铁砧中将一本书重命名为 “Antique Atlas”，即可将地图拿在手中：

自动迁移 Xaero的小地图中的路径点，并与 Hoofprint 使用共享存档格式。
通过 Antique Trains 和 Dead Reckoning 等附加模组获得更多功能！

混合端 / 单人游戏功能

会自动为 notable 结构和已激活的下界传送门添加标记：

只有在游戏中查看过或站在结构上时，结构才会显示在地图上：

可以通过 /surveyor share [player] 与好友共享地图探索进度和路径点：

添加 AA4 Atlas，即可为手持地图添加完整的物品 ID 和合成配方！

故障排除 / 建议

Antique Atlas 4 是 Surveyor Map Framework 的客户端地图前端。

它会使用资源包将 Surveyor 的存档数据渲染为屏幕上的图块，并提供用于编辑路径点的 GUI 编辑器。

有关屏幕、图块、标记和资源包的问题与建议，请前往 Antique Atlas 4 Issues。

有关地图分享、已探索地图区域和自动标记的问题与建议，请前往 Surveyor Issues。

崩溃报告必须确保 AA4 和 Surveyor 均为最新版本，并通过 mclo.gs 提供 logs/latest.log。

配置

可以通过 config/antique-atlas.toml 配置 Antique Atlas，也可以在游戏内使用 McQoy 进行配置，包括：

是否必须在物品栏中拥有地图册物品，才能启用地图快捷键。
调整地图界面的大小和缩放比例。
调整要在地图上标记的结构。
调整玩家墓碑的样式。

其他选项可以在 Surveyor 的配置文件 config/surveyor.toml 中找到。

插件与资源包开发者

资源包

图块、标记、生物群系检测和结构检测完全由资源包中的数据驱动。

如果没有定义生物群系，地图册会通过标签“猜测”图块；如果猜测失败，则会显示 ???。

有关 AA4 资源包的制作方法，请参阅资源包教程。

API

目前没有稳定的 API！但欢迎自行研究：

repositories {
	maven { url "https://repo.sleeping.town/" }
}
dependencies {
	modImplementation "folk.sisby:antique-atlas:3.0.0+1.20"
}

对于非 Surveyor 模组兼容性（即已经拥有客户端同步功能的模组），可以尝试使用 AtlasRenderer.registerOverlay()。

如果想要自动标记非结构类兴趣点，请改用 Surveyor 的 Landmark API。

许可协议与署名

请将你的插件/资源包的代码和资源许可协议分别与 LGPLv3 和 CC BY-NC-SA 保持一致，以帮助生态发展！

（LGPLv3 和 CC BY-NC-SA 都是著佐权许可协议，因此任何直接改编自 AA4 的内容都必须遵守这一要求。）

如果你制作了插件/资源包，欢迎联系我们，我们可能会在这里添加链接！如果仍处于 WIP 阶段，也可以随时向我们提问。

开发者可以通过 mastodon、电子邮件，或在 ModFest 上的 #projects->Surveyor 频道联系我们。

后记

所有模组都建立在许多其他人的成果之上。

antique atlas 的美术作品由 Hunternif（DA）和 lumiscosity（Neocities）创作。

点击这里查看详细的美术贡献名单。

这个模组是一次致敬式重写，深深依赖于许多前辈开发者和艺术家的贡献。

截图

介绍