RTP-DonutSMP

RTP-DonutSMP is a Paper plugin that adds a GUI-based random teleport system with per-world settings and safe defaults. Players use /rtp to open a menu, pick a world, and get teleported to a safe random location inside that world's configured radius.

It is built for server owners who want a clean, configurable RTP flow with a layout file, editable messages, and live admin commands.

Why RTP-DonutSMP

GUI world selector with a simple slot layout file
Per-world control of center, radius, cooldown, price, icon, and lore
Global warmup with action bar countdown and cancel-on-move
Safe location search (avoids water, lava, leaves)
Vault economy support for RTP pricing
Admin commands to update settings without restarts
LuckPerms-friendly permission nodes

Features

Supports more than 3 worlds in the menu
Warmup countdown in the action bar (configurable)
Cancel teleport if the player moves
Safe location search with configurable attempt limit
Global per-player cooldown
Lore placeholders for radius, price, cooldown, and center

Commands

/rtp
/rtp reload
/rtp set <center|radius|cooldown|price> <world> <value>
/rtp set warmup <seconds>

Permissions

rtpdonutsmp.use
rtpdonutsmp.admin

Config Structure

The plugin uses two files:

config.yml for settings, messages, and world definitions
menu.yml for menu size, title, and slot -> world layout

Example world settings:

settings:
	max-tries: 20
	global-cooldown: true
	warmup-seconds: 5

worlds:
	world:
		enabled: true
		display-name: "&aOverworld"
		icon: GRASS_BLOCK
		center:
			x: 0.0
			y: 64.0
			z: 0.0
		radius: 5000
		cooldown: 300
		price: 0.0
		lore:
			- "&7Radius: &f{radius}"
			- "&7Price: &f{price}"
			- "&7Cooldown: &f{cooldown}s"

Example menu layout (add more worlds by adding more slots):

menu:
	size: 27
	title: "&6RTP Worlds"
	layout:
		"11": "world"
		"13": "world_nether"
		"15": "world_the_end"
		"20": "mining_world"

Messages

All user-facing text is editable in config.yml under messages, including:

no-permission
player-only
world-not-found
cooldown
warmup-actionbar
warmup-cancelled
teleport-success
teleport-failed

Compatibility

Server software: Paper
Minecraft API target: 1.21.x
Java: 21

Install

Build or download the release jar.
Place it in your server plugins folder.
Start the server once to generate config files.
Edit config.yml and menu.yml.
Run /rtp reload.

RTP DonutSMP