Waypoints - серверные путевые точки без читерного телепорта

У каждого игрока на выживании рано или поздно случается одна и та же история: ушёл далеко от базы за ресурсами, заблудился, и теперь либо ищи дом часами, либо проси админа телепортнуть. Ставить обычный плагин на варпы - значит убить весь смысл выживания, ведь телепорт домой по команде это читерство в чистом виде. Плагин Waypoints решает эту дилемму элегантно: он не телепортирует игрока, а просто показывает направление, куда идти. Исследование мира остаётся, а мучения с поиском базы исчезают.

Это полностью серверный плагин для Paper, Spigot и Folia, то есть игрокам ничего скачивать не нужно - всё работает на стороне сервера. Поддерживаются версии Minecraft от 1.17.1 до актуальной 1.21.x, включая 1.18.2, 1.19.3-1.19.4 и ветку 1.20. Минимальное требование - Java 21, так что перед установкой убедитесь, что ваш хостинг её поддерживает. Проект живой и активно обновляется: свежие релизы выходят регулярно, в последних версиях пофиксили баги на Folia при переключении между мирами и убрали обязательную зависимость CommandAPI.

Как игрок видит направление к точке

Главная фишка Waypoints - это система индикаторов направления. Их можно настраивать по отдельности и комбинировать как угодно.

Компас в боссбаре

В верхней части экрана появляется полоса-компас с меткой, которая показывает, в какой стороне находится выбранная точка. Выглядит аккуратно и не мешает игре.

Луч маяка

Когда точка попадает в дальность прорисовки, на её месте появляется луч как от настоящего маяка. Издалека видно, куда бежать.

Голограмма

Плавающий текст над точкой, как в модах. Удобно, когда нужно понять, что это за точка, не подходя вплотную.

Мигающий блок

Когда игрок подходит близко, луч маяка сменяется последовательностью блоков, которая повторяется. Это помогает найти точное место, а не просто примерную область.

Обычный компас

Если у игрока в инвентаре есть компас, он просто начинает указывать на выбранную точку. Максимально ванильно и лорно.

Индикатор в экшенбаре

Похоже на компас, но не требует предмета. В строке над инвентарём показывается примерное направление: если точка слева, загораются секции слева, и наоборот.

Частицы

У ног игрока появляются частицы, указывающие направление к точке. Тонко, не навязчиво, работает всегда.

Трекинг игроков

По умолчанию выключено, но если включить - в меню появится возможность выбрать другого игрока и отслеживать его. Компас, экшенбар и частицы начнут вести к нему. При этом приватность учтена:

• Игрок может скрыть себя от отслеживания в меню (если админ разрешил)
• Чтобы трекать других, нужно самому быть видимым (опционально)
• Тот, кого отслеживают, получает уведомление, кто за ним следит (тоже настраивается)

Для SMP-серверов это золото: нашёл другана в огромном мире без всяких координат в чате.

Языки

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

Другие возможности

• Открытие GUI по шифту + ПКМ с компасом в руке (по умолчанию)
• Свои иконки для точек и папок: кликните по иконке, и предмет в руке станет новой иконкой
• Лимиты на количество точек и папок у игрока
• Платные телепорты с нарастающей ценой (поддержка Vault) - если всё же хотите разрешить телепорт, но за деньги
• Полная кастомизация индикаторов направления и предметов в GUI
• Хранение данных в SQLite - никаких внешних баз не нужно

Интеграции с картами

Публичные точки автоматически отображаются на популярных веб-картах:

• Dynmap
• SquareMap
• BlueMap
• Pl3xMap

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

Команды

/waypoints - открыть GUI

/waypoints select <Имя> - выбрать дополнительную точку

/waypoints deselectAll - снять выбор со всех точек

/waypoints teleport <Имя> - телепорт к точке (если разрешено)

/waypoints set <Имя> - создать приватную точку, видимую только вам

/waypoints setPublic <Имя> - создать публичную точку для всех

/waypoints setPermission <Право> <Имя> - точка только для игроков с указанным правом

/waypoints setTemporary <X> <Y> <Z> - временная точка, видимая пока игрок онлайн

/waypoints other <Имя> - посмотреть точки другого игрока

/waypoints statistics - статистика базы данных

/waypoints reload - перезагрузка конфига (команда /reload не поддерживается и не нужна)

Скриптовые команды

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

/waypointsscript deselectWaypoint <Игрок> - снять выбор точек у игрока

/waypointsscript selectWaypoint <Игрок> <UUID> - выбрать точку за игрока

/waypointsscript temporaryWaypoint <Игрок> <X> <Y> <Z> [Цвет-маяка] - создать временную точку

/waypointsscript uuid <Запрос> - найти UUID точки по имени

Права

waypoints.command.use* - доступ к /waypoints и GUI

waypoints.command.other - доступ к /waypoints other

waypoints.command.statistics - доступ к статистике

waypoints.command.reload - перезагрузка конфига

waypoints.command.scripting - скриптовые команды и UUID

waypoints.modify.private* - создание и редактирование приватных точек

waypoints.modify.public - публичные точки

waypoints.modify.permission - точки по правам, всегда видимые

waypoints.modify.anywhere - точки в любых мирах, игнорируя запреты

waypoints.modify.other - изменение чужих точек

waypoints.unlimited - обход лимитов на точки и папки

waypoints.temporaryWaypoint* - временные точки для себя

waypoints.temporaryWaypoint.other* - временные точки для других

waypoints.teleport.private - телепорт к приватным точкам

waypoints.teleport.public - телепорт к публичным

waypoints.teleport.permission - телепорт к точкам по правам

waypoints.tracking.enabled* - использование трекинга игроков

waypoints.tracking.trackAll - трекинг даже скрытых игроков

waypoints.updateNotification - уведомление о новой версии после рестарта

*: эти права выданы всем игрокам по умолчанию

Настройка

Практически всё конфигурируется. Каждую строку текста можно перевести или перекрасить под стиль вашего сервера. В свежих версиях добавили настройку кулдаунов между разными типами точек и авто-снятие выбора с death-waypoint после смерти.

Важно знать

Плагин собирает базовую статистику через bStats - количество серверов, версии и тому подобное. Отключить можно в конфиге bStats, если не хотите.

Для запуска нужна Java 21 или новее. Если ваш сервер до сих пор на старой джаве - сначала обновитесь.

Кому ставить

Если у вас SMP-сервер, анархия без правил или просто выживание с друзьями, где телепорты под запретом - Waypoints закроет вечную проблему "где мой дом" без читерства. Игроки сами ставят точки, сами выбирают куда идти, а админу не нужно никого телепортировать. Для сетевой игры с друзьями это must-have. Плагин отлично работает на хостинге вроде BungeeHost - ставится в один клик, и ваш сервер Майнкрафт сразу получает удобную навигацию без лишней возни.

Скачать Waypoints стоит хотя бы ради того, чтобы перестать слышать в чате "админ, тп меня домой, я заблудился".