Xaero's World Map - это мод для Minecraft, который добавляет автоматически заполняющуюся полноэкранную карту мира. В отличие от ванильных бумажных карт, которые нужно крафтить и вручную заполнять, эта карта пишется сама, пока вы исследуете мир. Работает как отдельный мод, но гораздо лучше раскрывается в связке с Xaero's Minimap. Причина, по которой они доступны отдельно - чтобы Xaero's Minimap оставался максимально легковесным. Мод в основном клиентский. Установка на сервер опциональна и нужна для некоторых дополнительных функций, вроде идентификации миров.

Мод все еще в разработке! Если найдете баги - сообщайте, иначе их, скорее всего, не исправят.

Убедитесь, что ваш мир оптимизирован (Singleplayer - Edit - Optimize World) для версии Minecraft, в которую вы играете (повторяйте после каждого обновления Minecraft). Генерация карт из неоптимизированных сохранений в одиночной игре занимает ГОРАЗДО больше времени.

Возможности

• Автоматически заполняющаяся карта мира (в отличие от ручных бумажных карт). Вы можете создавать несколько карт на одном сервере и переключаться между ними вручную или автоматически.
• Работает в одиночной игре, на сервере и на Realms.
• Интуитивный интерфейс. Откройте карту нажатием M. Перемещайте карту мышью и масштабируйте колесиком мыши, как в Google Maps. Все управление отображается в подсказках на экране карты, и многое можно настроить.
• Опциональное автоматическое определение нескольких миров на серверах.
• Серверные конфиги с внутриигровым UI, позволяющие в реальном времени контролировать, как игроки используют мод. Можно привязать к рангам/правам (xaero.world_map.enforced_server_profile). Поддерживает FTB Ranks, Odyssey Roles, LuckPerms и общие API разрешений.
• Отображает чанки, занятые под приваты, и союзников из мода Open Parties and Claims. Позволяет приватить или форс-лоадить чанки прямо с карты.
• Поддержка ресурспаков. Смена ресурспаков вызывает перегенерацию всей карты мира.
• Поддержка измерений-пещер (например, Незер).
• Опциональный режим ванильных карт, который делает карту мира похожей на ванильные бумажные карты.
• Настройка затенения рельефа.
• "Следы", показывающие ваш недавний путь.
• Настройки для улучшения производительности мода при необходимости. Хотя в большинстве случаев мод работает отлично по умолчанию.
• Интеграция с Xaero's Minimap. Мини-карта будет отображать чанки, предоставленные картой мира. Карта мира будет отображать точки пути из Xaero's Minimap. Также работает с модом Better PVP. Вы можете создавать, редактировать и телепортироваться к точкам пути, не выходя из интерфейса карты.
• Эффекты зелий для контроля использования карты мира игроками на вашем сервере/карте. На данный момент существует эффект: xaeroworldmap:no_world_map. По умолчанию эффекты нейтрального типа, но можно указать вредоносный тип, добавив harmful в конец ID эффекта, например xaeroworldmap:no_world_map_harmful.
• Начиная с версии 1.14.0 можно открыть меню точек пути на карте, нажав на иконку в правом нижнем углу экрана карты. В меню точек пути вы увидите список всех точек пути из отображаемых наборов, можете взаимодействовать с ними мышью, фильтровать по имени. Меню также позволяет переключать видимость отключенных точек пути, отображение всех наборов и менять текущий набор точек пути. Наведение на точки пути в меню также подсвечивает их на карте.
• Опция экспорта карты в PNG. Мод пытается экспортировать всю карту целиком, так что может не сработать, если карта имеет размеры в миллионы блоков. В будущем планируется добавить больше опций для экспорта!
• Опция ограничения доступа к карте путем привязки к предмету в хотбаре или экипировке. Например, добавьте mapItemId:minecraft:compass в конфиг, чтобы привязать карту к компасу. Карта не будет работать, пока компас не будет в хотбаре или экипирован.

Скачать Xaero's Minimap

Важно знать

Как восстановить карты Незера до обновления 1.30 в мультиплеере для отображения в режиме "полных" пещер?

