На любом сервере Minecraft рано или поздно встает вопрос: как дать игрокам возможность случайной телепортации? Стандартные решения либо лагают, грузя чанки на главном потоке, либо требуют сложной настройки. LeafRTP решает эту проблему раз и навсегда - быстрый, предсказуемый и безопасный /rtp, который не роняет TPS.

LeafRTP - Случайный телепорт для Paper, Spigot, Folia, Fabric, NeoForge и Velocity

Когда-то я хотел исследовать мир Minecraft. На серверах просил /rtp, а мне отвечали "нет, это лагает". Я воспринял это лично.

Случайный телепорт, который легко настроить и который работает быстро. Просто киньте jar в папку - и /rtp уже работает без конфигов. А если нужно что-то подкрутить - есть /rtp menu прямо в игре. Для продвинутых - публичное rtp-api.

Коротко о главном

• Взял и работает: бросил jar, набрал /rtp, готово. Никакого YAML, если не нужно.
• Настройка в игре: регионы, безопасность, эффекты - всё через /rtp menu.
• Один jar для всех платформ: Bukkit, Paper, Folia, Fabric, NeoForge, Velocity. rtp-api и rtp-core независимы от платформы, так что аддоны цепляются без проблем.
• Без ожидания "Поиск безопасного места..." - места проверяются не на главном потоке и не в момент запроса.
• Производительность: p99 тика - 4 мс (у ближайшего конкурента - 70 мс). Все тесты сохранены в репозитории. На Folia LeafRTP особенно хорош - избегает watchdog stall'ов благодаря предварительной фильтрации.
• Безопасность проверена: никаких блоков в лаве, принудительной загрузки чанков, телепорта на чужие территории или тихих ошибок.

Поддерживает Minecraft 1.20.x / 1.21.x / 26.x. Нативный Forge не поддерживается - используйте Arclight или Mohist.

На рынке с 2021: 4.6 звезды, 30+ отзывов, 430 000+ загрузок.

---

Почему администраторы выбирают LeafRTP

Всё перечисленное ниже идёт в бесплатной сборке, без платных аддонов:

• 12 встроенных проверок на приваты (GriefDefender, GriefPrevention, WorldGuard, Towny, Lands и ещё 7). Никаких телепортов на защищённую землю.
• Vault-экономика: опциональная плата за телепорт, разные цены для разных регионов, автовозврат при отмене.
• Движок эффектов: частицы, звуки, фейерверки, зелья на каждом этапе телепортации.
• Кулдауны и лимиты использования для каждого игрока.
• PvP/combat-tag защита, PlaceholderAPI, живые теплокарты, мультимировые настройки.
• Расширяйте без форка: rtp-api позволяет переопределить почти всё - от проверки места до экономики и кастомных платформ приземления. Встроенный аддон LeafRTPGuiAddon как раз так и делает: заменяет голый /rtp на меню выбора.

Нажмите /rtp menu - игроки выбирают мир или регион кликами, не запоминая команд.

---

Установка за 30 секунд

1. Киньте LeafRTP-x.y.z.jar в plugins/.
2. Запустите сервер. Регион default создастся автоматически.
3. Наберите /rtp.
4. Команда /rtp menu откроет меню регионов, миров и настроек (книга на Paper/Folia, чат-список на остальных).

