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

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

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/
```

Restart Server

bash

undefined

# Server will generate config.yml automatically

Configure (see Configuration section below)

Commands

Player Commands

How It Works

RTP Process

Player executes /rtp
- Opens chest GUI with options
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
Search Phase (5 seconds)
- Counts down with action bar message
- Cancels if player moves
- Finds random safe location within radius
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+

EZrtp