BlueMap Sign Markers

Обзор

Этот Fabric-плагин для BlueMap позволяет создавать маркеры на карте на основе табличек в игре Minecraft. Мод автоматически отображает специальные метки в BlueMap, используя информацию с табличек, размещенных в игровом мире.

Установка

Для установки поместите файл мода в папку mods вместе с основным модом BlueMap. Важно отметить, что этот плагин работает только на стороне сервера.

Использование

Чтобы создать маркер на карте, разместите табличку или подвесную табличку с определенным текстом. На первой или второй стороне таблички напишите:

[poi]
<краткое описание>

После этого на карте BlueMap появится маркер в месте расположения таблички с текстом <краткое описание>. Если табличка будет уничтожена, соответствующий маркер автоматически удалится с карты.

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

Настройка

Мод создает файл конфигурации BMSM-Core.json в папке config/bluemapsignmarkers. В этом файле доступны следующие опции:

• markerGroups - список групп маркеров (подробнее описано ниже); по умолчанию содержит одну группу для префикса [poi].

Группы маркеров

Группа маркеров - это набор меток, которые можно включать и отключать в интерфейсе BlueMap. Каждая группа маркеров настраивается следующими параметрами:

• prefix - префикс, который должна содержать табличка для включения в группу маркеров (обязательный параметр);
• matchType - тип совпадения при проверке первой непустой строки текста на табличке; необязательный параметр; по умолчанию STARTS_WITH (точное совпадение с учетом регистра);
  • STARTS_WITH - строка должна начинаться с префикса;
  • REGEX - строка должна соответствовать регулярному выражению (используется механизм регулярных выражений Java);
• name - название группы маркеров (обязательный параметр);
• type - тип отображаемого маркера; необязательный параметр; по умолчанию POI;
• icon - путь к иконке или URL для отображения маркера; необязательный параметр; по умолчанию null (используется стандартная иконка POI BlueMap);
• offsetX - смещение маркера по оси X; необязательный параметр; по умолчанию 0 (соответствует anchor.x в базовой конфигурации BlueMap);
• offsetY - смещение маркера по оси Y; необязательный параметр; по умолчанию 0 (соответствует anchor.y в базовой конфигурации BlueMap).

Пример конфигурации

{
  "markerGroups": [
    {
      "prefix": "[poi]",
      "name": "Points of Interest"
    },
    {
      "prefix": "[store]",
      "name": "Stores",
      "icon": "assets/store.png"
    },
    {
      "prefix": "\[[vV][iI][lL][lL][aA][gG][eE]\]",
      "matchType": "REGEX",
      "name": "Villages"
    }
  ]
}

В этом примере создаются три группы маркеров: для табличек с префиксом [poi], для табличек с префиксом [store] и для табличек, где префикс соответствует регулярному выражению для деревень (например, [Village] или [VILLAGE]).

Группы маркеров [poi] и Villages используют стандартную иконку POI, а группа [store] использует пользовательскую иконку из файла assets/store.png.

Таблички с префиксом [poi] будут отображаться в группе "Points of Interest", таблички с префиксом [store] - в группе "Stores", а таблички, соответствующие регулярному выражению для деревень, - в группе 'Villages'.