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
• ⚙️ Fully configurable messages & settings

🧩 Optional Integrations

🟢 WorldGuard (Optional)

• Custom region flag (default: clipsezrtp)
• Block RTP destinations inside selected regions
• Fully optional — plugin works without WorldGuard

🔴 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

📜 Commands

🔐 Permissions

⚙️ Configuration

• Customizable radius range
• Optional cave teleporting
• Economy cost & cooldown control
• Safe block & biome control
• Optional WorldGuard and combat-tag support
• Fully customizable messages

⚠️ Note:
The config.yml file changed in the latest update.
To get the new config, delete the old config.yml and restart the server.

📦 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. Restart the server

🧪 Tested On

• Paper 1.21.x
• Java 17
• With and without:
  • Vault
  • WorldGuard
  • Economy 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

📞 Support

If you encounter issues:

• Check the console for errors
• Ensure you are running Paper and Java 17
• Regenerate the config after updates

Enjoy safe and lag-free random teleports! 🌍