Surveyor Map Framework - Surveyor Map Framework 地图框架

一个适用于世界地图和路径点模组的开源后端（以及 API）！

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

Surveyor 是 Antique Atlas 4、Hoofprint 和 Via Romana 等模组的地图后端。

除了处理地形和路径点等地图数据的生成与保存外，Surveyor 还可以：

• 在你的地图上显示其他玩家，即使他们距离很远，甚至位于其他维度！
• 追踪你的探索进度；如果地图数据丢失或你更换了电脑，它还会从服务器恢复你的地图数据！
• 允许与你选择的其他玩家进行实时地图共享——地形、路径点，全部都能共享！
• 允许你随时切换地图前端，而不会丢失地图数据！
• 可从 Xaero's Minimap 导入路径点，并为 Waystones 和 OPAC 等模组提供集成。
• 采用完全模块化设计——因此像 Dead Reckoning 这样的模组可以在不启用地形扫描的情况下使用路径点功能。
• 内置与原版地图的同步集成：在制图台上潜行+使用即可同步！

命令

如果你是服务器管理员，或者没有安装地图前端，surveyor 也自带了一些实用命令：

• /surveyor 显示你已探索的区块与结构数量，以及已记录的路径点摘要。
• /surveyor share [player] 和 /surveyor unshare 用于加入和离开地图共享组。
• /waypoints 允许查看和编辑你记录的路径点。
• /landmarks 允许查看并（需要 op 2 或以上）编辑全局路径点。

Surveyor 数据以纯 NBT 格式存储在 data/surveyor 中（单人/服务器按维度存储，客户端则位于 .minecraft 中）。

配置

Surveyor 的配置可以在 config/surveyor.toml 中编辑，或在游戏内使用 McQoy 进行修改。其中包括：

• 切换地形、结构和地标子系统（否则客户端会由已安装的前端决定）
• 哪些数据应在客户端/服务器之间，以及组成员之间通过网络同步。
• 是否将服务器上的所有玩家都视为同一个全局地图共享组的一部分。
• 向客户端发送玩家位置更新的频率，以及向客户端同步缺失地形的速度。
• 是否允许以及如何处理已填写地图与 surveyor 数据的同步，包括全彩渲染。

模组开发者

如果你想基于 surveyor 开发些什么，欢迎来联系！当然不联系也没关系，我们不介意！我们很欢迎：

• 针对 surveyor enhancements and bugs) 提交 PR。
• 包含移植到较旧稳定版本（1.4.7、1.17.10、1.12.2、1.16.5、1.18.2）的 PR——或者根据政策移植到最新版
• 包含你能受益的 API 功能的 PR——理想情况下先发个 issue，我们可以一起打磨！
• 利用 surveyor 的兼容附加、世界地图、小地图和路径点前端！

服务端、网页地图、脱离 Minecraft 的应用……我们只是想在地图模组领域培育出有趣的新东西。

查看 frontend dev guide 以了解内部复杂部分的拆解说明。

如果你做出了什么作品，来告诉我们，我们会把它链接到这里！对于任何开发中的项目，我们也会回答问题。

开发者可以通过 modfest 上的论坛（#projects->Surveyor）、mastodon，或者干脆通过[电子邮件](mailto:sleepingdragoninn@gmail.com)联系。

后记

Surveyor 建立在社区中许多模组开发者的想法、建议、观点和过往作品之上。

感谢所有帮助这个项目实现的人，哪怕只是稍微在旁边支持一下——这对我们意义重大。

我们制作 surveyor，仅仅因为它听起来很酷——我们希望它也能帮助其他创作者/模组开发者做出很酷的东西！