Surveyor Map Framework

Surveyor - это не мод-карта как таковой, а мощный backend и API для тех модов, которые рисуют карты и ставят точки на них. Если вы играете на сервере с друзьями и хотите, чтобы все видели одно и то же на своих картах - Surveyor решает именно эту проблему.

Он работает как общая база данных для картографических модов вроде Antique Atlas 4, Hoofprint и Dead Reckoning. Идея в том, что карты и метки хранятся централизованно, а не каждый игрок сам по себе.

Что даёт Surveyor

На клиенте (без серверной части)

• Просматривай разведанную местность и ставь точки интереса (waypoints)
• Автоматические метки для структур из других модов - например, для Waystones и OPAC
• Можно переключаться между разными картами-фронтендами - данные не пропадут
• Перенос точек из Xaero's Minimap простой командой

На сервере (оба игрока установили Surveyor)

• Карта и метки синхронизируются между всеми игроками в группе (по умолчанию - весь сервер)
• Видно других игроков, даже если они далеко или в другом измерении
• Можно сменить компьютер или раунд - данные подтянутся с сервера
• Админы могут ставить глобальные метки: спавн, магазины, точки телепортов
• Исследования можно копировать туда-сюда с ванильной картой через стол картографа (стиль настраивается)

Для разработчиков

• Писать чистые фронтенды для карт - Surveyor сам хранит данные о местности, структурах и точках
• Создавать аддоны с кастомными метками и компонентной системой
• Любой тип фронтенда: с сервером или без, внутриигровой или внешний, браузерный
• Использовать только систему точек для лёгких модов-компасов

Настройка

Конфиг лежит в config/surveyor.toml. Можно редактировать через McQoy или QoMC. Большинство изменений требует перезапуска.

• globalSharing=false - выключить общий доступ на весь сервер (рекомендуется для публичных серверов)
• В разделе Networking управляешь, какие данные синхронизируются между игроками и сервером
• В Builtins включаешь/выключаешь авто-метки: порталы в Незер, могилы и т.д.

Команды

Основное взаимодействие идёт через интерфейс карты, но полезные команды есть:

• /surveyor share/unshare - создать группу для совместного просмотра (если globalSharing=false)
• /surveyor, /waypoints, /landmarks - просмотр своих точек и исследованных данных
• /waypoints new/remove - создать или удалить личную метку (даже без фронтенда)
• /landmarks new/remove (оп 2) - создать/удалить глобальные метки для сервера (например, спавн)

Решение проблем

Клиентские данные лежат в .minecraft/data/surveyor/[мир]/[измерение], серверные - в [мир]/[измерение]/data/surveyor.

Файлы c.X.X - участки местности, s.X.X - структуры, landmarks.dat - метки.

Если что-то сломалось:

• Сделай бэкап и удали проблемные данные (например, для ошибок со структурами - удали файлы s.X.X)
• Для пакетов с картой, которые выкидывают с сервера - поставь networking.terrain в NONE
• Если сервер жрёт память - отключи terrain полностью (DISABLED)

Для разработчиков аддонов

Если хочешь допилить что-то под Surveyor - респект! Принимаются PR с исправлениями, портами на старые версии (1.4.7, 1.12.2, 1.16.5, 1.18.2) и новыми API-фичами. Лучше сначала обсудить в issue. Лицензия - LGPLv3 (желательно, чтобы её же использовали аддоны).

Surveyor делали не ради коммерции, а потому что идея звучала круто. Он реально упрощает кооперативное исследование мира в Майнкрафте.

Скачайте Surveyor вместе с любым совместимым фронтендом - и карта перестанет быть личным делом.