Xaero's World Map

Fabric

Важное предупреждение

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

Что такое Xaero's World Map?

Это мод, который добавляет в клиент Minecraft автоматически заполняющуюся полноэкранную карту мира. Он работает как самостоятельный мод, но раскрывает весь свой потенциал в паре с Xaero's Minimap. Разделение на два мода сделано специально, чтобы мини-карта оставалась максимально легковесной.

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

Мод находится в активной разработке! Пожалуйста, сообщайте о любых найденных ошибках, иначе они, скорее всего, не будут исправлены.

Перед использованием: оптимизируйте мир

Убедитесь, что ваш мир оптимизирован для текущей версии Minecraft. Для этого в одиночной игре зайдите в Одиночная игра -> Выбрать мир -> Редактировать -> Оптимизировать мир. Повторяйте эту процедуру после каждого обновления игры. Генерация карты из неоптимизированных сохранений занимает значительно больше времени.

Возможности и интерфейс

Откройте карту мира, нажав клавишу M. Управление интуитивно понятное, как в Google Maps: перемещайтесь по карте мышью, а для увеличения/уменьшения масштаба используйте колесико мыши. Все основные управления указаны в подсказке на экране карты, и большинство из них можно настроить под себя.

Ключевые функции:

Автоматическое заполнение: Карта записывается сама по мере вашего исследования, в отличие от ручных бумажных карт.
Поддержка всех режимов: Работает в одиночной игре, на мультиплеерных серверах и Realms.
Управление несколькими мирами: На одном адресе сервера можно создавать несколько отдельных карт и переключаться между ними вручную или автоматически.
Серверные настройки: Если мод установлен на сервере, администраторы могут через внутриигровой интерфейс в реальном времени контролировать, как игроки используют мод, вплоть до привязки настроек к рангам и системам прав (поддерживаются FTB Ranks, Odyssey Roles, LuckPerms).
Интеграция с Open Parties and Claims: На карте отображаются чанковые клаймы и союзники из этого мода. Прямо с карты можно создавать клаймы или форсировать загрузку чанков.
Поддержка текстурпаков: Смена текстурпака приводит к полной перегенерации карты мира.
Карты пещерных измерений: Полноценная работа в Нижнем мире и подобных измерениях.
Режим ванильных карт: Опция, которая заставляет карту мира выглядеть как классические бумажные карты.
Настройка оттенков рельефа.
"Следы": На карте отображается ваш недавний путь.
Настройки производительности для оптимизации работы мода при необходимости.
Экспорт в PNG: Можно экспортировать всю карту в файл изображения (может не сработать для карт размером в миллионы блоков).
Привязка к предмету: Доступ к карте можно ограничить, потребовав наличия определенного предмета в горячей панели или слоте экипировки (например, компаса). Настраивается через конфиг-файл.

Тесная интеграция с Xaero's Minimap

Совместное использование с мини-картой открывает дополнительные возможности:

Мини-карта отображает чанки, предоставленные картой мира.
На карте мира отображаются путевые точки из мини-карты (также работает с Better PVP).
Прямо в интерфейсе карты мира можно создавать, редактировать и телепортироваться к путевым точкам.
Начиная с версии 1.14.0, в правом нижнем углу карты есть кнопка для открытия меню всех путевых точек с фильтрацией, управлением видимостью и наборами точек.

Контроль через зелья

Администраторы серверов могут управлять доступом к карте мира с помощью эффектов зелий:

xaeroworldmap:no_world_map — нейтральный эффект, запрещающий использование карты.
xaeroworldmap:no_world_map_harmful — вредоносная версия того же эффекта.

Часто задаваемые вопросы (FAQ)

Выбор и восстановление карт

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

Один адрес сервера может содержать несколько миров (например, лобби и игровой мир). На стороне клиента у них нет уникальных идентификаторов, поэтому мод позволяет создавать отдельные карты для каждого измерения на одном сервере.

Управление этим происходит через меню выбора карты (кнопка в левом нижнем углу экрана карты). Здесь можно выбрать режим:

Manual (Ручной): Запрос подтверждения при смене мира. Режим по умолчанию, самый безопасный.
World Spawn: Автоматический выбор на основе глобальной точки возрождения (как в старых версиях мода).
Single: Всегда используется одна карта.
Server: Лучший вариант. Сервер автоматически управляет выбором карты на основе своих внутренних ID. Требует установки мода на сервере.

Если после смены режима карта стала пустой, просто выберите нужную карту в выпадающем меню вверху экрана меню и подтвердите выбор.

Старая карта не отображается в меню? Это может означать изменение адреса сервера или ID измерений. Карты хранятся в папке xaero/world-map (в старых версиях — XaeroWorldMap). Перед любыми действиями сделайте её резервную копию.

Изменение ID измерения: Каждое измерение имеет свою папку (например, null — обычный мир, DIM-1 — Нижний мир). Карту можно переместить между этими папками.
Изменение адреса сервера: Можно переименовать папку старого адреса в папку нового, изменив только часть с адресом.

Работа с измерениями и пещерами

