# ZenRTP<\/p>\n
A lightweight random teleport plugin for **Paper** servers. Pick a ring around a center point, find a safe surface, and teleport players there\u2014with cooldowns, costs, optional per-world rules, and messages you can edit.<\/p>\n
**Requirements:** Paper **1.21.x** (API `1.21`), **Java 21**.
\nZenRTP is built for Paper servers; Spigot-only servers are not supported.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Random location** in a configurable distance band from `center-x` \/ `center-z`, with per-world overrides.
\n– **Safety checks:** configurable \u201cunsafe\u201d blocks (lava, fire, cactus, etc.), air at feet\/head, solid ground, and Y bounds (`min-y` \/ `max-y`).
\n– **Sky visibility (Overworld only):** optional clear column to build height. **Nether and End ignore this**\u2014there is no sky there.
\n– **Teleport delay** with a **chat countdown** (e.g. 3, 2, 1); movement can cancel the pending RTP if enabled.
\n– **Cooldowns**, optional **daily limits**, and **costs** (hunger, XP, money via Vault).
\n– **World blacklist \/ whitelist**, **spawn avoidance**, **avoid nearby players**, **chunk preloading** around the destination.
\n– **Titles and sounds** (configurable); **messages** in `messages.yml` (MiniMessage or legacy `&` codes).<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download the latest ZenRTP jar file from the “Versions” page.
\n2. Place it in your server\u2019s `plugins` folder.
\n3. Start or restart the server.
\n4. Edit `plugins\/ZenRTP\/config.yml` and `plugins\/ZenRTP\/messages.yml` as needed, then run **`\/zenrtp reload`** (or restart).<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Default | Purpose | If a player lacks `zenrtp.rtp. —<\/p>\n ## Optional plugins<\/p>\n | Plugin | Role | —<\/p>\n ## Configuration (overview)<\/p>\n Main file: **`plugins\/ZenRTP\/config.yml`**.<\/p>\n – **Distance & area:** `min-distance`, `max-distance`, `center-x`, `center-z`. All options are documented with comments in the default `config.yml` shipped with the jar.<\/p>\n —<\/p>\n ## Messages<\/p>\n Edit **`plugins\/ZenRTP\/messages.yml`** to change chat text, prefixes, and placeholders. After a reload, changes apply without a full restart.<\/p>\n —<\/p>\n ## Building from source<\/p>\n “`bash The plugin jar is produced under `build\/libs\/` (name includes the version from `plugin.yml`).<\/p>\n","protected":false},"excerpt":{"rendered":" Simple, highly configurable RTP plugin.<\/p>\n","protected":false},"featured_media":173796,"template":"","meta":{"_minecraft_slug":"zenrtp","_minecraft_project_id":"i8iR7NeN","_minecraft_author":"maybeizen","_minecraft_license":"MIT","_minecraft_downloads":21,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"zenrtp.zip","_minecraft_size_bytes":64783,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:27:44.261868Z","_minecraft_date_created":"2026-04-17T02:29:42.413263Z","_minecraft_date_modified":"2026-04-12T19:46:37.947315Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/zenrtp","_minecraft_icon_attachment_id":173796,"_minecraft_imported_at":"2026-06-09T23:00:31+00:00","_minecraft_import_hash":"caf080dda0dcce21ded1261ecddae730","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,129,869,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-173795","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| ———————— | ———————————————————————– |
\n| `\/rtp` | Random teleport in the **world you are currently in**. |
\n| `\/rtp
\n| `\/rtpo
\n| `\/rtpo
\n| `\/zenrtp reload` | Reload `config.yml` and `messages.yml`. |<\/p>\n
\n| ———————— | ———– | ————————————————————————————————————————— |
\n| `zenrtp.use` | `true` | Use `\/rtp`. |
\n| `zenrtp.rtp.
\n| `zenrtp.others` | `op` | Use `\/rtpo`. |
\n| `zenrtp.admin` | `op` | Use `\/zenrtp reload`. |
\n| `zenrtp.bypass.cooldown` | `op` | Ignore cooldown. |
\n| `zenrtp.bypass.cost` | `op` | Ignore hunger\/XP\/money costs (unless `require-costs` is `true` in config). |
\n| `zenrtp.bypass.daily` | `op` | Ignore the daily RTP limit. |<\/p>\n
\n| —————— | ———————————————————————————– |
\n| Vault | Money cost (`currency-cost`) when configured. |
\n| **PlaceholderAPI** | Present if you use placeholders elsewhere; ZenRTP does not require it for core RTP. |<\/p>\n
\n– **Height:** `min-y`, `max-y` (per-world under `per-world-settings` if needed).
\n– **Safety:** `safe-location-check`, `unsafe-blocks` (Bukkit material names), `require-sky-visibility` _(Overworld only)_.
\n– **Worlds:** `world-blacklist`, `world-whitelist` (empty whitelist = all worlds except blacklist).
\n– **Flow:** `teleport-delay`, `cancel-on-move`, `max-attempts`, `preload-chunks`, `preload-radius`.
\n– **Spawn \/ players:** `spawn-radius`, `avoid-near-players`, `avoid-player-radius`.
\n– **Limits & costs:** `cooldown`, `daily-limit`, `hunger-cost`, `xp-cost`, `currency-cost`, `require-costs`.
\n– **Feedback:** `enable-sounds`, title timings, effect durations, `log-teleports`.<\/p>\n
\ngit clone https:\/\/github.com\/maybeizen\/zenrtp.git
\ncd ZenRTP
\n.\/gradlew shadowJar
\n“`<\/p>\n