TPA DonutSMP

Плагин предоставляет систему телепортации по запросу с защитой от попадания в опасные зоны, поддержкой GUI и интеграцией PlaceholderAPI.

TPA DonutSMP представляет собой детально настраиваемую реплику системы телепортации с сервера DonutSMP, оптимизированную для платформ Paper. Проект включает в себя логику Safe-Teleport, современное всплывающее окно в формате GUI для обработки запросов и поддержку расширенных текстовых компонентов.

Система обеспечивает комплексное управление телепортацией с защитой игроков от нежелательных условий при перемещении:

• Safe-Teleport: проверка точки назначения на наличие лавы, огня, удушья или пустоты. Если место небезопасно, плагин ищет ближайшую безопасную локацию в заданном радиусе.
• GUI-запросы: возможность включения трехстрочного всплывающего окна с головой игрока и цветовыми индикаторами (зеленая/красная шерсть) для принятия или отказа.
• MiniMessage и PlaceholderAPI: полная поддержка градиентов, HEX-цветов и динамических переменных в сообщениях.
• Настройки отмены: параметры cancel-on-move и cancel-on-damage позволяют прервать процесс телепортации при движении или получении урона во время прогрева.
• Система прогрева и кулдауна: поддержка времени подготовки перед перемещением и задержки между последовательными запросами.

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

• tpa.bypass.warmup — игнорирование времени прогрева (по умолчанию: op)
• tpa.bypass.cooldown — игнорирование задержки между телепортами (по умолчанию: op)

Настройки плагина доступны в файле config.yml и включают следующие параметры:

• settings.warmup — время прогрева в секундах
• settings.cooldown — интервал между запросами в секундах
• settings.request-expire — время жизни запроса (по умолчанию 60 секунд)
• settings.safe-teleport-enabled — включение/выключение проверки безопасности
• settings.safe-search-radius / settings.safe-search-vertical — радиус и вертикальная область поиска безопасного места
• gui.enabled — активация всплывающего окна GUI

Состояние переключателя входящих запросов хранится в оперативной памяти и сбрасывается при перезагрузке сервера.

Для корректной работы плагина требуется среда Java 17+. Владельцам серверов необходимо вручную отредактировать идентификатор bStats в основном классе TPADonutSMPPlugin для корректного сбора метрик.

Для крупных серверов рекомендуется уменьшать значения радиуса и вертикальной области поиска в параметрах Safe-Teleport для оптимизации производительности.