Map Tools

Map Tools - это плагин для Майнкрафт, который помогает создавать разнообразные элементы для приключенческих карт (adventure maps). Все функции разделены на модули, которые можно включать и отключать в любой момент. Всё, что создано с помощью Map Tools, работает на 100% ванильно - никаких дополнительных плагинов не нужно. Плагин экономит часы работы, если вы:

• работаете с display-сущностями (блоки) для деталей и анимаций;
• создаёте плавные пути камеры, переходы или анимации сущностей (датапак);
• настраиваете маршруты для NPC или мобов (датапак);
• хотите стильные анимированные сообщения или титулы (датапак и ресурспак для табличек);
• быстро загружаете и меняете ресурспаки;
• и многое другое!

Если вы картостроитель, то этот плагин - настоящая находка. Он автоматизирует кучу рутины и позволяет сосредоточиться на творчестве.

Описание модулей

Каждый модуль можно включить или отключить командой /maptools module <module> enable/disable. Если модуль отключён, все его команды и взаимодействия исчезают, но уже созданные объекты продолжают работать.

Smooth Animations

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

Важно: после печати анимацию можно использовать без плагина через датапак.

Гайд:

• /animation new - начать новую анимацию.
• /animation add - добавить контрольную точку (ваше текущее положение). Нужно минимум 3 точки для интерполяции.
• /animation remove-last - удалить последнюю точку.
• /animation render <loop> <ticks> <target> - отрендерить анимацию (loop: true соединит первую и последнюю точку, ticks - время между точками в тиках, target - селектор).
• /animation print <target> <name> - вывести в датапак (name - имя функции, для вложенных путей используйте кавычки, например "camera/island/front").

Block Update Toggler

Надоело, что ступеньки сами соединяются, а песок падает? Отключите обновления блоков при установке или разрушении. Не забудьте потом включить обратно! (Удаление плагина также восстановит обновления.)

Гайд: /block-update toggle - переключить обновления.

Command Tool Binding

Не хотите вводить одну команду много раз? Привяжите любую команду к предмету и кликните им по блоку - команда выполнится на месте клика. Если не целиться в блок, команда выполнится на вашей позиции. Привязанные предметы сохраняются после перезапуска.

Гайд:

• /commandtool command <команда> - привязать команду к предмету в руке.
• /commandtool clear - очистить.

Block To Display

Превращайте блоки в их не-solid состояние - Block Displays. С ними можно легко анимировать любые структуры: масштабировать, вращать, деформировать и перемещать. В отличие от падающих блоков, block displays гораздо легче для клиента и сервера - можно использовать до ~1000 дисплеев в одной зоне без сильного падения производительности.

Гайд:

• /blockify <position> <tag> <scale> [origin] - преобразовать один блок (tag - тег для сущности, scale - масштаб, origin - исходная точка для вращения многоблочных структур).
• /blockify-tool <scale> <tag> [origin] - получить инструмент для кликов по блокам.

Hitbox Anything

Хотите кастомные взаимодействия с определёнными блоками или сущностями? Или наоборот - запретить любое взаимодействие? Оберните объект в hitbox (interaction), который автоматически подстраивается под размер цели. Теперь можно отслеживать левый или правый клик (или оба) по этому хитбоксу.

Гайд:

• /interaction spawn <target> [tag] [space] - создать хитбокс (target - блок или селектор, space - дополнительный размер относительно исходного).
• /interaction tool <tag> - получить инструмент для кликов.

Leash Fences

Наконец-то можно соединять заборы поводками! Просто возьмите поводок в руку и кликните по забору, затем кликните по другому забору без поводка. Или используйте /leash <from> <to>.

Block Marker

Легко выполнять действия на сущностях, а что насчёт блоков? Пометьте их с помощью marker-сущностей (маркеры не отправляются клиенту - нет нагрузки на производительность). Используйте заданный тег для любых действий.

Гайд:

