📖About ZenRTP

ZenRTP

paper
purpur

A random teleport plugin for Paper 1.21.x servers. Picks a safe spot within a configurable ring around your world center, then sends players there — with cooldowns, costs, and per-world rules.

Installation

Download the latest ZenRTP-*.jar from Releases or Modrinth.
Drop it in your plugins/ folder and restart.
Edit plugins/ZenRTP/config.yml and messages.yml to your liking.
Run /zenrtp reload to apply changes without a full restart.

Commands

Command	Description
`/rtp`	Teleport to a random spot in your current world.
`/rtp <world>`	Teleport to a random spot in `<world>`.
`/rtpo <player> [world]`	RTP another player (optionally into a specific world).
`/zenrtp reload`	Reload `config.yml` and `messages.yml`.

Permissions

Permission	Default	Description
`zenrtp.use`	everyone	Use `/rtp`.
`zenrtp.rtp.<world>`	—	Allow RTP into a specific world (e.g. `zenrtp.rtp.world_nether`).
`zenrtp.others`	op	Use `/rtpo`.
`zenrtp.admin`	op	Use `/zenrtp reload`.
`zenrtp.bypass.cooldown`	op	Skip cooldown.
`zenrtp.bypass.cost`	op	Skip costs.
`zenrtp.bypass.daily`	op	Skip daily limit.

Configuration

All settings live in plugins/ZenRTP/config.yml with inline comments. Key areas:

Location — min-distance, max-distance, center-x, center-z, min-y, max-y
Safety — unsafe block list, sky visibility (Overworld only), spawn avoidance, nearby player avoidance
Worlds — blacklist/whitelist, per-world overrides
Flow — teleport delay, cancel-on-move, chunk preloading, max attempts
Limits — cooldown, daily cap, hunger/XP/Vault money costs

Edit messages.yml to customize all chat messages and prefixes (MiniMessage or & colors supported).

Optional Dependencies

Vault — required only if using currency-cost
PlaceholderAPI — not required for any core RTP functionality

Building

git clone https://github.com/maybeizen/zenrtp.git
cd ZenRTP
./gradlew shadowJar

Output: build/libs/ZenRTP-*.jar

Author: maybeizen · MIT License