Позже можно подправить plugins/RTP/config.yml и plugins/RTP/regions/*.yml. Полный гайд: админ-гайд.

Встроенные аддоны распаковываются сами при первом запуске. Четыре аддона сидят внутри LeafRTP и сами извлекаются в plugins/RTP/addons/. Чтобы отключить - удалите нужный из этой папки (больше не извлечётся):

• LeafRTPGuiAddon (демо GUI) - книжка-меню вместо голой команды. Цепляется на /rtp, так что при его наличии /rtp открывает меню, а мгновенный телепорт остаётся в интерфейсе как опция. Добавляет команду /rtp gui (право rtp.gui).
• LeafRTPClaimAddon (проверка приватов) - 12 проверок на защиту территории, чтобы телепорт не закинул на чужой участок.
• LeafRTPRiftAddon (демо эффектов) - добавляет эффект "Разлом", который во время подготовки разрывает землю (только на клиенте, на безопасность не влияет). Используется в effects/*.yml.
• LeafRTPCountdownAddon (демо обратного отсчёта) - показывает обратный отсчёт до телепорта и позицию в очереди. Отличный пример для своих аддонов.

Все эти аддоны - рабочие примеры кода. Их исходники лежат в addons/ в репозитории. Аддоны Rift и Countdown написаны на чистом rtp-api / effects-api (без привязки к платформе) - берите за основу для своих.

---

Смотрите механику в действии

LeafRTP - не чёрный ящик. /rtp scan раскрашивает регион на реальной игровой карте (зелёный - безопасно, красный - нет) в процессе проверки. /rtp info показывает живые TPS/MSPT, использование кучи, процентили задержек и причины отказов - никаких дополнительных плагинов не нужно.

Наблюдайте, как scan закрашивает регион в реальном времени. Подробнее: Сканирование и пространственная память, Диагностика.

---

Требования

Жёсткие требования. Если хоть одно не выполняется - EssentialsX /rtp или HuskHomes вполне сойдут как альтернатива.

• Java 21+ (не обсуждается).
• Paper, Spigot или другой форк Bukkit, либо Fabric/NeoForge (1.21.x / 26.1.x). Arclight/Mohist для Forge-прокладок.
• Vault (опционально) для экономики; без него неактивен.

---

Сравнение с конкурентами

Paper 1.20.1 / 1.21.11

Плагин	TP/с	MSPT p99 (мс)	Мин. TPS	CPU/TP (мс)	Успех
LeafRTP	19.8	4	20.00	16.9	100%
JakesRTP	20.0	70	20.00	26.0	100%
BetterRTP	7.3	852	20.00	53.6	100%
HuskHomes	6.2	372	20.00	52.2	100%
AdvancedRTP	2.16	2 100	19.95	92.1	96.3%
EzRTP	1.76	2 903	19.95	139.6	100%
AsyRTP	1.67	4 534	19.95	38.8	100%
EssentialsX /tpr	0.96	4 504	19.95	88.9	75.9%

EssentialsX /tpr - команда запроса (рукопожатие + принятие), а не прямого телепорта. Временные рамки теста обрубили часть задержек.

Spigot 1.20.1

Плагин	TP/с	MSPT p99 (мс)	Мин. TPS
LeafRTP	1.52	3	6.4
JakesRTP	1.04	2 252	7.5
BetterRTP	1.33	3 790	2.18
HuskHomes	0.93	4 939	2.59

Folia 26.1

Плагин	TP/с	CPU/TP (мс)	Watchdog stalls	Успех
LeafRTP	12.5	4.15	0	100%
EzRTP	5.3	6.34	7 (один регион 20.4 с)	96.2%

На Folia LeafRTP не вызвал ни одного watchdog stall'а, в отличие от EzRTP.

Легенда: все данные получены локально, если не указано иное. Полная методология и CSV-файлы - в helpers/StressTestRTP/.

---

Таблица совместимости

Платформа	Статус	Примечания
Paper (+ Purpur, Pufferfish, Leaf, Leaves, DivineMC)	Рекомендуется	Полностью асинхронная работа через getChunkAtAsync.
Spigot (+ форки)	Поддерживается	Off-tick Anvil префильтр - пропускная способность как на Paper.
Arclight / Mohist (Forge-мостьi)	Официально	Используйте Spigot/Paper jar.
Folia	Поддерживается (бесплатно)	Регионное планирование + асинхронный телепорт, без конфигов.
Мультисервер / прокси (Velocity)	Прямая поддержка	Встроенный транспорт proxy-direct - без Redis/SQL.
Fabric	Поддерживается	Полноценная поддержка, наравне с Bukkit-семейством.
Нативный NeoForge	Поддерживается	Minecraft 1.21.x / 26.1.x.
Нативный Forge	Используйте Arclight/Mohist	Нативный адаптер не планируется.

---

Часто задаваемые вопросы

В: Как сделать, чтобы /rtp не лагал сервер, и почему LeafRTP быстрее? О: Места назначения проверяются и загружаются в очередь заранее, до того как вы ввели команду. Поэтому /rtp срабатывает мгновенно, не нагружая главный поток. Пространственная память запоминает плохие участки, а off-tick Anvil префильтр отсеивает опасные места до загрузки чанков.

В: Сложно настраивать? Экономика, меню, эффекты есть? О: Нет, и да. Плагин работает без конфигов сразу после установки. Регионы, безопасность и эффекты можно подкрутить позже. Кликабельное меню, Vault-экономика, движок эффектов, теплокарты и 12 проверок приватов - всё в бесплатной версии.

В: Почему называется LeafRTP, а не просто RTP? О: "RTP" - общий термин для случайного телепорта, и под этим именем плагин было невозможно найти в поиске. "LeafRTP" - уникальное название, которое однозначно ведёт на этот плагин. Сама команда осталась /rtp, API - rtp-api, конфиги и данные не поменялись.

В: Работает с Iris / Terra / кастомными генераторами датапаков? О: Да. Регионные файлы читаются напрямую, поэтому модовые блоки и биомы работают без дополнительной настройки. /rtp biome:<x> правильно определяет биом даже на прегенерированных мирах, так как данные берутся из .mca-файлов.

В: Поддерживаются ли треугольные или ромбовидные формы регионов? О: Используйте форму Polygon. Треугольник - полигон с тремя вершинами, ромб - повёрнутый квадрат. Отдельный тип не нужен.

В: Нужен ли Chunky или другой прегенератор? О: Нет. /rtp scan - встроенный off-tick прегенератор, который проходит по региону и строит постоянную пространственную память. Это не загружает все чанки сразу, а лишь запоминает опасные сектора, чтобы избежать их. Chunky можно ставить рядом, если нужна полная прегенерация карты.

В: Я на NeoForge. О: NeoForge - полноценно поддерживаемая платформа на Minecraft 1.21.x / 26.1.x. Просто киньте мод.

В: Я на Forge. О: Используйте Arclight или Mohist (официально поддерживаются) с этим jar. Нативный адаптер Forge не планируется.

В: Память и MSPT - стоит ли беспокоиться? О: LeafRTP тратит ограниченный объём RAM (очередь, ограниченная cacheCap) ради скорости. TPS не должны падать ниже ~19 из-за одного LeafRTP. Всплески MSPT при генерации новых областей - ожидаемы, это цена генерации чанков, а не самого RTP.

---

Границы бесплатной сборки и известные проблемы

• safety.yml принимает плоские имена материалов (LAVA, MAGMA_BLOCK, CACTUS, FIRE). Блок-теги (#minecraft:leaves), предикаты состояния (OAK_SLAB[waterlogged=true]) и распределённые хранилища (SQL/Redis) не входят в эту версию.
• Правки в safety.yml и фильтрах биомов пока не инвалидируют кеш формы. Рабочий способ: /rtp scan reset <region>.
• По умолчанию платформа экстренной посадки отключена (platformRadius: -1). Чтобы вернуть поведение 2.x, поставьте 0 или больше.

Актуальный список: CHANGELOG.

---

Скачайте плагин LeafRTP для вашего сервера Minecraft и забудьте о лагах при случайной телепортации. Быстрая настройка, надёжная работа и полный контроль.