Surveyor Map Framework

Surveyor Map Framework — это универсальная библиотека для разработчиков модов, связанных с картами в Minecraft. Она предоставляет готовые решения для сканирования, сохранения и синхронизации картографических данных между игроками.

Для игроков

Важно: Surveyor — это библиотека для разработчиков модов с картами. Обычным игрокам не нужно устанавливать её отдельно.

Команды

• /surveyor — показывает информацию об исследованной территории и настройках совместного использования карт
• /surveyor share [имя_игрока] — запрос на совместное использование карт с другим игроком
• /surveyor unshare — отключение совместного использования карт
• /surveyor landmarks — просмотр всех ориентиров в разных мирах
• /surveyor landmarks get [тип] — список ориентиров указанного типа в текущем мире
• /surveyor landmarks remove [тип] [позиция] — удаление точки пути или ориентира
• /surveyor landmarks add [тип] [позиция] [название] — добавление точки пути
• /surveyor landmarks global [тип] [позиция] [название] — добавление глобального ориентира

Настройки

Библиотека предлагает расширенные настройки в файле config/surveyor.toml, которые позволяют тонко настроить различные системы и параметры совместного использования карт.

Возможности для разработчиков

Surveyor берёт на себя основные задачи по работе с картами:

• Автоматическое сканирование и запись данных о рельефе, структурах и ориентирах
• Реализация совместного использования карт между игроками в реальном времени
• Синхронизация данных карт и ориентиров при совместном использовании
• Предоставление универсального API для интеграции с модами карт
• Эффективное хранение данных с минимальным увеличением размера сохранений (2-5%)

Ключевые особенности данных

• Рельеф: включает информацию о блоках, высоте, биомах, уровне освещения и глубине воды
• Многоуровневость: поддержка карт пещер и Нижнего мира через несколько слоёв сканирования
• Структуры: полная информация об идентификаторах, частях и тегах структур
• Ориентиры: универсальная система для точек интереса, маркеров и других позиционных данных

Технические детали

Основные концепции

• World Summary — содержит все данные Surveyor для мира
• Chunk Summaries — представление рельефа мира сверху
• Structure Summaries — информация о структурах мира
• Landmarks — система для хранения позиционных данных на карте
• Exploration — запись исследованных областей для каждого игрока

Слои сканирования рельефа

Для создания карт пещер Surveyor сканирует верхние слои блоков на разных высотах:

Верхний мир:

• 257-319: обычно пусто
• 62-256: поверхностный рельеф
• 0-61: морское дно, реки, пещеры
• -64-0: глубокие пещеры

Нижний мир:

• 127-255: бедрок
• 71-126: высокие пещеры
• 41-70: средний уровень
• 0-40: лавовое море

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

repositories {
    maven { url 'https://repo.sleeping.town/' }
}

dependencies {
    modImplementation 'folk.sisby:surveyor:0.3.0+1.20'
    include 'folk.sisby:surveyor:0.3.0+1.20'
}

Примеры использования

• Antique Atlas 4 — стилизованный клиентский мод карт
• SurveyorSurveyor — генератор изображений карт в стиле ванильного улучшения
• Surveystones — автоматическое добавление ориентиров для камней путей

Важное замечание

Surveyor находится на ранней стадии разработки. API, формат сети и сохранений могут меняться в версиях 0.x.