Redcraft-TPA

# 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 `` / `` / `` 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` ```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