Сначала выйдите с сервера и найдите директорию игры Minecraft, которую вы используете для игры на сервере. В директории игры перейдите в xaero/world-map/Multiplayer[server_address]/DIM-1/[map_folder]_. В старых версиях xaero/world-map - это просто XaeroWorldMap. Если такой папки еще нет, создайте папку с названием "caves" (без кавычек) и зайдите в нее. Внутри папки caves создайте папку с названием "-2147483648" (без кавычек), если такой еще нет. Вернитесь в папку, содержащую папку "caves", и переместите все файлы ".zip" в папку caves/-2147483648. Можете также переместить папки кэша вместе с файлами ".zip".

Как настроить режим пещер, чтобы он работал как до версии 1.30?

Полностью этого можно добиться только при использовании обычной версии мини-карты или без нее вообще. Fair-play версия мини-карты теперь отключает режим пещер карты мира в Незере, и это нельзя изменить.

Если у вас есть данные карты Незера до версии 1.30, сначала переместите их в правильную папку, как описано выше. После этого зайдите на мир/сервер и откройте настройки карты мира. Найдите "Default Cave Mode Type" и установите его в OFF, затем установите "Legible Cave Maps" в ON. Далее откройте экран карты мира и нажмите на иконку пещеры в левом нижнем углу экрана. В открывшемся меню установите "Cave Mode Top Y" на любое число. Если вы в обычном мире, установите "Cave Mode Type" в OFF. Когда вы будете в Незере позже, установите "Cave Mode Type" в Full. Тип режима пещер сохраняется для каждого измерения.

Почему у меня не работает телепортация по правому клику?

Мод отправляет чат-команду для телепортации по координатам, по умолчанию это /tp @s x y z, так что нужны соответствующие права. Ванильная команда /tp требует статуса оператора (включенные читы), но можно настроить отдельные права для команд на сервере с плагинами. Используемую команду можно изменить в настройках карты мира с помощью "Map Teleport Command". Неванильные команды телепортации часто не поддерживают селекторы типа @s, так что возможно придется удалить его из команды. Также есть опция "Player Teleport Command", которая используется при правом клике по отслеживаемым игрокам (например, ваша группа из Open Parties and Claims). Телепортация к точкам пути использует свою собственную настройку в моде мини-карты.

Как открыть карту без ручного исследования?

В одиночной игре карта загружается напрямую из сохранения мира. Это значит, что вы можете предварительно сгенерировать мир любыми инструментами, перезайти и использовать опцию "Reload Regions" в настройках карты мира для исправления конфликтов в кэше карты. В мультиплеере это сложнее. Однако, если вы можете скачать сохранение серверного мира и зайти в него в одиночной игре, то вы можете предварительно сгенерировать мир любым способом, перезайти и затем использовать опцию "Convert All Regions" в настройках карты мира для конвертации всего сохранения мира в совместимый с мультиплеером экземпляр карты, сохраненный в xaero->world-map->World->null->cm$converted. В старых версиях xaero/world-map - это просто XaeroWorldMap. Вы можете скопировать/переместить эту папку экземпляра карты в ваши серверные экземпляры карт в папке xaero/world-map.

Почему несколько миров на одном сервере используют одну и ту же карту?

Этот мод позволяет иметь несколько карт на одном сервере. Вы можете свободно переключаться между ними и создавать новые в любое время. Перезапись карты можно предотвратить, выбрав правильный режим выбора карты для типа сервера, на котором вы играете. Выбор карты осуществляется в специальном меню по клику на левую нижнюю иконку на экране карты мира (если меню не открыто по умолчанию). В меню вы можете переключаться между режимами Manual, World Spawn и Single, а также выбирать/создавать карты через выпадающее меню в центре сверху. Если навести курсор на опцию Map Selection, можно прочитать все необходимое о каждом режиме выбора карты, включая Server режим. World Spawn режим - это аналог того, что использовалось до версии 1.6. Server режим - лучший вариант для большинства случаев, так как сервер автоматически управляет выбором карты на основе серверных ID уровней. Требует установки мода на серверной стороне.

Почему карта мира запрашивает подтверждение?

