RTP — Random Teleport

A fully-featured Random Teleport plugin built for modern Paper survival servers. Players open a clean GUI with /rtp and choose a dimension to teleport to — with extensive safety checks, smart location spreading, and a smooth countdown experience.

GUI-Based Teleport Menu

Open /rtp to choose your destination from a clean inventory menu:

• Overworld — always available
• Nether — unlocks after your first visit
• The End — unlocks after your first visit

🔒 Dimension Unlock System

Players must discover a dimension before they can RTP there. Unlocks are saved to a built-in SQLite database and persist across restarts. Can be disabled in config to make all dimensions available from the start.

✅ Advanced Safe Location Detection

Every teleport destination passes strict safety checks before the player is sent there:

• No lava, fire, magma, cactus, sweet berry bushes, powder snow, or water nearby
• Solid ground with clear headspace required
• Full 3×3 area around landing spot verified
• Special platform detection logic for the Nether
• Configurable lava scan radius

🎲 Smart Random Distribution

• Weighted randomness for natural location spread
• Per-player location history prevents repeat teleports
• Configurable min/max distance range

⚙️ Configuration

• Min & max teleport distance
• Cooldown time between teleports
• Countdown length before teleporting
• Chunk preload radius around destination
• Max search attempts for safe locations
• Allow or block water landing
• Lava scan radius around destination
• Disable dimension lock entirely