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

🔐 Permissions

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! 🌍