ProTPA - Advanced Player Teleportation Management

ProTPA is a PaperMC/Folia (including its forks) server plugin designed to provide a lightweight yet advanced, configurable, and user-friendly teleportation request system. Built with modern PaperMC APIs, it offers robust control over TPA mechanics, ensuring a seamless experience for both players and administrators.

Key Features:

ProTPA enhances server gameplay with a sophisticated set of teleportation tools:

Versatile Teleportation Requests:
- /tpa <player>: Request to teleport to another player.
- /tpahere <player>: Request another player to teleport to your location.
Full Request Lifecycle Management:
- /tpaccept [player]: Accept an incoming teleport request. If multiple requests are pending, optionally specify which player's request to accept.
- /tpdeny: Deny all teleport requests.
- /tpcancel: Cancel your outgoing teleport request.
- /tplist: View your pending incoming and outgoing teleport requests.
Player-Specific Preferences:
- /tpblock: Toggle blocking all incoming teleport requests.
- /tpautoaccept: Toggle automatically accepting all incoming teleport requests.
Death Location Recovery:
- /back: Teleport to your last death location with configurable warmup and cooldown timers.
Configurable Timers & Delays:
- Cooldowns: Set delays between sending teleport requests and using the back command.
- Warmups: Implement a countdown before teleportation occurs, adding strategic depth to both TPA and back commands.
- Request Timeouts: Define how long a request remains pending before expiring.
Enhanced Safety & Gameplay Mechanics:
- Cancel on Move: Option to cancel teleport warmup if the player moves.
- Cancel on Damage: Option to cancel teleport warmup if the player takes damage.
- Combat Protection: Prevent teleportation while a player is in combat (configurable duration).
- World Blacklisting: Disable TPA and back functionality in specified worlds.
Rich Notifications & Feedback:
- Customizable in-game messages using MiniMessage for colors and formatting.
- Optional sound effects for sending, receiving, and accepting requests.
- Optional particle effects for visual feedback on teleportation actions.
Granular Permission System:
- Detailed permissions for every command and feature (e.g., protpa.tpa, protpa.accept, protpa.back, protpa.tplist).
- Bypass permissions for cooldowns, warmups, timeouts, and sending to blocked players (protpa.bypass.*).
- Admin permissions for plugin management (protpa.admin, protpa.admin.reload).
- Includes a protpa.* wildcard permission for full access.

Technical Details:

ProTPA is lightweight yet advanced, built for modern server environments:

PaperMC & Folia API Integration: Utilizes advanced APIs, including LifecycleEvents for command registration, the Brigadier command framework, AsyncScheduler for non-blocking tasks (like warmups and timeouts), and GlobalRegionScheduler for safe, main-thread teleportations.
Extensive Configuration: A well-commented config.yml allows server owners to fine-tune nearly every aspect, including all timers, safety features, combat settings, notification settings (sounds, particles), back command settings, and customize all plugin messages via MiniMessage.
Efficient User Data Handling: Player preferences for blocking and auto-accepting requests are managed efficiently in memory for quick access.
Dynamic Combat Management: An effective system tags players during combat, integrating with safety features to prevent TPA exploits.
Death Location Tracking: Automatically tracks and stores each player's last death location for the back command functionality.
MiniMessage Formatting: All user-facing messages support the powerful MiniMessage format, allowing for rich and engaging text.

Administrative Features:

Administrators have robust tools to manage ProTPA:

Live Configuration Reload: Apply changes from config.yml instantly with /protpa reload without needing a server restart.
In-Game Help Command: /protpa or /protpa help provides a detailed list of available commands and their descriptions, tailored to the user's permissions.
Bypass Capabilities: OP-level permissions allow administrators to override standard TPA restrictions when necessary.
Comprehensive Permission Control: Define precisely who can use which features of the plugin.

Perfect For:

Servers seeking a lightweight yet advanced TPA system with robust configuration and death recovery features.
Communities that value player-driven teleportation with customizable rules and safety nets.
Networks looking to offer varied teleportation experiences (e.g., faster teleports for donors via bypass permissions).
Server owners who demand fine-grained control over teleportation mechanics to suit their server's specific gameplay style.
Servers wanting to provide players with convenient death recovery options while maintaining balanced gameplay.

ProTPA, by BloodRed, combines powerful functionality with ease of use, delivering a polished and professional teleportation solution for your Minecraft server. It is designed for performance and leverages modern Minecraft server technologies to ensure stability and compatibility.