Redcraft_TPA

Redcraft_TPA is a lightweight, configurable teleport-request plugin for Bukkit/Paper servers.

It provides modern TPA workflows with clickable chat actions, optional GUI flows, teleport warmup countdowns, and combat-safe cancellation behavior.

Features

• Send and receive teleport requests with /tpa and /tpahere
• Accept or deny requests with /tpaccept and /tpdeny
• Optional GUI support for sending and accepting requests
• Clickable [Accept] / [Deny] / [GUI] chat buttons with hover text
• Configurable request cooldown
• Configurable request timeout
• Configurable teleport delay with action-bar countdown
• Automatic teleport cancel on movement or damage
• Toggle incoming requests with /tptoggle
• OP/permission-based config reload with /tpa reload
• Full tab-completion for all core commands
• Adventure-powered colored chat and action-bar messages

Commands

Command	Description
/tpa <player>	Send a teleport-to-player request
/tpa gui	Open GUI to select a player and send TPA/TPAHERE
/tpahere <player>	Ask a player to teleport to you
/tpaccept	Accept your pending request
/tpaccept gui	Open accept GUI for your pending request
/tpdeny	Deny your pending request
/tptoggle	Enable/disable incoming teleport requests
/tpa reload	Reload plugin config (OP/permission)

Permissions

Permission	Default	Description
tpa.request	true	Allows /tpa and /tpahere
tpa.accept	true	Allows /tpaccept
tpa.deny	true	Allows /tpdeny
tpa.toggle	true	Allows /tptoggle
tpa.reload	op	Allows /tpa reload
tpa.bypass.cooldown	op	Bypass request cooldown
tpa.bypass.timeout	op	Bypass request timeout

Configuration

File: plugins/Redcraft_TPA/config.yml

cooldown: 10
timeout: 60
delay: 5
cancel-on-move: true
cancel-on-damage: true

Config options

• cooldown: Seconds between sending requests
• timeout: Seconds before a request expires
• delay: Teleport warmup in seconds after acceptance
• cancel-on-move: Cancel delayed teleport if the traveler moves
• cancel-on-damage: Cancel delayed teleport if the traveler takes damage

GUI Details

Send GUI

• Opens with /tpa (without arguments) or /tpa gui
• Shows online players as heads
• Left click sends /tpa <player>
• Right click sends /tpahere <player>

Accept GUI

• Opens with /tpaccept gui
• Shows the requester head
• Shows a grass block named after destination world
• Includes accept/deny buttons

Teleport Safety Flow

1. Sender creates request
2. Target accepts (/tpaccept or GUI)
3. Traveler enters warmup delay with action-bar countdown
4. If movement or damage occurs (based on config), teleport is canceled
5. If uninterrupted, teleport completes

Requirements

• API 1.20+ recommended
• Built against Paper 1.21 API
• Java 21

Why Redcraft_TPA

Redcraft_TPA is designed for survival and SMP servers that want a clean teleport-request system without unnecessary complexity:

• Easy to configure
• Lightweight runtime behavior
• Safer teleports for PvP and combat situations
• Friendly UX with clickable actions and GUI support