ᴍɪɴᴛ-ʀᴛᴘ​

MintRTP is a fully featured random teleport plugin built for Paper and Folia 1.21.11, designed with a clean GUI, strong safety checks, and a consistent Mint-style configuration system.

It provides a reliable RTP experience with support for economy, cooldowns, and globally unique teleport locations, making it ideal for survival servers that want something polished and scalable.

Overview

​
MintRTP allows players to randomly teleport across different worlds using a simple and configurable GUI. Each teleport is handled safely, with validation to prevent unsafe placements and a system that ensures every generated location is permanently unique.

GUI System

​

The RTP system is built around a clean, central GUI selector.

Players can choose between:

• Overworld RTP (Grass Block)
• Nether RTP (Netherrack)
• End RTP (End Stone)

Each option is fully configurable in guis.yml, including:

• Material
• Slot position
• Display name
• Lore
• Glow
• Custom model data

The GUI also displays live player counts for each world, updating whenever it is opened.

Clicking a world opens a confirmation GUI before teleport begins. This confirmation menu will dynamically show:

• RTP cost (if economy is enabled)
• Free RTP usage (if applicable)

Teleport System

​
Teleporting follows a clean and consistent flow:

• 5 second configurable countdown
• Actionbar countdown messages
• Configurable sounds
• Optional cancel on movement

All timing, messages, and sounds are fully configurable.

If the teleport is cancelled (for example by moving), it will stop immediately and notify the player.

World Support

​
Each world is handled independently with its own configuration.

Overworld​

• Uses surface-only teleporting
• Prevents cave or underground placements

Nether​

• Avoids lava lakes and unsafe blocks
• Ensures safe standing space

End​

• Avoids the main end island
• Uses a configurable exclusion radius
• Teleports players to outer islands only

Each world supports:

• Custom radius
• Min/max distance
• Independent economy settings
• Independent cooldowns

Safety System

​
MintRTP includes strong safety validation to ensure players are never teleported into dangerous or broken locations.

The plugin prevents teleporting into:

• Lava
• Water
• Fire
• Inside blocks
• Unsafe or invalid ground
• Locations with no headroom
• The void

Overworld RTP specifically avoids underground placements entirely.

Unique Location System

​
Every RTP location is globally unique.

Once a location has been used:

• It can never be used again
• It is blocked for all players
• It is stored permanently in the database

This prevents overlap, improves exploration, and ensures players are always sent somewhere new.

Even if a teleport is cancelled during countdown, that location is still marked as used.

Economy Support​

MintRTP includes built-in economy support with flexible configuration.

Supports:

• Vault
• MintTokens

Features:

• Per-world RTP pricing
• Optional free RTP system
• Configurable free RTP count
• Shared or per-world free RTP pools

Economy is disabled by default and can be enabled in config.yml.

Cooldowns

​
Cooldowns can be enabled or disabled in the config.

• Per-world cooldown support
• Supports time formats (seconds, minutes, hours, days)
• Bypass permission available
• Cooldown messages are fully configurable.

Commands

​

Player Commands​

/rtp → Opens the GUI
/rtp overworld → Starts overworld RTP
/rtp nether → Starts nether RTP
/rtp end → Starts end RTP

Alias:
/randomtp

Admin Commands​

/rtp reload → Reloads all configs
/rtp → Forces RTP for a player

Admin RTP bypasses:

• Permissions
• Cooldowns
• Economy costs (if enabled)

Permissions​

mintrtp.use
mintrtp.gui
mintrtp.overworld
mintrtp.nether
mintrtp.end
mintrtp.reload
mintrtp.admin
mintrtp.bypasscooldown
Operators also bypass cooldowns and teleport timers.

Storage

​
MintRTP uses a database system to store RTP data.

Default:

• SQLite (local file)

Optional:

• MySQL

Stored data includes:

• Used RTP locations
• Player cooldowns
• Free RTP usage

Configuration

​
MintRTP uses three main configuration files:

• config.yml
  Controls core behaviour such as:

• storage
• cooldowns
• economy
• RTP radius
• teleport settings

• messages.yml
  Handles:

• prefixes
• chat messages
• actionbar text
• economy and cooldown messages

• guis.yml
  Controls:

• GUI layout
• item positions
• display names and lore
• filler and border items

Support​

For help, bug reports, or suggestions:

Join our Discord:
https://discord.gg/P6aYzRPZ