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>
• /rtp set warmup

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

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