🧭 RTP+ — Enterprise Random Teleport & Claim Safety System

RTP+ is a high-performance, GUI-driven random teleport plugin for Paper/Spigot. Built for zero-latency instant teleports, full land claim protection, Vault economy, and rich server integrations.

Features a modern world-select GUI, instant 0ms pre-cache engine, anti-grief protection hooks (WorldGuard, GriefPrevention, Towny, Lands, HuskTowns), SQLite persistence, and complete config control.

---

🌟 More from the Developer

Thanks for checking out this project!

If you're interested in more of my work, or just looking for a great Minecraft server to play on, you're welcome to join HYDRAZ Network.

🌐 Server Address
play.hydraz.online

---

✨ Key Features

⚡ Instant 0ms RTP (Location Pre-Cache Pool)

• Zero Search Lag: Background async engine pre-scans and maintains a cache of safe coordinates.
• Instant Teleportation: Players teleport immediately upon clicking without waiting for chunk generation.
• Automatic Fallback: Seamlessly switches to on-demand async scanning if cache is empty.

🛡️ Universal Land Claim & Anti-Grief Protection

Never worry about players teleporting inside claims or protected spawn regions. Softly integrates with:

• 🏰 WorldGuard 7.x (Respects non-global regions & flags)
• 📜 GriefPrevention (Respects player claims & subdivisions)
• 🏘️ Towny (Avoids town plots & town borders)
• 🗺️ Lands (Avoids claimed areas)
• 🛡️ HuskTowns (Avoids town territories) (Zero performance overhead if these plugins are not installed!)

🖼️ Modern GUI & Smart UX

• One-Click World GUI: Configurable titles, sizes, filler glass, and open sounds.
• Single-World Auto-RTP: Optional setting to auto-teleport immediately without opening the GUI on single-world survival servers.
• Native Command Aliases: Supports /wild, /rtp, and /randomtp.
• Voluntary Cancel: Players can abort warmups anytime using /rtp cancel (with automatic economy refund).

🧩 World Targeting, Biomes & Hazard Safety

• Biome Whitelist/Blacklist: Restrict or ban specific biomes per world (e.g., ban Ocean biomes).
• Nether Roof Bedrock Shield: Scans below ceiling bedrock to prevent trapped roof spawns.
• End Void Prevention: Guarantees solid End Stone landings (Y ≥ 40).
• Hazard & Waterlogged Blacklist: Detects waterlogged blocks, lava cauldrons, powder snow, and sweet berry bushes.
• Anti-Floating Pillars: Demands adjacent solid blocks so players never spawn on a 1×1 pillar over lava.

🧪 Post-Teleport Invincibility & Arrival Effects

• Invincibility Grace Period: Configurable damage immunity (default 5s) protecting against chunk loading lag.
• Arrival Potion Effects: Configurable Slow Falling, Resistance, and Night Vision for smooth landings.

🏦 Economy & SQLite Limits

• Vault Support: Charge players per-world (auto-refunds if teleport fails or is cancelled).
• Daily & Weekly RTP Limits: Calendar-based resets (Midnight UTC).
• Persistent Cooldowns: Cooldowns and use counts survive server restarts via SQLite.

🎨 Visuals & Rich Placeholders

• Boss Bar Countdown: Beautiful animated draining Boss Bar during warmup.
• On-Screen Titles: Polished arrival titles showing destination coordinates.
• Particle FX: Orbiting portal particles during warmup; arrival burst effects.
• Comprehensive PAPI Placeholders: %rtpplus_cooldown%, %rtpplus_cooldown_<world>%, %rtpplus_status_<world>%, %rtpplus_uses_left_today%, %rtpplus_uses_left_weekly%, etc.

---

🧾 Commands

Command	Description	Permission
/rtp or /wild	Open the RTP GUI (or auto-teleport)	rtp.use
/rtp <world>	Direct random teleport to a specific world	rtp.use
/rtp cancel	Cancel active teleport countdown & refund cost	rtp.cancel
/rtp help	Interactive command list and help menu	rtp.use
/rtp history [player]	View recent teleport coordinates	rtp.history
/rtp reload	Reload configuration files	rtp.reload
/rtp tp <player> <world>	Force-teleport a player (bypasses cooldowns/costs)	rtp.admin
/rtp stats	View server-wide teleport statistics	rtp.admin
/rtp resetcooldown <player> [world]	Reset player cooldowns in memory & database	rtp.admin
/rtp resetlimits <player>	Reset player daily and weekly use limits	rtp.admin

---

🔐 Permissions

Permission	Description	Default
rtp.use	Access to /rtp, /wild, and /rtp help	true
rtp.cancel	Access to /rtp cancel	true
rtp.history	View personal teleport history	true
rtp.reload	Reload plugin configuration	op
rtp.admin	Access to all admin management commands	op
rtp.limits.bypass	Bypass daily and weekly use caps	op
rtp.cooldown.bypass	Bypass all cooldown timers	op
rtp.world.overworld	Random teleport in Overworld	true
rtp.world.nether	Random teleport in Nether	true
rtp.world.end	Random teleport in The End	true
rtp.cooldown.vip1	Custom cooldown tier (configurable)	false
rtp.cooldown.vip2	Custom cooldown tier (configurable)	false