• /marker-tool <tag> - получить инструмент.
• ПКМ по блоку - добавить маркер, ЛКМ - удалить.
• /marker-finder <range> - подсветить все маркеры вокруг зелёными частицами.

Multi Tool (как WorldEdit для сущностей)

Позволяет легко редактировать любые сущности в мире, но в основном предназначен для display-сущностей. Выберите тип цели и несколько целей, затем перемещайте/вращайте их взглядом или удаляйте. Также можно выполнять команды для каждой выбранной сущности. Block displays подсвечиваются жёлтым оверлеем для лучшей видимости.

Гайд:

• /multitool get <entity> <radius> <vector> - получить инструмент.
• /multitool mode move/rotate - переключить режим.
• /multitool rotate-by/move-by <vector> - прямое перемещение/вращение.
• /multitool range - изменить дальность луча.

Fancy Name Tags

Видели красивые таблички с именами или рангами на серверах? Теперь можно легко создавать такие же! Введите текст (поддерживаются A-B, 0-9, .:,;-_?!#) и цвета в hex (с прозрачностью). Сгенерируется изображение, привязанное к уникальному символу, который нужно скопировать после создания. Не забудьте сохранить!

Гайд: /nametag <text> <main> <shadow> <char-shadow> [char] - текст, основной цвет, тень, тень символа (hex с прозрачностью, например #ffffff7f). После генерации перезагрузите ресурспак с сервера.

Animated Messages

Говорящие NPC? Сюжетные диалоги? Просто выводить стену текста скучно. Анимируйте сообщения с динамической скоростью и паузами, чтобы игрок успевал читать. Можно задать префикс (виден всегда) и анимируемый текст (поддерживает MiniMessage). Для целых диалогов создайте JSON-файл со списком префикс+сообщение. Все сообщения печатаются в датапак и работают без плагина.

Гайд:

• /message new <prefix> <message> <target> <name> - создать одно сообщение (символы ① ⑤ ⑳ для пауз, скопировать из /message symbols).
• /message conversation <path> - загрузить JSON-диалог.

Пример JSON:

{
    "target": "@a",
    "content": [
        {
            "prefix": "<red>Miraculixx</red>: ",
            "text": "Hey,⑤ what's up?"
        },
        {
            "prefix": "<yellow><b>You</b></yellow>: ",
            "text": "Nothing really,⑤ just reading those docs..."
        }
    ]
}

Custom Entity Pathing & Scripting

Самый мощный инструмент для кастомных анимаций и поиска пути. Можно добавлять команды (выполняются с задержкой в 1 тик), задержки, повторения и перемещения сущностей с анимацией ходьбы.

Гайд:

• /pathing new <target> - начать скрипт.
• /pathing add-position <position> <speed> - добавить перемещение.
• /pathing add-command <command> - добавить команду.
• /pathing add-delay <delay> - задержка в тиках.
• /pathing remove-last - удалить последнее действие.
• /pathing play - проиграть.
• /pathing print <name> - вывести в датапак.
• /pathing reprint <name> - перепечатать после изменения JSON.

Пример JSON для скрипта:

{
    "target": "@e[tag=test]",
    "actions": [
        {
            "type": "REPEAT",
            "time": 100.0,
            "script": "particle minecraft:cloud ~ ~-0.2 ~ 0 0 0 0.04 3"
        },
        {
            "type": "CONTROL_POINT",
            "location": "{\"world\":\"world\",\"x\":4.5,\"y\":139.5,\"z\":-8.1,\"yaw\":10.0,\"pitch\":35.5}",
            "time": 0.1
        },
        {
            "type": "DELAY",
            "time": 20.0
        },
        {
            "type": "RUN_SCRIPT",
            "script": "say test finished"
        }
    ]
}

Tag Tool

Добавлять, удалять или просто получать все теги сущностей - ключевое действие при создании карт. Зачем вводить команды каждый раз? Возьмите инструмент и кликайте по сущностям.

Гайд: /tag-tool <tags> [entity-type] [radius] - теги через пробел в кавычках, опционально фильтр по типу и радиус.

Auto Resource Pack

Создание ресурспаков для сервера или мира может быть муторным, особенно при совместной работе. Map Tools упрощает процесс: достаточно иметь все ассеты на сервере. Редактируйте их в любой папке, а затем запросите через команду. MWeb соберёт и отправит вам все файлы из папки ресурспака. Можно настроить несколько групп (например, для разных версий) и автозагрузку при входе.

Гайд:

• Требуется MWeb.
• Основная папка и группы настраиваются в settings.yml.
• Папки, начинающиеся с ., игнорируются.
• Папки с именем группы загружаются только при запросе этой группы.
• /resourcepack <group> - ручной запрос.
• /tag @s add <group> - автозапрос при входе.

Пример структуры папок:

Server Folder
|- texturepack
   |- .test-icons   //игнорируется
   |- blocks   //всегда загружается
   |- guis   //только при запросе guis
   |- optifine-entities //только при запросе optifine-entities

Каждая папка должна иметь классическую структуру ресурспака (pack.mcmeta только один раз в корне).

Position Saver

Построили что-то и не хотите искать это снова? Сохраните позицию с именем и телепортируйтесь в любой момент. Работает с ключевыми словами location, loc, position, pos.

Гайд:

• /pos new <name> - сохранить.
• /pos tp <name> - телепорт.
• /pos delete <name> или /pos reset - удалить одну или все.

Command Checker - защита от опасных команд

Создание сложных сущностей и дисплеев занимает много времени, но удалить их можно одной командой... Map Tools сканирует все введённые команды и проверяет, сколько сущностей будет затронуто (ищет селекторы типа @e[...]). Если затронуто больше заданного количества (по умолчанию 10), команда не выполнится, и вы получите предупреждение. Всё ещё хотите выполнить? Подтвердите кликом по слову "here" в чате или выполните команду дважды подряд. /kill @e блокируется полностью.

Важно: Map Tools проверяет только ванильные команды. Некоторые плагины используют свои системы, которые могут не распознаваться.

Text Styler - MiniMessage

Используйте форматирование MiniMessage везде! Пока что работает в наковальнях и табличках. Если есть идеи, где ещё пригодится - дайте знать.

Гайд: MiniMessage - это простой формат для текста с цветами, переводами, градиентами, счетами и т.д.

Базовые возможности

Некоторые функции нельзя отключить. Самая полезная - команда /reload-dp, которая перезагружает только датапаки, а не весь сервер. На версии 1.20.2 это происходит очень быстро.

Экспериментальные и будущие модули

Structure Resizer (анимированный)

Хотите уменьшить здание до мини-структуры? Или почувствовать себя маленьким в огромной комнате? Можно легко изменить размер комнаты с плавной анимацией.

Важно: все затронутые блоки превращаются в display-сущности! Не делайте комнату слишком большой.

Гайд: /scaling <from> <to> <origin> <name> <time> <scale> <tag> - from/to - углы области, origin - центр масштабирования, time - время анимации в тиках, scale - итоговый масштаб (используйте чётные числа или 0.5, 0.25...).

Simple Quest Book

Специфичный модуль для личного использования. Позволяет создавать динамические книги заданий с локализацией (требуется ресурспак). Также есть система подсказок, полезная для головоломок. В будущем возможно больше функций.

Права доступа

Каждый инструмент и команда требуют OP или определённого разрешения.

Частые вопросы:

Команда не существует или красная? Вероятно, модуль, добавляющий эту команду, отключён. Включите его через /maptools module <module> enable.

Не могу включить модуль? Некоторые модули требуют поддержки (платная версия).

Как отредактировать заголовок сгенерированных функций? Для редактирования заголовков нужна поддержка.

Скачайте плагин Map Tools и упростите создание своих карт в Майнкрафт!