Surveyor Map Framework

Серверная часть (и API) с открытым исходным кодом для совместной работы с картами мира и модами путевых точек!
Требуется Соединитель и FFAPI на (neo)forge.

---

Surveyor — это серверная часть таких модов карт, как Antique Atlas 4, Hoofprint и Dead Reckoning.
]

При установке на стороне клиента Surveyor позволяет:

• Просматривайте исследованную местность и отмечайте достопримечательности с помощью путевых точек.
• Просматривайте ориентиры на карте для других модов с помощью дополнений совместимости, например, для Waystones и OPAC].
• Замените интерфейс карты в любое время, сохранив все данные карты.
• Автоматически переносить путевые точки непосредственно из существующего сохранения мини-карты Xaero.

При установке с обеих сторон Surveyor позволяет:

• Исследуйте местность на карте и редактируйте путевые точки в совместных группах ** (по умолчанию для всего сервера)**
• Смотрите других игроков на своей карте, даже далеко или в других измерениях.
• Поменяйте местами экземпляры или компьютеры, при этом данные вашей карты будут восстановлены с сервера.
• Используйте команды op для создания общесерверных ориентиров для POI, таких как места возрождения, магазины, варп-центры и т. д.
• Копируйте исследования с и на ванильные карты, используя картографическую таблицу (стиль настраивается)

Как разработчик модов, Surveyor позволяет вам:

• Создавайте чистые интерфейсы карты, самостоятельно обрабатывая все данные карты — рельеф, структуры и путевые точки.
• Создавайте дополнения для пользовательских ориентиров на карте с помощью гибкой системы данных в виде компонентов.
• Создавайте любой вид интерфейса: серверный, внутриигровой/смешанный, внешний/браузерный и т. д.
• Используйте систему путевых точек отдельно для небольших и легких модов путевых точек/компаса.

Конфигурация

Surveyor можно настроить с помощью config/surveyor.toml, McQoy или QoMC. Большинство изменений требуют перезагрузки.

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

Команды

Взаимодействовать с Surveyor в основном можно через интерфейс карты, но он включает в себя несколько полезных команд:

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

Устранение неполадок

Сообщайте о любой уникальной воспроизводимой проблеме на странице проблем с журналами, снимками экрана и шагами репликации, где это возможно.

Данные клиента хранятся в .minecraft/data/surveyor/[world]/[dim], данные одиночной игры/сервера — в [world]/[dim]/data/surveyor
. Файлы c.X.X содержат регионы местности, файлы s.X.X содержат структуры, а landmarks.dat содержат данные путевых точек.

При возникновении проблем вы можете попробовать любое из следующих действий:

• Резервное копирование затронутых данных и их удаление (например, в случае ошибки, связанной со структурой, очистите данные структуры)
• Отключение сети для подсистемы (например, для запуска клиента пакета местности установите от networking.terrain до NONE)
• Отключение подсистемы (например, для чрезмерного использования памяти сервера установите от terrain до DISABLED на сервере)

Вклады/Дополнения

Не стесняйтесь обращаться к нам, если вы хотите разработать что-то с помощью Surveyor — или просто сделайте это! Мы ценим:

• Пиарщики критикуют улучшения и ошибки геодезиста
• PR, содержащие порты для более старых установленных версий (1.4.7, 1.17.10, 1.12.2, 1.16.5, 1.18.2) - или новейшие, в зависимости от политики
• PR-запросы, содержащие функции API, которые могут вам пригодиться. В идеале сначала опубликуйте проблему, и мы сможем ее обсудить.
• Аддоны для совместимости, карты мира, мини-карты и интерфейсы путевых точек с использованием Surveyor!

Ознакомьтесь с руководством для разработчиков внешнего интерфейса, где подробно описаны сложные части внутреннего устройства.

Лицензирование / Кредит

Пожалуйста, по возможности сопоставьте свои лицензии на дополнения с LGPLv3 — это поможет улучшить экосистему геодезистов!
(LGPLv3 — это лицензия с авторским левом, поэтому она необходима для всего, что напрямую адаптировано из Surveyor)

Если вы что-то написали, свяжитесь с нами, и мы, возможно, разместим ссылку здесь! Мы также ответим на вопросы по незавершенным проектам.
Разработчики могут связаться с нами по адресу mastodon или по электронной почте](mailto:sleepingdragoninn@gmail.com).

Послесловие

Surveyor был создан на основе мыслей, советов, мнений и прошлых работ многих моддеров сообщества.

Спасибо всем, кто помог осуществить этот проект, пусть даже просто трепыхая в сторонке – это очень много значит.

Мы создали Surveyor, потому что это звучало круто — мы надеемся, что это поможет другим художникам и моддерам создавать крутые вещи!