RTPGui

RTPGui is a lightweight random teleport plugin for Paper servers that provides a simple graphical menu for selecting teleport distances. It includes built-in cooldowns, tiered distance ranges, and administrator tools for managing player cooldowns.

---

Features

• Three configurable distance tiers (Random, Mid, Far)
• Simple in-game menu (/rtpgui)
• Per-player cooldowns
• Tier-based permissions
• Admin commands for reloading, resetting, and checking cooldowns
• Configurable teleport sound and range
• Works with Paper 1.20–1.21.8

---

Commands

| Command | Description | Permission |
|----------|-------------|-------------|
| /rtpgui | Opens the RTP selection menu | rtpgui.use |
| /rtp <tier> | Teleports using a preset tier (random, mid, far) | rtpgui.use |
| /rtpgui reload | Reloads configuration | rtpgui.admin |
| /rtpgui reset [player] | Resets cooldown for yourself or another player | rtpgui.admin |
| /rtpgui check [player] | Checks remaining cooldown for a player | rtpgui.admin |

---

Permissions

| Permission | Default | Description |
|-------------|----------|-------------|
| rtpgui.use | true | Allows use of the GUI and teleport commands |
| rtpgui.tier.mid | true | Grants access to the mid-range tier |
| rtpgui.tier.far | true | Grants access to the far-range tier |
| rtpgui.admin | op | Allows reload, reset, and check commands |

---

Configuration

Example config.yml:

world: "world"
cooldown-seconds: 15

sound:
  enabled: true
  key: "minecraft:entity.enderman.teleport"
  volume: 1.0
  pitch: 1.0

tiers:
  mid:
    display: "&b&l5,000 &7- &b25,000 &lBLOCKS"
    material: "SHULKER_SHELL"
    slot: 11
    min: 5000
    max: 25000
    permission: "rtpgui.tier.mid"
  random:
    display: "&b&lRANDOM"
    material: "ENDER_PEARL"
    slot: 13
    min: 0
    max: 75000
  far:
    display: "&b&l25,000 &7- &b50,000 &lBLOCKS"
    material: "ENDER_EYE"
    slot: 15
    min: 25000
    max: 50000
    permission: "rtpgui.tier.far"

gui:
  title: "&bRTP"
  size: 27
  filler: "BLACK_STAINED_GLASS_PANE"