RTPGui v1.0.0 — Release Notes

Overview

RTPGui v1.0.0 is the initial public release of a lightweight random teleportation plugin for Paper servers.
It provides a configurable GUI menu for selecting teleport distances, cooldown management, and permission-based access to multiple teleport tiers.

New Features

1. Random Teleport GUI

• Added /rtpgui menu with three selectable teleport tiers:
  • Random — full map range teleport
  • Mid (5,000–25,000 blocks)
  • Far (25,000–50,000 blocks)
• Each tier can be customized in config.yml with item, slot, display name, and permission.

2. Command System

• /rtpgui: Opens the teleport menu.
• /rtp <tier>: Performs a quick teleport using a preset tier (e.g., /rtp random).
• /rtpgui reload: Reloads configuration without restarting the server.
• /rtpgui reset [player]: Clears teleport cooldown for the sender or a target player.
• /rtpgui check [player]: Displays remaining cooldown time for a player.

3. Cooldown Management

• Per-player cooldown system using in-memory tracking.
• Duration configurable via cooldown-seconds in the config.
• Cooldowns persist correctly across multiple uses in a session.

4. Admin Utilities

• Added rtpgui.admin permission to grant access to reload, reset, and check commands.
• Admins can manage other players’ cooldowns in real time.

5. Configuration System

• Fully reloaded with /rtpgui reload.
• Sound, pitch, and volume configurable under the sound section.
• Supports namespaced sound keys for Paper 1.21.3+ compatibility.
• Custom GUI filler material and title options.

6. Improved Tab Completion

• Autocomplete for /rtpgui reload, /rtpgui reset, /rtpgui check, and player names.
• Autocomplete for /rtp tier options (random, mid, far).

Configuration Example

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"