Waystones

Waystones предоставляет систему именованных точек телепортации, работающую полностью на стороне сервера. Игроки могут перемещаться между мирами через интуитивно понятное меню без необходимости устанавливать дополнительные моды или ресурспаки.

Waystones — это легковесное решение для организации перемещения по миру, вдохновленное популярным модом той же тематики. Основная идея заключается в создании именованных и многоразовых точек телепортации, доступных игрокам в один клик. Плагин полностью серверный: он не требует установки клиентских компонентов или распределения ресурспаков, что делает его идеальным выбором для серверов Paper, Spigot и Purpur.

Плагин предлагает ряд функций для удобного управления перемещениями и кастомизации интерфейса:

• 🗺️ Меню с сортировкой по мирам: точки автоматически группируются по измерениям (Overworld, Nether, End).
• 🎨 Кастомизация иконок: можно выбрать блок или предмет для каждой точки и категории меню.
• ⚡ Бесплатная мгновенная телепортация с настраиваемым откатом (cooldown) для защиты от спама.
• 🐴 Телепортация спутников: при перемещении с игроком автоматически перемещаются прирученные животные, питомцы на поводке и текущее ездовое животное.
• 🛡️ Защита в бою: телепортация блокируется на заданное время после получения урона.
• 🌐 Поддержка 30 языков: включая английский, испанский, японский, корейский и другие.
• 🗺️ Интеграция с веб-картами: автоматическое добавление слоев Waystones в Dynmap, BlueMap и Squaremap.
• 🧩 Поддержка ItemsAdder и Oraxen: возможность использования кастомных предметов в качестве иконок.
• 💾 Надежное хранение данных в формате YAML.
• 🔄 Регулярная проверка обновлений с визуальным уведомлением в меню.

Процесс создания и использования точек максимально упрощен для администраторов и игроков:

1. Администратор переходит в нужное место и вводит команду /waystone create <name> для мгновенного создания точки.
2. Игрок открывает меню командой /waystone.
3. Игрок выбирает мир из списка доступных категорий.
4. При нажатии на конкретную точку происходит мгновенная телепортация.

Для визуализации точек можно использовать стандартные материалы Bukkit API или кастомные предметы из дополнений:

/waystone create Village Spawn @DIAMOND_BLOCK
/waystone seticon Village Spawn @NETHER_BRICK
/waystone seticon Village Spawn @reset

Если установлены ItemsAdder или Oraxen, можно использовать кастомные идентификаторы:

/waystone seticon Village Spawn itemsadder:mynamespace:custom_totem
/waystone setcategoryicon nether oraxen:custom_portal_icon

Добавлять описание к точке или категории можно с помощью специальных команд. Символ | разделяет строки, а коды & отвечают за цвета:

/waystone setdescription Village Spawn &7The starting point &e|&7Watch out for zombies at night
/waystone setcategorydescription nether &cDangerous zone

Файл config.yml позволяет настраивать основные параметры работы плагина:

• language: Выбор языка (30 вариантов). Можно менять также через /waystone setlang.
• teleport-cooldown-seconds: Задержка между телепортациями для предотвращения спама.
• effects-enabled: Включение или отключение звуковых и визуальных эффектов.
• update-checker-enabled: Включение/отключение проверки обновлений.
• update-check-interval-hours: Интервал проверки обновлений (по умолчанию 12 часов).

Тексты, обращенные к игрокам, жестко вшиты в плагин на 4 основных языках для обеспечения стабильной работы. Имена категорий можно менять через команды.

Плагин поддерживает привязку категорий к измерениям, созданным сторонними плагинами (DimensionControl, Multiverse-Core и др.).

/waystone createcategory royaume myrealm_world
/waystone create Entrance to the Realm #royaume

Категория появится в меню только после создания в ней первой точки. Кастомные категории имеют едва заметное свечение (можно отключить через /waystone setglint). Если связанный мир исчезнет, данные сохранятся, а категория станет серой и доступной только администраторам.

При наличии установленных Dynmap, BlueMap или Squaremap, плагин автоматически создает слой "Waystones". Каждая точка отображается маркером с цветом, соответствующим её миру (зеленый — Overworld, красный — Nether, фиолетовый — End).

Чтобы скрыть конкретную точку (например, секретную базу) с карты, используйте команду /waystone setmapvisible <name> disabled.

При телепортации с игроком автоматически перемещаются:

• Текущее ездовое животное (лошадь, мул, страйдер и др.) — оно перемещается первым, после чего игрок снова оказывается на нем.
• Прирученные животные и питомцы на поводке в радиусе pet-teleport-radius (по умолчанию 6 блоков).

Чтобы игроки не могли использовать телепортацию для побега из боя, плагин блокирует перемещение в течение combat-protection-seconds (по умолчанию 10 секунд) после получения урона. Администраторы не подвержены этому ограничению.

Плагин использует bStats и FastStats для сбора анонимной статистики использования и отслеживания ошибок. Личные данные не собираются. Функции можно отключить в конфигах соответствующих плагинов (plugins/bStats/config.yml или plugins/faststats/config.properties).