# ⚡ aRTP — The Ultimate All-In-One RTP Plugin
> *Zero lag. Real portals. Groups land together. Built for modern Paper servers.*
Why install 3 different plugins for commands, portals, and queues? **aRTP** is a modern, lightweight, ground-up rewrite of what a Random Teleport plugin should feel like. It combines an **instant command RTP**, physical **walk-in Zone Portals**, and a unique **group Matchmaking Queue** into one massive powerhouse.
View attachment 966513
---
## Why aRTP?
### Group Matchmaking — Parties Land Together
Every other RTP plugin forces players to teleport alone. aRTP features a built-in Matchmaking Queue! If multiple players are standing inside the same physical RTP portal when the timer drops to zero, the plugin calculates **one** safe location and drops **everyone** there at the exact same time. No more splitting up friends!
### ️ The Ultimate RTP Chest GUI
Say goodbye to boring text commands. Players can type `/artp` to open a sleek, fully customizable interactive Chest GUI.
* Visually select which realm (Overworld, Nether, End, Resource world) to teleport to.
View attachment 966514
View attachment 966515
* Admins can configure the exact GUI size, title, glass pane borders, and every single item (Material, Slot, Name, Lore, Enchants).
* Perfect for server hubs!
### Physical Walk-In Portal Zones
Admins can use an in-game **wand tool** (`/rtpzone wand`) to select any 3D region of the world and convert it into a live RTP portal. Players just walk into the invisible border to trigger the teleport!
* Features flaming particle walls.
* Configurable entry/exit audio pings.
* Native floating Hologram support.
### Specific Trigger Blocks
Don't want the whole portal zone to trigger the RTP? You can designate specific **Trigger Blocks** (e.g., Diamond Blocks, Beacons). The teleport sequence will *only* activate if a player steps on that exact block inside the zone!
### Cross-Dimensional Tunnels
Your portal doesn't have to go to the same world it's built in. Build a physical portal at your Overworld spawn that calculates a safe spot and drops players directly into the Nether or The End!
### ️ Async Chunk Pre-Loading = Zero Void Falling
Ever teleported and fallen through unloaded chunks for 5 seconds? aRTP forces the server to **fully pre-load the destination chunks asynchronously** in the background before moving the player a single block. You arrive only after the ground physically exists. Zero TPS drops, zero lag.
### ️ Cancel-On-Move Combat Protection
If a player types `/artp`, but then takes damage in PvP or tries to run away while the plugin is warming up, aRTP tracks their location and instantly cancels the teleport. Nobody is using this to combat log!
### VIP Rank Cooldowns
Reward your premium ranks with better RTP access using our tiered permission system:
* Default: 60s cooldown
* `artp.cooldown.vip` - 30s cooldown
* `artp.delay.staff` - 0s bypass!
---
## ⚙️ Advanced Customization
* **Instant 0ms Teleports:** A background cache silently pre-calculates safe locations so players get teleported instantly with zero wait times.
* **Smart Blacklists:** Never let players spawn in the Ocean, in Lava, or inside your spawn base. Configure per-zone blacklists for Biomes, Dangerous Blocks, and Coordinate Rectangles.
* **PlaceholderAPI & bStats:** Natively integrates with PlaceholderAPI to show RTP cooldowns and queue status on your server scoreboards.
---
## Commands & Permissions
### Player Commands
* **`/artp`** — Opens the sleek RTP world selector GUI.
* *Permission:* `artp.use`
* **`/wild`** — Instant random teleport, skipping the GUI.
* *Permission:* `artp.use`
* **`/artp <zone>`** — Direct teleport to a specific zone (e.g. `/artp overworld`).
* *Permission:* `artp.use`
* **`/rtpqueue join/leave`** — Join or leave the matchmaking queue remotely.
* *Permission:* `artp.use`
### Admin Commands
* **`/rtpzone wand`** — Get the portal selection wand to build physical zones.
* *Permission:* `artp.admin`
* **`/rtpzone trigger add/remove`** — Add a physical trigger block to a zone.
* *Permission:* `artp.admin`
* **`/artp admin rtp disable <zone>`** — Live-disable instant RTP for a realm.
* *Permission:* `artp.admin`
* **`/artp admin queue disable <zone>`** — Live-disable matchmaking for a realm.
* *Permission:* `artp.admin`
* **`/artp admin reload`** — Hot-reload all configs and messages without restarting.
* *Permission:* `artp.admin`