Как восстановить карты Нижнего мира, созданные до обновления 1.30, для отображения в режиме "полной" карты пещер? Выйдите с сервера. В игровой директории перейдите в xaero/world-map/Multiplayer_[адрес_сервера]/DIM-1/[папка_карты]. Создайте там папку caves, а внутри неё — папку -2147483648. Перенесите все файлы .zip из исходной папки карты в caves/-2147483648.

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

Сначала восстановите старые данные, как описано выше.
В настройках карты мира установите "Default Cave Mode Type" в OFF, а "Legible Cave Maps" — в ON.
На самой карте нажмите иконку пещеры внизу слева. Установите "Cave Mode Top Y" на любое число.
В обычном мире установите "Cave Mode Type" в OFF. В Нижнем мире переключите его на Full. Этот параметр сохраняется для каждого измерения отдельно.

Телепортация и путевые точки

Почему не работает телепортация по правому клику? Мод отправляет чат-команду для телепортации (по умолчанию /tp @s x y z). Для её выполнения нужны соответствующие права.

В ванильном варианте требуется статус оператора (читы).
На серверах с плагинами могут быть отдельные разрешения.
Команду можно изменить в настройках карты мира ("Map Teleport Command"). Для неванильных команд часто нужно убрать селектор @s.

Почему я не вижу путевые точки с мини-карты на сервере после установки карты мира? Текущая активная карта мира определяет, какой набор путевых точек из мини-карты считается "автоматическим". Вы можете вручную выбрать любой набор в меню путевых точек мини-карты (клавиша U) через выпадающее меню вверху справа. Чтобы сделать набор автоматическим для текущей карты, выберите в меню Options -> Make Sub-World Auto.

Исследование и запреты

Как открыть карту, не исследувая мир вручную?

В одиночной игре: Сгенерируйте мир любым инструментом предгенерации, перезайдите и используйте опцию "Reload Regions" в настройках карты.
На мультиплеере: Можно скачать сохранение сервера, открыть его в одиночной игре, сгенерировать, а затем через "Convert All Regions" в настройках конвертировать в формат, совместимый с мультиплеером. Полученную папку (xaero/world-map/World/null/cm$converted) нужно скопировать в соответствующую директорию на сервере.

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

Предпочтительный способ: Установите мод на сервер. Начиная с версии 1.40.0, используйте назначенную клавишу "Open Server Settings" для принудительного отключения режима пещер и других опций. В более старых версиях настройки находятся в общем конфиг-файле в папке сервера.
Альтернатива (без установки мода): Отправьте игрокам системное сообщение, содержащее специальный код:
- §f§a§i§r§x§a§e§r§o — отключает режим пещер на клиенте.
- §r§e§s§e§t§x§a§e§r§o — сбрасывает все флаги системных сообщений.
Также существуют сторонние решения: плагин XMMForceFairPlay для Spigot или датапак Xaero's Map Server Utils. Используйте их на свой страх и риск.

Как позволить игрокам с ванильным клиентом зайти на сервер с установленным модом? В общем конфиг-файле сервера (config/xaero/world-map) найдите опцию, отключающую регистрацию эффектов статуса (это то, что мешает ванильным клиентам подключиться). Сделайте то же самое для конфига мини-карты. После изменения требуется перезагрузка сервера.

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

Чтобы интегрировать свой мод с Xaero's World Map, добавьте в скрипт сборки репозиторий:

repositories {
    maven {
        url "https://chocolateminecraft.com/maven"
        name "Xaero's Maven"
    }
}

Затем добавьте зависимость, соответствующую вашему загрузчику и версии. Актуальные версии смотрите на https://chocolateminecraft.com/maven/xaero/map.

Примеры для Forge (Mojang mappings до 1.21.1):

implementation "xaero.map:xaeroworldmap-forge-<версия_minecraft>:<версия_мода>:dev"

Для Fabric:

modImplementation "xaero.map:xaeroworldmap-fabric-<версия_minecraft>:<версия_мода>"

Для NeoForge:

implementation "xaero.map:xaeroworldmap-neoforge-<версия_minecraft>:<версия_мода>"

Использование в модпаках и видео

Создание видео с использованием мода разрешено.
Использование в модпаках разрешено при соблюдении условий:
1. Монетизация модпака допускается только через платформы CurseForge или Modrinth (включая спонсорские ссылки/баннеры в описании). Для монетизации в других местах требуется мое письменное разрешение (обращайтесь, я скорее разрешу, чем нет).
2. Если модпак распространяется вне CurseForge и Modrinth, вы обязаны указать авторство, предоставив легко доступную ссылку на одну из моих официальных страниц мода.
3. Название и/или описание модпака не должно вводить в заблуждение, будто это мои моды.
4. Если я дал письменное разрешение на монетизацию вне CurseForge/Modrinth, то по моему запросу вы должны её прекратить.

Скачать Xaero's Minimap

Поддержать автора:

Mastodon: mas.to/@xaero96
Patreon: patreon.com/xaero96

Спасибо!

Все права на данный контент принадлежат его авторам. Мы не храним и не распространяем файлы — страница носит исключительно информационный характер. Оригинальный источник доступен по этой ссылке.