Skip to content

Repository files navigation

RandomTeleport

java21 paperapi

Телепортируйте игроков на случайные (или гарантированно удалённые на 250 блоков от других игроков) точки мира через настраиваемое GUI‑меню. Плагин построен на Paper‑API, использует Adventure для оформления сообщений / GUI и полностью поддерживает HEX‑цвета &FF0000.


⚡️ Ключевые возможности

Возможность Описание
Два режима Обычный (рандом в пределах мира) и Ближайший (≥ 250 блоков от игроков)
GUI Меню 5 × 9 c визуальными «островками» и настраиваемыми предметами
Гибкая конфигурация /rtpreload перечитывает config.yml без перезагрузки сервера
Кулдаун По умолчанию — 1 минута, задаётся в секции settings.cooldown-seconds

📥 Установка

  1. Скачайте последний релиз из релизов GitHub.
  2. Поместите RandomTeleport‑x.x.x.jar в папку plugins/ вашего Paper / Purpur / Spigot сервера (1.16 +).
  3. Перезапустите сервер или выполните plugman load RandomTeleport.
  4. В каталоге plugins/RandomTeleport появится config.yml — настройте плагин под себя.

⚙️ Сборка из исходников

Клонируйте репозиторий

$ git clone https://github.com/freadc0de/RandomTeleport.git
$ cd RandomTeleport

Сборка теневого JAR (без shading зависимостей)

$ ./gradlew build

Готовый файл лежит по пути build/libs/RandomTeleport-<version>.jar.


📜 Команды & Права

Команда Описание Разрешение По умолчанию
/rtp Открывает меню телепортации randomteleport.use true
/rtpreload Перезагрузка конфига + проверка обновлений randomteleport.reload op

🛠️ Как это работает внутри

  • Gradle + Java 17 — современная сборка.
  • Adventure — стильные сообщения и HEX‑цвета.
  • Chunk API — асинхронная загрузка чанков перед телепортом, без лагов.
  • UpdateChecker — простое обращение к GitHub API с парсингом tag_name.

Архитектура разнесена по пакетам: teleport, gui, cooldown, animation, update.


🤝 Содействие

Любые PR’ы приветствуются — фиксы, идеи новых функций, улучшение локализации.

About

Plugin for randomise teleport location of players on your server

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages