MintRTP

# **ᴍɪɴᴛ-ʀᴛᴘ**​ **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** ​ !(https://cdn.modrinth.com/data/cached_images/17eca082b20c72c85219d4525a352d75645891d0_0.webp) 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. !(https://cdn.modrinth.com/data/cached_images/e22a624f6a83360844eed714a5b19db080a97c45_0.webp) ## **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 <player> <world> → 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