Xaero's Minimap

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

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

Основные возможности

На карте отображаются окружающие сущности: игроки, мобы и предметы. Их можно показывать как точки с настраиваемым цветом или как иконки (обычно головы). Помимо сторон света, вы можете ставить собственные метки (waypoints), видимые и на мини-карте, и в мире. Они помогают находить ранее посещённые места или конкретные координаты, а также поддерживают опциональную телепортацию.

Карта работает как на поверхности, так и под землёй благодаря автоматическому пещерному режиму, который активируется и внутри зданий. Для честной игры на PVP-серверах существует две версии мода: полная и честная (fair-play), последняя не показывает сущности и пещерные карты.

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

Поддержать автора можно на Patreon: patreon.com/xaero96

Полный список функций

• Интеграция с ванильным стилем.
• Несколько вариантов размера карты, включая автоматический.
• Несколько уровней приближения.
• Две формы карты: квадрат или круг.
• Работает плавнее, чем многие аналогичные моды.
• Карту можно расположить в любом месте экрана с точностью до пикселя.
• Два режима цвета блоков: Ванильный (использует цвета ванильных карт) и Точный (использует цвета текстур блоков и биомов). Для ванильного режима можно отдельно включить цвета биомов.
• Горячая клавиша (по умолчанию Z) для временного увеличения карты. Все привязки клавиш находятся в стандартном меню управления.
• Настройка затенения рельефа: «Глубина рельефа» и «Наклоны рельефа».
• Совместимость с Xaero's World Map. По умолчанию использует текстуры карты, сгенерированные этим модом, что улучшает производительность.
• Серверные конфиги с внутриигровым интерфейсом для контроля использования мода игроками в реальном времени. Можно привязать к рангам/правам (xaero.minimap.enforced_server_profile). Поддерживает FTB Ranks, Odyssey Roles, LuckPerms и общие API разрешений.
• Возможность привязать отображение карты к предмету в хотбаре или слоте экипировки (например, к компасу).
• Эффекты зелий для управления использованием карты или её функций на сервере. Существуют эффекты: xaerominimap:no_minimap, xaerominimap:no_entity_radar, xaerominimap:no_waypoints, xaerominimap:no_cave_maps. По умолчанию они нейтральные, но можно сделать вредными, добавив _harmful к ID эффекта.
• Переведён на множество языков.
• Метки (Waypoints): Практически неограниченное количество. Можно телепортироваться (нужны права на команду телепортации). Нажмите B, чтобы создать новую метку, и U, чтобы открыть список всех меток.
• Локальные и глобальные метки. Локальные метки скрываются за пределами заданного расстояния («Max WP Draw Distance»), что помогает не загромождать экран.
• Наборы меток (Waypoint sets). Метки можно сортировать по наборам, которые быстро переключаются горячей клавишей.
• Обмен метками с другими игроками сервера через игровой чат.
• Точки смерти (Deathpoints). При каждой смерти автоматически создаётся метка в виде черепа. Старые точки смерти можно преобразовать в обычные метки.
• Отображение чанк-клеймов и союзников из мода Open Parties and Claims.
• Переключаемая сетка чанков.
• Переключаемый режим слимовых чанков (отмечаются зелёным).
• Пользовательский световой оверлей для поиска блоков с определённым уровнем освещённости (по умолчанию для поиска мест спавна мобов).
• Определение мультимира в мультиплеере. При установке мода на сервер каждый мир получает отдельный «под-мир» для меток.
• Радар сущностей (Entity Radar):
  • Мобы отображаются как жёлтые точки. Враждебных и дружелюбных можно окрасить по-разному. Также возможен показ в виде иконок/голов.
  • Игроки — как белые точки или головы.
  • Предметы — как красные точки.
  • Прочие сущности (стрелы, рамки и т.д.) — как фиолетовые точки.
  • Опция отображения имён сущностей на карте.
• Горячие клавиши для приближения/отдаления (по умолчанию I и O).
• Под картой можно отображать:
  • Координаты.
  • Название текущего биома (выключено по умолчанию).
  • Уровень освещённости (выключено по умолчанию).
  • Игровое время (12- или 24-часовой формат).
  • Углы обзора камеры.
• Настройка скрытия координат меток со всех экранов (полезно для стримов).
• Настройка скрытия упоминаний адресов серверов в выпадающих меню.
• Огромное количество других настроек. Нажмите Y в игре, чтобы открыть меню настроек.

Скачать честную (fair-play) версию Скачать Xaero's World Map

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

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

Возможных причин несколько. Мод отправляет чат-команду для телепортации, по умолчанию /tp @s x y z, поэтому необходимы соответствующие права. Ванильная команда /tp требует статуса оператора, но на серверах с плагинами могут быть отдельные разрешения. Используемую команду можно изменить в настройках мини-карты («Default Teleport Command») или для конкретного сервера в меню меток («Teleport Chat Command»). Неванильные команды телепортации часто не поддерживают селекторы вроде @s, поэтому его, возможно, придётся убрать.

Если кнопка «Teleport» неактивна, это также может означать разное. Частая причина — ручной выбор «под-мира» для меток, который не является «авто», хотя и находится в том же измерении. Если «авто» под-мир выбран неправильно, выберите нужный под-мир в выпадающем меню справа сверху и используйте «Make Sub-world Auto» в меню Options. Это переместит все данные меток между под-мирами.

