Плагин LeafRTP | Random Teleport 3.2.1 +3.1.2

LeafRTP | Random Teleport — серверный плагин для перемещения игроков в случайные безопасные точки Minecraft. Координаты подбираются и проверяются заранее, а часть операций выносится за пределы основного серверного потока. Подход направлен на уменьшение задержек при выборе и проверке чанков, но не гарантирует одинаковую производительность на любой конфигурации.

Проект распространяется по лицензии MIT. Серверная сторона обязательна, клиентская установка не поддерживается. Категории: управление, оптимизация, транспорт, игровые механики, библиотеки и утилиты. Доступен публичный API для дополнений.

Назначение и принцип работы​

Плагин предназначен для серверов, где игрокам нужно дать случайный выход в мир без ручного выбора координат. Запрос обрабатывается по общей схеме:

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

Правила зависят от настроек версии. Проект хранит сведения о проблемных секторах и использует заранее подготовленные назначения.

Скриншоты и внешний вид​

Распределение координат​

В официальном описании указано распределение точек по пространственной кривой, связанной с архимедовой спиралью. Такой подход должен уменьшать скопление назначений около центра и равномернее использовать доступную площадь региона.

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

Предварительная проверка и нагрузка​

LeafRTP отделяет проверку назначения от основного цикла тиков. По описанию проекта, предварительный фильтр читает данные регионов Anvil и отклоняет неподходящие биомы или блоки до полной загрузки чанка. Оставшиеся загрузки выполняются асинхронно там, где это допускает платформа.

Проверенные координаты могут храниться в очереди, поэтому запрос обычно получает уже подготовленное место. Фактическая нагрузка всё равно зависит от числа игроков, диска, генерации мира, сторонних плагинов и ядра. Динамические испытания предоставленных JAR не проводились.

Безопасность и приваты​

Проект заявляет фильтрацию небезопасных блоков, отказ от принудительного удержания чанков и учёт защищённых территорий. В официальном тексте названы GriefDefender, GriefPrevention, WorldGuard, Towny и Lands, а также другие встроенные интеграции.

Перед внедрением следует проверить:

• доступные для RTP миры;
• границы и размеры регионов;
• воду, опасные поверхности и закрытые зоны;
• совместимость с системой приватов;
• взаимодействие с другими телепортами;
• обработку отмены и невозможного перемещения.

В выбранных метаданных обязательные project dependencies не указаны, поэтому перечисленные интеграции не следует считать обязательными.

Управление и функции​

LeafRTP описан как решение с готовым базовым поведением после установки. При первом запуске заявлено создание стандартного региона, а управление мирами, регионами, безопасностью и эффектами доступно через внутриигровое меню без обязательной ручной правки YAML.

Подтверждённые возможности:

• индивидуальные задержки и лимиты;
• частицы, звуки, фейерверки и эффекты зелий;
• ограничение при PvP или активной боевой метке;
• отдельные правила для разных миров;
• данные для совместимых карт;
• интеграция с PlaceholderAPI;
• необязательная плата через Vault;
• возврат платы при отмене в предусмотренных случаях.

Точные поля и значения следует сверять с конкретным выпуском. Неподтверждённые параметры здесь не приводятся.

API и расширяемость​

Публичный rtp-api предназначен для разработчиков дополнений. Сторонний компонент может обращаться к функциям LeafRTP и использовать общую механику на нескольких поддерживаемых платформах. Категория library отражает эту возможность, но не делает плагин обязательным для других ресурсов.

Зависимость возникает только у дополнения, которое использует API. Его версию необходимо сопоставлять с выпуском LeafRTP и проверять на выбранном ядре.

Совместимость​

Подтверждены Minecraft 1.20.1–1.20.6, 1.21–1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2. В метаданных перечислены Bukkit, Fabric, Folia, NeoForge, Paper, Purpur, Spigot и Velocity. Официальное описание отдельно называет Paper, Spigot, Folia, Fabric, NeoForge и Velocity.

Широкий список не означает совместимость произвольного JAR с любой средой. Следует выбирать выпуск для своей версии Minecraft и платформы. Для legacy Forge нативная поддержка не заявлена; упомянут запуск через Arclight или Mohist, но отдельные гарантии отсутствуют.

Установка и первичная проверка​

В фактической основе установка сформулирована как размещение JAR в папке plugins совместимого сервера. Практический порядок:

• Остановить сервер.
• Сделать резервную копию плагинов и их данных.
• Выбрать совместимый выпуск LeafRTP.
• Поместить JAR в plugins.
• Запустить сервер и проверить журнал.
• Убедиться, что компонент загрузился без ошибок.
• Испытать телепортацию в тестовой среде.
• Проверить приваты, границы мира и опасную местность.

Для Fabric, NeoForge и Velocity отдельные пути в предоставленной инструкции не описаны, поэтому автоматически переносить на них схему с папкой plugins нельзя.

Файлы и контроль целостности​

Опубликованы два файла:

• LeafRTP-3.2.1.jar, версия 3.2.1, 4 654 308 байт. SHA-1: 86a1225c1d6f6b8a995f047e94fcf24be0779add. SHA-512: a25b7197614bb1fbfa4785ebcf922776d5ed5eab99eebb06ec8b2bc5041b717bd3749d687f987dce8caba7edc57194fdf2e76009278d4a905331b8398a868815.
• LeafRTP-3.1.2.jar, версия 3.1.2, 3 848 363 байта. SHA-1: ff7efc631f2112d83025558c117d14f8031959ef. SHA-512: a4259eecf4c0bfbab86bfc0e0406cbd968cf2eeaf373faf6575f2f0f65d25d6996ddbbb326956b4328104814aed6b9466b06db1aebb542078262639b829cdb2d.

Файлы получены по официальному HTTPS и локально сверены по опубликованным хешам. Архивы прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому поведение на сервере не подтверждено.

Практический чек-лист​

До открытия функции для всех игроков разумно провести ограниченную проверку:

• сопоставить ядро, Minecraft и версию JAR;
• проверить чистую установку и обновление отдельно;
• испытать разные миры и типы местности;
• проверить запрет попадания в приваты;
• выполнить несколько одновременных запросов;
• наблюдать за временем тиков;
• проверить задержки, лимиты и отмену;
• сохранить возможность быстрого отката.

FAQ​

Нужна ли установка игрокам?​

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

Есть ли обязательные зависимости?​

В выбранных метаданных обязательные project dependencies не перечислены. Vault, PlaceholderAPI и системы приватов описаны как интеграции.

Работает ли LeafRTP без настройки?​

Проект заявляет базовый регион после первого запуска и возможность начать работу без обязательного редактирования YAML. Перед публичным использованием всё равно нужно проверить безопасность мира.

Гарантирует ли плагин отсутствие лагов?​

Нет. Предварительная обработка и асинхронные операции направлены на снижение нагрузки основного потока, но результат зависит от сервера и окружения.

Как выбрать между версиями 3.2.1 и 3.1.2?​

Нужно учитывать версию Minecraft, ядро и интеграции. Более высокий номер выпуска сам по себе не подтверждает совместимость с любой сборкой.