Один сервер может иметь несколько обычных миров, Незеров и т.д. Это может быть связано с несколькими подсерверами или просто несколькими сохранениями миров, например мир "Lobby" и мир "Game". У разных миров нет уникальных идентификаторов на клиентской стороне, что делает невозможным надежное различие между ними. Из-за этого мод позволяет иметь несколько карт мира для каждого измерения на одном сервере. В старых версиях мода по умолчанию выбор карты был Manual, что означает запрос подтверждения каждый раз при смене измерений/миров/подсерверов.

Почему я не вижу точки пути мини-карты на сервере после установки Xaero's World Map?

Ваша текущая подтвержденная карта влияет на то, какой подмир точек пути в моде мини-карты считается автоматическим. Это позволяет каждой созданной карте иметь отдельные данные точек пути. В любой момент вы можете выбрать и просмотреть любой неавтоматический подмир точек пути через меню точек пути (клавиша U) и выбором из выпадающего меню справа сверху.

Почему моя карта мира "сбросилась" для конкретного сервера?

Не паникуйте. Скорее всего она не удалена. Старые версии используют систему на основе точки спавна мира для разделения сервера на несколько карт. Эта система часто ломается из-за того, что серверы добавляют кастомный функционал к ванильному компасу путем отправки фейковых координат спавна мира вашему клиенту игры. Убедитесь, что вы обновили мод до последней версии. Теперь есть несколько режимов выбора карты, Manual - по умолчанию.

Старая карта не отображается в меню? Это может означать две вещи: изменился адрес сервера или ID измерений.

Если изменился ID измерения - каждое измерение на сервере имеет отдельную директорию в game directory -> xaero -> world-map. В старых версиях xaero/world-map - это просто XaeroWorldMap. Пожалуйста сделайте резервную копию директории xaero/world-map перед тем как что-то делать. В старых версиях имя директории измерения содержит адрес сервера и ключ измерения, например XaeroWorldMap/Multiplayer_127.0.0.1_DIM1. В новых версиях директория измерения является поддиректорией: xaero/world-map/Multiplayer_127.0.0.1/DIM1. По соображениям совместимости измерения по умолчанию (обычный мир, Незер и Энд) называются null, DIM-1 и DIM1. Другие измерения должны иметь имя на основе оригинального ID измерения.

Если изменился адрес сервера - сначала удалите все директории внутри game directory -> xaero -> world-map, содержащие новый адрес сервера. Сделайте резервную копию всей директории xaero/world-map. Затем переименуйте каждую старую директорию адреса сервера (в xaero/world-map) в новый адрес.

Как запретить использование режима пещер на моем сервере?

Для этого установите мод на серверной стороне (требуется NeoForge/Forge/Fabric/Quilt сервер).

Если ваша версия Xaero's World Map не ниже 1.40.0, то установите и используйте привязку клавиш "Open Server Settings" для открытия серверных настроек. Там можно принудительно включить почти любую опцию, включая Cave Mode.

В более старых версиях при запуске сервера будет создан новый конфигурационный файл "common" в директории сервера (не папке мира), обычно в папке "config". В нем есть опции для отключения определенных функций мода для игроков.

В качестве альтернативы можно включить следующие строки в системное сообщение сервера игрокам (при входе): §f§a§i§r§x§a§e§r§o - отключает режим пещер у клиента. §x§a§e§r§o§w§m§n§e§t§h§e§r§i§s§f§a§i§r - заставляет режим пещер работать в Незере даже при fair-play режиме. §r§e§s§e§t§x§a§e§r§o - сбрасывает все флаги системных сообщений.

Существует сторонний плагин для Spigot: XMMForceFairPlay (не аффилирован со мной). И сторонний датапак: Xaero's Map Server Utils Используйте любые сторонние дополнения на свой страх и риск.

Как разрешить игрокам с ванильным клиентом заходить на мой сервер с установленным модом?

Найдите конфигурационный файл "common" в папке config непосредственно в директории вашего сервера (не папке мира), обычно config/xaero/world-map. Одна из опций позволяет отключить регистрацию эффектов статуса, что и мешает игрокам заходить.