Если «авто» под-мир выбран, но телепортация всё ещё отключена, вероятно, она была отключена вручную для этого сервера/мира. Проверьте соответствующую опцию в меню Options. Если она отключена, включить её можно только через серверный конфиг-файл в папке игры -> xaero/minimap (в старых версиях XaeroWaypoints).

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

Не паникуйте, они почти наверняка не удалены. Сначала откройте полное меню меток (клавиша U). Проверьте все «под-миры» в выпадающем меню справа сверху. Если среди них нет нужных меток для текущего мира/измерения, возможно, изменился адрес сервера. Найдите старый адрес в выпадающем меню слева сверху, выберите его и используйте Options -> Make World/Server Auto. Теперь в правом меню должен появиться правильный под-мир.

Если вы используете мод мировой карты: одна из частых причин неправильного автоматического выбора под-мира — некорректное подтверждение карты в мультиплеере (начиная с версии 1.6 мода карты). Убедитесь, что вы выбрали правильную карту для текущего мира перед подтверждением. Подтверждённая карта влияет на то, какой под-мир меток считается автоматическим.

Если вы не используете мод мировой карты: проблема может быть вызвана плагином сервера, который меняет поведение ванильного компаса и мешает определению «мультимира» (если оно включено). В таких случаях компас часто указывает на кровать, а не на глобальную точку возрождения. Повторный сон в нужной кровати может всё вернуть. Если проблема из-за нового плагина, восстановите метки вручную:

1. Найдите нужный «под-мир» с метками в правом выпадающем меню.
2. Используйте Options -> Make sub-world auto.
3. Повторите для каждого измерения (зайдите в измерение перед этим!).
4. Если сервер простой, с одним миром, отключите «Multiworld Detection» в том же меню Options.

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

Сначала убедитесь, что иконки/головы сущностей включены в настройках мини-карты -> Entity Radar Categories.

Начиная с версии 21.6.0, вы можете переопределять стандартные иконки, создав ресурспак (или добавив ресурсы в свой мод). Соответствующая директория для ассетов — /assets/xaerominimap/entity/icon/. В jar-файле мода есть пример файла для переопределения иконок мобов из модов: /assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json. Изучите комментарии в этом файле, чтобы понять структуру.

Также в папке /assets/xaerominimap/entity/icon/definition/minecraft/ есть примеры для ванильных сущностей. Если в конфиг-файле мини-карты установить опцию debugEntityVariantIds в true, ID вариантов новых сущностей будут выводиться в чат и консоль.

Начиная с версии 21.8.0, можно настраивать собственную рендеринг-логику на основе моделей.

Посмотрите реальный пример реализации: ресурспак Modded Support от babybluetit.

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

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

Если ваша версия мини-карты не ниже 25.3.0, используйте привязку клавиш «Minimap Server Settings» для открытия настроек сервера. Там можно принудительно задать почти любую опцию, включая Cave Mode и Entity Radar.

В более старых версиях при запуске сервера в его директории (обычно в папке config) создаётся «общий» конфиг-файл. В нём есть опции для отключения определённых функций мода для игроков. Изменения требуют перезапуска сервера.

Альтернативно, если установить мод нельзя, можно отправлять игрокам (при входе) специальные строки в системных сообщениях:

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

Также существуют сторонние решения:

• Плагин для Spigot: XMMForceFairPlay
• Датапак: Xaero's Map Server Utils

Используйте сторонние аддоны на свой страх и риск.

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

Найдите «общий» конфиг-файл в папке config в директории вашего сервера (не в папке мира), обычно config/xaero/minimap. Одна из опций позволяет отключить регистрацию эффектов статуса, что и мешает подключению ванильных игроков. Изменения требуют перезапуска сервера. То же самое нужно проделать для мода мировой карты.

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

Для интеграции с вашим модом добавьте в скрипт сборки репозиторий:

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

На Forge (кроме 1.12.2) убедитесь, что в проекте применён плагин Mixin gradle (org.spongepowered.mixin).

Затем добавьте одну или несколько зависимостей, заменив <minecraft version> и <mod version> на актуальные значения с страницы мавена.

Forge с официальными маппингами Mojang до 1.21.1:

implementation "xaero.minimap:xaerominimap-forge-<minecraft version>:<mod version>:dev"//purposely no deobfuscation!

Forge с официальными маппингами Mojang на 1.21.1 и новее:

implementation "xaero.minimap:xaerominimap-forge-<minecraft version>:<mod version>"

Forge с другими маппингами:

implementation fg.deobf("xaero.lib:xaerolib-forge-<minecraft version>:+")
implementation fg.deobf("xaero.minimap:xaerominimap-forge-<minecraft version>:<mod version>")

Fabric:

modImplementation "xaero.minimap:xaerominimap-fabric-<minecraft version>:<mod version>"

NeoForge:

implementation "xaero.minimap:xaerominimap-neoforge-<minecraft version>:<mod version>"

В «common» проектах для мульти-лоадерных сборок:

compileOnly "xaero.minimap:xaerominimap-common-