Minecraft plugin SimpleTpa

🔌 About SimpleTPA

SimpleTPA is a Minecraft plugin that provides a simple teleport-request (TPA) system for servers. It enables players to send teleport requests to other players, accept or deny incoming requests, cancel outgoing requests, and block incoming requests with a toggle. The plugin focuses on a compact, configurable workflow for in-game teleport requests and server-side configuration.

🎯 Purpose

SimpleTPA solves the common need for controlled player-to-player teleportation on multiplayer servers. It prevents spam through cooldowns and single-pending-request rules, supports warmup/delay before teleportation, and gives server administrators configurable behavior for timeouts, sounds, and logging.

⚙️ Features

• Player-to-player teleport requests via /tpa and reverse requests via /tpahere.
• Accept, deny, and cancel request actions (/tpaccept, /tpdeny, /tpacancel).
• Toggle receiving requests on or off with /tpatoggle.
• Configurable request timeout (default shown as 60 seconds).
• Configurable cooldown between sending requests to reduce spam.
• Teleport warmup/delay with action-bar countdown and cancellation on movement or damage.
• Only one pending request per player to avoid overlapping requests.
• Customizable sound effects for request, accept, deny, and successful teleportation.
• Full color code support for messages and detailed logging options for admins.

🧩 Who It Is For

• Small and medium Survival/SMP servers that want a lightweight TPA system.
• Servers that prefer minimal, configurable teleport-request behavior rather than a larger teleportation suite.
• Administrators who want per-server configuration for cooldowns, warmups, and logging.

🏗️ Example Use Cases

• A player uses /tpa to request teleportation to a friend; the friend accepts with /tpaccept and the plugin applies a configured warmup before teleporting.
• Server staff enable /tpatoggle for staff members to block random teleport requests during events or moderation tasks.
• Admins set a cooldown to prevent players from spamming teleport requests.

⌨️ Commands

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the plugin JAR from the plugin's official resource page.
• Place the downloaded .jar into your server plugins/ directory for a Spigot server.
• Restart the server and check the server console for plugin load messages.

📦 Dependencies

• No required dependencies are documented.

🧾 Configuration

• The plugin uses a configuration file (noted as config.yml on the plugin resource). When upgrading across major versions the author recommends removing the existing config.yml before restarting so new default keys are applied.
• Configuration options exposed include request timeout, cooldowns, teleport warmup, movement/damage cancellation, sound settings, message color codes, and logging options.

🧠 Technical Notes

• Confirmed supported Minecraft versions (as listed by the plugin resource): 1.19, 1.20, 1.20.6, and 1.21.
• Platform confirmed: Spigot.
• The plugin implements server-side timeouts, cooldowns, and warmup mechanics and performs automatic cleanup of expired requests.

🤝 When This Plugin Is Useful

SimpleTPA is useful when you need a focused, configurable teleport-request system without adding a full teleportation/homes suite. It fits servers that want straightforward /tpa workflows, cooldowns to prevent spam, and warmup behavior for safer teleports.