ᴍɪɴᴛ-ʀᴛᴘ
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
