RTP Plugin - Complete Documentation

Overview

The Random Teleport (RTP) Plugin is a Spigot/Paper Minecraft plugin that allows players to teleport to random safe locations on the server with advanced features like world management, combat prevention, and movement locking.

Features

1. GUI-Based Teleportation

• Open a chest inventory interface with /rtp command
• Click buttons to initiate teleport, view info, or cancel
• User-friendly and visually appealing interface

2. Smart Location Finding

• Automatically finds safe spawn locations
• Spawns players at the highest solid block in the target area
• Configurable search radius per world
• Avoids lava, water, and dangerous terrain

3. World Management

• Enable/disable RTP in specific worlds
• Set custom teleport radius for each world
• Blacklist worlds from RTP (e.g., admin areas, PvP arenas)

4. Movement Lock (Anti-Cheat)

• Prevents players from moving during RTP search
• Displays countdown in action bar: "Searching for location... Don't move!"
• Automatically cancels RTP if player moves
• Locks movement for configurable duration (default: 5 seconds)

5. Combat Protection

• Prevents RTP usage if player recently took damage
• Configurable combat cooldown (default: 15 seconds after damage)
• Shows warning message when in combat

6. Global Cooldown

• Prevents spam teleporting
• Configurable cooldown timer (default: 30 seconds)
• Per-player cooldown tracking

7. Admin Control Panel

• /rtp admin commands to manage all settings at runtime
• No need to edit config files
• Enable/disable worlds on the fly
• Adjust search time, cooldown, combat cooldown, and more

Installation

Requirements

• Java 11+
• Spigot/Paper 1.16+
• Maven (for building from source)

Steps

1. Download or Build

   bash

   undefined

   # Build from source
   git clone https://github.com/einfachduncan/minecraft-rtp-plugin.git
   cd minecraft-rtp-plugin
   mvn clean package
   

    

2. Install JAR

   • Copy the generated JAR from target/ folder
   • Place it in your server's plugins/ directory
   bash

   undefined

   cp target/RandomTeleportPlugin-*.jar /path/to/server/plugins/
   

    

3. Restart Server

   bash

   undefined

   # Server will generate config.yml automatically
   

    

4. Configure (see Configuration section below)

Commands

Player Commands

Command | Permission | Description -- | -- | -- /rtp | rtp.use | Open RTP GUI and teleport to random location /rtp reload | rtp.reload | Reload plugin configuration

How It Works

RTP Process

1. Player executes /rtp

   • Opens chest GUI with options

2. Player clicks "Teleport" button

   • Checks if world is enabled
   • Checks if player is in combat
   • Prevents movement for 5 seconds
   • Starts async search for safe location

3. Search Phase (5 seconds)

   • Counts down with action bar message
   • Cancels if player moves
   • Finds random safe location within radius

4. Teleportation

   • Spawns player at highest solid block
   • Shows success message
   • Starts cooldown timer
   • Restores movement

Troubleshooting

"RTP is not available in this world"

• Check if world is in disabled-worlds in config.yml
• Use /rtp admin world enable <world> to enable it

Players can't move during RTP

• This is intentional! Movement is locked for 5 seconds during search
• If they move, RTP is cancelled

Teleport not happening

• Check cooldown: /rtp admin list
• Check if in combat (took damage in last 15 seconds)
• Verify world is enabled

Changes not saving

• Use /rtp admin reload to reload config
• Admin commands save changes to config.yml automatically

Support & Issues

Found a bug? Have a feature request?

• Open an issue on GitHub: https://github.com/einfachduncan/minecraft-rtp-plugin/issues
• Contact the developer

License

This plugin is provided as-is for Minecraft server use.

Last Updated: April 21, 2026
Version: 2.0+

# 🌍 Random Teleport Plugin - Complete Guide

Tags: minecraft spigot paper plugin teleport rtp server random admin java gui inventory movement-lock combat-protection world-management cooldown bukkit 1.16+