Не используйте XaeroPlus с этим модом! Он не связан со мной и вызывает критические неотслеживаемые ошибки/краши. Также, по слухам, он связан с группой гриферов, что может подвергнуть риску постройки на вашем сервере.
В отличие от многих других модов миникарты, миникарта Xaero сохраняет эстетику ванильного Minecraft, что делает её более органичным дополнением к игре. Это также первая вращающаяся квадратная миникарта для Minecraft. Среди множества настроек кастомизации есть опция для миникарты круглой формы и отдельная настройка для фиксации вращения миникарты (с использованием стрелки направления). Миникарта может отображать окружающие сущности, включая игроков, мобов и предметы, в виде точек с пользовательским цветом или в виде иконок (обычно голов). В дополнение к стандартным сторонам света вы можете размещать собственные точки пути, видимые как на миникарте, так и в игровом мире. Точки пути помогают находить ранее посещённые места или достигать определённых координат, с опциональной телепортацией. Миникарта может отображать окружающие блоки над землёй и под землёй (режим пещер). Это лишь некоторые из функций мода, их гораздо больше. Пожалуйста, прочитайте раздел «Возможности миникарты» ниже для более полного списка. Для соблюдения правил многопользовательских серверов существуют 2 редакции мода: полная и fair-play, последняя предназначена для честного PvP. Этот мод в основном клиентский. Установка на стороне сервера опциональна для некоторых дополнительных функций, таких как идентификация мира.
Возможности
- Внешний вид ванильного Minecraft.
- Несколько вариантов размера миникарты, включая автоматический.
- Несколько вариантов масштабирования.
- Два варианта формы миникарты: квадрат или круг.
- Работает плавнее, чем многие моды миникарты.
- Может быть размещена в любом месте экрана с помощью настройки/экрана «Изменить позицию». Можно сдвигать даже на 1 пиксель. Может быть полезно при использовании с другими модами интерфейса.
- 2 режима цвета блоков: Vanilla, использующий цвета ванильных карт Minecraft, и Accurate, использующий цвета текстур блоков и биомов. Также можно включить цвета биомов для режима Vanilla с помощью отдельной настройки.
- Пользовательская привязка клавиши (по умолчанию Z) для временного увеличения миникарты, чтобы лучше осмотреться. Все привязки клавиш находятся в меню управления ванильной игры. Также есть настройки для управления поведением миникарты при увеличении, например, для центрирования миникарты на экране или полного отдаления.
- Настройка затенения карты с помощью параметров «Глубина рельефа» и «Наклоны рельефа».
- Совместимость с Xaero's World Map. По умолчанию использует текстуры карты, сгенерированные модом мировой карты, вместо создания своих собственных. Это улучшает производительность при использовании обоих модов.
- Серверные конфигурации с экраном интерфейса в игре, позволяющие в реальном времени контролировать, как игроки на вашем сервере могут использовать мод. Можно настроить на основе рангов/разрешений (xaero.minimap.enforced_server_profile). Поддерживает FTB Ranks, Odyssey Roles, LuckPerms и общие API разрешений.
- Опция ограничения доступа к миникарте, привязав её к предмету, который должен находиться на панели быстрого доступа или быть экипирован. Например, добавьте minimapItemId:minecraft:compass в любое место конфигурационного файла, чтобы привязать к предмету компас. Таким образом, миникарта не будет отображаться, пока у вас нет компаса на панели быстрого доступа или экипирован.
- Эффекты зелий для контроля использования миникарты или некоторых её функций для игроков на вашем сервере/карте. На момент написания существуют следующие эффекты: xaerominimap:no_minimap, xaerominimap:no_entity_radar, xaerominimap:no_waypoints, xaerominimap:no_cave_maps. Эффекты по умолчанию относятся к нейтральному типу, но можно указать вредный тип, добавив _harmful в конец ID эффекта, например, xaerominimap:no_entity_radar_harmful.
- Переведён на множество языков.
- Опция зафиксировать север, чтобы остановить вращение миникарты и вместо этого отображать направление вашего персонажа стрелкой.
- Работает как над землёй, так и под землёй благодаря автоматическому режиму пещер. Режим пещер также должен активироваться внутри зданий. Можно выбрать размер «сплошной крыши» над вами, которую мод ищет для активации режима пещер. Размер крыши 3x3 и выше должен предотвращать активацию режима пещер при нахождении под блоками брёвен во время рубки дерева.
- Точки пути. Практически неограниченное количество. Можно телепортироваться к ним (требуется разрешение на команду телепортации в чате). Точки пути отображаются в игровом мире и на миникарте. Можно скрыть все или определённые точки пути. Нажмите B, чтобы создать новую точку пути. Нажмите U, чтобы вывести список всех точек пути. В списке точек пути можно добавлять/редактировать одну или несколько точек, сортировать их, просматривать точки пути из других подмиров/измерений и многое другое.
- Локальные и глобальные точки пути. Чтобы очистить экран от ненужных точек пути, можно создавать локальные точки пути, которые, в отличие от глобальных, зависят от опции «Макс. дистанция отрисовки точек пути». Это позволяет установить одну глобальную точку пути для большой области/региона и несколько локальных в этой области/регионе. Только глобальные точки пути будут видны, когда вы находитесь за пределами максимальной дистанции отрисовки.
- Наборы точек пути. Можно организовать точки пути, сортируя их по наборам. Текущий набор можно быстро переключить с помощью привязки клавиши. Все привязки клавиш находятся в меню управления ванильной игры.
- Обмен точками пути. Можно делиться своими точками пути в игровом чате с игроками на сервере. Это делается из списка точек пути (нажмите U).
- Точки смерти. Автоматическая точка пути в форме черепа создаётся при каждой смерти. Старые точки смерти преобразуются в обычные точки пути, что можно отключить с помощью настройки «Сохранять старые точки смерти».
- Отображает чанковые захваты и союзных игроков из мода Open Parties and Claims.
- Переключаемая сетка чанков. Сетка чанков показывает, где начинаются и заканчиваются блоки чанков.
- Переключаемый режим слизневых чанков. Чанки, где могут спауниться слизни, помечаются зелёным наложением.
- Пользовательское наложение освещённости. Можно настроить наложение освещённости, которое будет помечать блоки пользовательским цветом, если они находятся в пределах пользовательского диапазона значений освещённости, который по умолчанию составляет блоковое освещение от 0 до 7. Настройки по умолчанию предназначены для поиска блоков, на которых могут спауниться мобы. Можно использовать для любых целей.
- Определение мультимира в мультиплеере. Если установить мод миникарты на стороне сервера в дополнение к клиентской стороне, каждый мир сервера должен получить отдельный «подмир» для точек пути. В противном случае используется гораздо менее надёжное разделение миров, основанное на точке спавна мира. Если нельзя установить мод на сервер, рекомендуется отключить определение мультимира для серверов, имеющих только один «мир». Это можно сделать через экран Меню точек пути (нажмите U) -> Настройки.
- Отображает мобов на карте в виде жёлтых точек. Враждебных и дружелюбных мобов можно окрашивать по-разному. Также можно отображать в виде иконок/голов. Проверьте настройки «Радар сущностей».
- Отображает игроков на карте в виде белых точек или голов игроков. Также можно отображать в виде иконок/голов. Проверьте настройки «Радар сущностей».
- Отображает предметы на карте в виде красных точек. Проверьте настройки «Радар сущностей».
- Отображает все остальные сущности, такие как стрелы и рамки для предметов, в виде фиолетовых точек. Разные типы сущностей можно отключать в настройках. Проверьте настройки «Радар сущностей».
- Опции для отображения имён сущностей на миникарте в настройках «Радар сущностей».
- Привязки клавиш для приближения и отдаления (по умолчанию I и O) для эффективного изменения уровня масштабирования в соответствии с предпочтениями или задачей.
- Координаты под миникартой.
- Название текущего биома под миникартой. Отключено по умолчанию, необходимо включить в настройках мода (нажмите Y).
- Уровень освещённости под миникартой. Также отключено по умолчанию, необходимо включить в настройках мода (нажмите Y).
- Текущее игровое время под миникартой. Отключено по умолчанию. Можно выбрать между 12-часовым и 24-часовым форматами.
- Текущие углы камеры под миникартой. Отключено по умолчанию.
- Настройка для скрытия/отображения всех координат точек пути на всех экранах интерфейса. Может быть полезна для стримов/видео.
- Настройка для полного скрытия/отображения всех упоминаний адресов серверов в выпадающих меню. По умолчанию установлено значение «Частично», что, вероятно, достаточно в большинстве случаев.
- МНОГО ДРУГИХ НАСТРОЕК. Слишком много, чтобы перечислять их все здесь. Нажмите Y в игре, чтобы открыть настройки и посмотреть.
- 2 редакции мода: полная и fair-play. Полная версия не имеет ограничений. Версия Fair-play не отображает сущности и карты пещер, что более подходит для PvP против игроков, не использующих миникарту.
Тема на форуме | Получить версию fair-play
FAQ
Почему телепортация к точкам пути не работает у меня?
Причин может быть много. Мод отправляет команду чата для телепортации к точкам пути, которая по умолчанию имеет вид /tp @s x y z, поэтому необходимо соответствующее разрешение. Ванильная команда /tp требует статуса оператора (включённые читы), но на неванильном сервере с определёнными плагинами могут быть отдельные разрешения для команд. Используемую команду можно изменить в настройках миникарты с помощью опции «Команда телепортации по умолчанию» или для каждого сервера в меню точек пути с помощью опции «Команда телепортации в чате». Неванильные команды телепортации часто не поддерживают селекторы, такие как @s, поэтому, возможно, придётся удалить его из настроенной команды. Телепортация правой кнопкой мыши на мировой карте использует собственную настройку для команды. Об этом можно прочитать на странице описания мировой карты в разделе FAQ.
Если кнопка «Телепортация» у точки пути отключена, это также может означать несколько вещей. Наиболее частая причина — ручное использование точек пути из подмира, который не является «авто», но всё ещё из того же измерения. Если «авто» подмир — это не тот, который должен автоматически выбираться в определённом мире, выберите правильный подмир и используйте «Сделать подмир авто» в меню точек пути -> Настройки. Это поменяет местами все данные точек пути между двумя подмирами, и вы сможете телепортироваться к точкам пути, которые теперь находятся в вашем «авто» подмире.
Если «авто» подмир ВЫБРАН, но кнопка телепортации всё ещё отключена, то, вероятно, телепортация была вручную отключена для сервера/мира. Проверьте опцию телепортации в меню точек пути -> Настройки. Если она отключена, вы можете включить её только через серверный конфигурационный файл в директории игры -> xaero/minimap (XaeroWaypoints в более старых версиях). Рекомендуется выйти из Minecraft перед редактированием любых конфигурационных файлов. И делайте резервные копии время от времени.
Почему мои точки пути больше не отображаются для определённого сервера?
Не паникуйте. Почти наверняка они не удалены. Если вы используете мод мировой карты, и он также сбросился, пожалуйста, начните с его восстановления, прежде чем разбираться с точками пути. Прочитайте раздел «Ваша мировая карта "сбросилась" для определённого сервера?» на странице описания мировой карты. Сделали это? Продолжайте читать.
Начните с открытия полного меню точек пути. Нажмите U в игре, чтобы сделать это. Проверьте меню управления ванильной игры, если клавиша U не работает. Просмотрите подмиры, перечисленные в выпадающем меню в правом верхнем углу. Все подмиры точек пути для текущего адреса сервера должны быть там. Если ни в одном из них нет нужных точек пути для мира/измерения, в котором вы находитесь, то, вероятно, адрес сервера был изменён. Найдите старый адрес сервера в выпадающем меню в левом верхнем углу, выберите его и выполните Настройки -> Сделать мир/сервер авто. Теперь вы сможете найти правильный подмир в выпадающем меню в правом верхнем углу. Если правильный подмир уже помечен как (auto), что означает, что подмир автоматически выбран для вашего текущего мира/измерения, то всё должно быть в порядке. Если неправильный подмир помечен как (auto), пожалуйста, продолжайте читать.
Используете мод мировой карты?
Одна из самых частых причин автоматического выбора неправильного подмира — некорректное использование мода мировой карты в мультиплеере (начиная с версии 1.6). Убедитесь, что вы выбираете правильную карту для вашего текущего мира, прежде чем подтвердить её. Это влияет на то, какие точки пути вам показываются. Меню выбора карты находится на экране мировой карты, если нажать на иконку в левом нижнем углу (если оно не открыто по умолчанию). Рассмотрите возможность изменения режима выбора карты на один из автоматических, если он подходит для сервера, на котором вы играете.
Ваша текущая подтверждённая карта влияет на то, какой подмир точек пути в моде миникарты считается автоматическим (auto). Это позволяет каждой созданной карте иметь отдельные данные точек пути. В любой момент времени вы можете выбрать и просмотреть любой неавтоматический подмир точек пути, перейдя в меню точек пути (нажмите U) и выбрав его из выпадающего меню в правом верхнем углу. Вы можете сделать любой подмир автоматическим для вашей текущей подтверждённой карты, выбрав Настройки -> Сделать подмир авто.
Не используете мод мировой карты?
Неправильный подмир, считающийся (auto) и, следовательно, автоматически выбираемый, может быть вызван плагином сервера, изменяющим поведение ванильного предмета компаса и мешающим «мультимир» определению мода, если оно у вас включено (по умолчанию отключено). В большинстве таких случаев предмет компас указывает на вашу кровать, а не на глобальную точку спавна. Сон в нужной кровати снова должен всё вернуть, если причиной исчезновения точек пути был сон в другой кровати.
Если это произошло из-за добавления нового плагина (и если его удаление не является для вас вариантом), вот как можно восстановить точки пути:
Как добавить собственные иконки сущностей или переопределить стандартные?
Прежде всего, убедитесь, что у вас действительно включены иконки/головы сущностей в настройках миникарты -> Категории радара сущностей, будь то «Всегда» или «Список игроков». Просто убедитесь, что вы знаете, как их отображать. Речь в этом разделе именно об этих иконках.
Начиная с версии 21.6.0 мода миникарты вы можете переопределять стандартные иконки, отображаемые для сущностей, собственными спрайтами/изображениями, создав ресурспак (или включив необходимые ресурсы в свой собственный мод). Кроме того, вы также можете добавить или улучшить поддержку вариантов типов сущностей (разные варианты одного типа сущности имеют разные иконки), создав простой собственный мод или включив некоторый код в существующий мод. Хотя для более простых типов сущностей с несколькими вариантами (большинство типов сущностей) это обычно не требуется.
По умолчанию мод миникарты отображает все иконки сущностей с использованием рендереров/моделей сущностей, привязанных к сущностям. Это поддерживает всех ванильных мобов и некоторых простых двуногих/четвероногих мобов, модели которых имеют легко идентифицируемые части модели головы (голова, уши, нос и т.д.). Если моде не удаётся это сделать, вместо этого отображается цветная точка.
Соответствующая директория ресурсов для переопределения иконок — /assets/xaerominimap/entity/icon/. Вы можете найти её внутри jar-файла мода миникарты и извлечь содержащиеся файлы/папки для справки. Jar содержит пример файла для переопределения иконок типа сущности мода /assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json. Примерный файл соответствовал бы типу сущности example_mod:example_entity, если бы такой существовал. Пожалуйста, прочитайте комментарии в файле example_entity.json, чтобы узнать о его структуре, чтобы вы могли создавать собственные определения иконок, подобные ему.
Кроме того, /assets/xaerominimap/entity/icon/definition/minecraft/ содержит несколько примеров файлов для ванильных типов сущностей, которые могут требовать дополнительных комментариев относительно поддержки вариантов типов сущностей по умолчанию. По умолчанию сущности имеют очень простую поддержку вариантов, где ID варианта типа сущности — это просто местоположение ресурса основной текстуры сущности.
Если установить опцию «debugEntityVariantIds» в конфигурационном файле миникарты в true, то ID вариантов вновь обнаруженных сущностей (вариантов) будут выводиться в чат и лог/консоль.
Начиная с версии 21.8.0 мода миникарты вы также можете настраивать собственную отрисовку на основе моделей. Пожалуйста, прочитайте комментарии в примере файла /assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json для получения всей необходимой информации.
Ознакомьтесь с этим замечательным проектом от babybluetit, если хотите посмотреть на реальную реализацию пользовательских иконок или использовать её: https://www.curseforge.com/minecraft/texture-packs/xaeros-minimap-modded-support
Как запретить использование режима пещер и/или радара сущностей на моём сервере?
Для этого, пожалуйста, установите мод на стороне сервера (требуется сервер NeoForge/Forge/Fabric/Quilt на момент написания).
Если ваша версия миникарты не ниже 25.3.0, установите и используйте привязку клавиши «Настройки сервера миникарты», чтобы открыть серверные настройки. Там можно принудительно установить почти любую опцию, включая режим пещер, радар сущностей или даже создать пользовательские категории радара сущностей.
В более старых версиях мода при запуске сервера будет создан новый «общий» конфигурационный файл в директории сервера (не в папке мира), обычно в папке «config». В конфигурационном файле есть несколько опций, позволяющих отключить определённые функции мода для ваших игроков. Изменения требуют перезапуска сервера.
В качестве альтернативы, если вы не можете установить мод, вы можете включить следующие строки в системное сообщение сервера, отправляемое игрокам (при входе), которые делают следующее:
§f§a§i§r§x§a§e§r§o — заставляет клиент отключить режим пещер (включая мировую карту) и радар сущностей (режим fair-play)
§x§a§e§r§o§m§m§n§e§t§h§e§r§i§s§f§a§i§r — заставляет режим пещер миникарты работать в Нижнем мире, несмотря на режим fair-play. У мировой карты есть отдельный код для этого, который выглядит почти идентично.
§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, убедитесь, что плагин Mixin gradle применён в вашем проекте (org.spongepowered.mixin), если только вы не на версии 1.12.2.
Наконец, добавьте одно или несколько из следующих объявлений зависимостей, заменив
Forge с официальными маппингами Mojang до версии 1.21.1:
implementation "xaero.minimap:xaerominimap-forge-::dev"//намеренно без деобфускации! Forge с официальными маппингами Mojang на версии 1.21.1 или новее:
implementation "xaero.minimap:xaerominimap-forge-:" Forge с другими маппингами:
implementation fg.deobf("xaero.lib:xaerolib-forge-:+")
implementation fg.deobf("xaero.minimap:xaerominimap-forge-: