ClipsEZRTP

# 🌍 ClipsEZRTP — Simple & Safe Random Teleport **ClipsEZRTP** is a lightweight, modern **random teleport (RTP)** plugin designed for **Paper servers**. It focuses on **safety, performance, and configurability** while staying easy to use. No lag, no unsafe teleports, and no forced dependencies. --- ## ✨ Features - 🔀 **Random teleport command** - `/rtp` (aliases: `/wild`, `/randomtp`) - ⚡ **Asynchronous teleport searching** - No server freezes or lag spikes - 🛡️ **Safe location detection** - Ground block whitelist - Biome blacklist - Optional cave teleporting - ⏱️ **Warmup delay with movement cancel** - Prevents combat escapes and abuse - ⏳ **Per-player cooldown** - 💰 **Optional Vault economy support** - 🌍 **World border aware** - 🌍 **per world RTP radius support** - ⚙️ **Fully configurable messages & settings** - 🔁 **Live reload support (no restart required)** --- ## 🧩 Optional Integrations ### 🟢 WorldGuard (Optional) - Custom region flag (default: `clipsezrtp`) - Block RTP destinations inside selected regions - Fully optional — plugin works without WorldGuard - Can be toggled live using `/ezrtp reload` ### 🔴 Combat Tag Blocking (Optional) - Prevents `/rtp` usage while in combat - Supports: - Common combat plugins (via reflection) - Bukkit metadata keys - Scoreboard tags - No hard dependency on any combat plugin - Can be toggled live using `/ezrtp reload` --- ## 📜 Commands | Command | Description | |------|------------| | `/rtp` | Teleport to a random safe location | | `/wild` | Alias for `/rtp` | | `/randomtp` | Alias for `/rtp` | | `/ezrtp reload` | Reload config, messages, and hooks | --- ## 🔐 Permissions | Permission | Description | |---------|-------------| | `clips.rtp.use` | Allows use of `/rtp` | | `clips.rtp.bypass.cooldown` | Bypass RTP cooldown | | `clips.rtp.bypass.cost` | Bypass economy cost | | `clips.rtp.bypass.combat` | Bypass combat blocking | | `clips.rtp.bypass.worldguard` | Bypass WorldGuard region blocking | | `clips.ezrtp.reload` | Allows use of `/ezrtp reload` | > `clips.ezrtp.reload` defaults to **OP** --- ## ⚙️ Configuration - Customizable radius range - Optional cave teleporting - Economy cost & cooldown control - Safe block & biome control - Optional WorldGuard and combat-tag support - Fully customizable messages ### 🔁 Live Reloading After editing `config.yml`, apply changes instantly: /ezrtp reload --- ## 📦 Requirements - **Paper** (or Paper forks like Purpur, Pufferfish) - **Minecraft 1.20.4 – 1.21.x** - **Java 17** ❌ Spigot is **not supported** --- ## 🚀 Installation 1. Download the plugin 2. Place the `.jar` in your `/plugins` folder 3. Start the server 4. Edit `config.yml` as needed 5. (Optional) Use `/ezrtp reload` to apply changes live --- ## 🧪 Tested On - Paper 1.21.x - Java 17 - With and without: - Vault - WorldGuard - Economy plugins - Combat plugins --- ## 💡 Notes - WorldGuard and combat support are **completely optional** - The plugin will **never crash** if optional plugins are missing - Designed to be lightweight and stable for public servers - Safe to reload repeatedly — no memory leaks or duplicated hooks --- ## 📞 Support If you encounter issues: - Check the console for errors - Ensure you are running **Paper** and **Java 17** - Regenerate the config after updates - Include your server version and installed plugins when reporting bugs Enjoy safe and lag-free random teleports! 🌍