Custom Waypoints (Кастом вейпоинтс)

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

Возможности

• Текстовые метки с несколькими строками, цветами, шестнадцатеричными цветами, фоном, прозрачностью и анимациями появления и исчезновения.
• Таймеры обратного отсчёта со звуком и счётчики времени, в том числе с десятыми долями секунды.
• Метки, следующие за игроком или сущностью; после загрузки цели они снова появляются.
• Фигуры на земле или стенах: круг, звезда, стрелка, сердце, корона, значки и произвольный текст или цифры. Для них настраиваются высота стенок, контур, наклон, растяжение, затухание и градиент.
• Одновременно можно включать анимации пульсации, роста, вращения, покачивания, волны, мерцания и смены цветов.
• В текст можно вставлять предметы и текстуры из наборов ресурсов. Заполнитель {distance} выводит расстояние до метки, {entity_displayname} — имя отслеживаемой цели, а {on_view_radius:N} скрывает часть текста, пока игрок не наведётся на метку.
• Метки сохраняются отдельно для каждого мира, сервера и измерения.

Как пользоваться

Основная команда — /waypoint; если она занята встроенной командой игры, используется /customwaypoint.

• /waypoint editor открывает визуальный редактор, а клавиша M открывает его напрямую. Клавиша N показывает список активных меток текущего измерения.
• В редакторе можно менять параметры ползунками и цветовым кругом, видеть результат прямо в мире, отменять и возвращать действия сочетаниями Ctrl+Z и Ctrl+Y, сохранять через Ctrl+S.
• Манипулятор в мире позволяет перетаскивать метку, поворачивать, наклонять фигуры и менять их размер. Удерживайте Ctrl, чтобы привязывать перемещение к половине блока и поворот к 15°.
• /waypoint set <id> ... создаёт текстовую метку, /waypoint timer set <id> ... — таймер, /waypoint counter set <id> ... — счётчик, /waypoint follow <id> <игрок|UUID> ... — подпись над целью.
• /waypoint figure <id> <фигура> <x> <y> <z> ... создаёт фигуру, /waypoint animate <id> <анимация> добавляет анимацию, /waypoint gradient <id> <цвет>... задаёт градиент.
• Для переноса готовых меток используйте /waypoint copy [id] и /waypoint paste [текст]; это также помогает вставлять длинные команды, которые не помещаются в чат.
• /waypoint move <id> ... плавно перемещает метку, /waypoint remove <id|all> удаляет её, а /waypoint list выводит список.

Настройки

В командах можно выбрать отображение за блоками (behind) или поверх них (front), а также дальние варианты far_behind и far_front. Направление задаётся фиксированным углом либо значениями follow, follow_horizontal и follow_vertical, чтобы метка поворачивалась к камере.

Для текста доступны четыре стиля фона: square, square_small, rounded и rounded_small. Цвета принимают названия или формат #RRGGBB; новая строка обозначается /n, а форматирование текста поддерживает коды вида &a и &l.

Требования и совместимость

Мод работает с Fabric, Forge и NeoForge. Для серверных меток нужен отдельный плагин Custom Waypoints на Paper: он отправляет метки всем игрокам или выбранным игрокам, синхронизирует таймеры и позволяет настроить действия при входе в область метки или её удалении. Игроки без мода всё равно могут подключаться к такому серверу.

Управление серверными метками выполняется командами /waypointplugin или /wpl; право администратора — customwaypoints.admin и по умолчанию оно есть у оператора. В plugins/CustomWaypoints/config.yml можно задать радиус срабатывания, команды консоли, задержки и заполнители PlaceholderAPI для каждой метки.