ProTPA

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:

* Granular Permission System: * `/tpa <player>`: Request to teleport to another player. * `/tpahere <player>`: Request another player to teleport to your location. * Granular Permission System: * `/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. * Granular Permission System: * `/tpblock`: Toggle blocking all incoming teleport requests. * `/tpautoaccept`: Toggle automatically accepting all incoming teleport requests. * Granular Permission System: * `/back`: Teleport to your last death location with configurable warmup and cooldown timers. * Granular Permission System: * Granular Permission System: Set delays between sending teleport requests and using the back command. * Granular Permission System: Implement a countdown before teleportation occurs, adding strategic depth to both TPA and back commands. * Granular Permission System: Define how long a request remains pending before expiring. * Granular Permission System: * Granular Permission System: Option to cancel teleport warmup if the player moves. * Granular Permission System: Option to cancel teleport warmup if the player takes damage. * Granular Permission System: Prevent teleportation while a player is in combat (configurable duration). * Granular Permission System: Disable TPA and back functionality in specified worlds. * Granular Permission System: * 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:

* MiniMessage Formatting: 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. * MiniMessage Formatting: 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. * MiniMessage Formatting: Player preferences for blocking and auto-accepting requests are managed efficiently in memory for quick access. * MiniMessage Formatting: An effective system tags players during combat, integrating with safety features to prevent TPA exploits. * MiniMessage Formatting: 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:

* Comprehensive Permission Control: Apply changes from `config.yml` instantly with `/protpa reload` without needing a server restart. * Comprehensive Permission Control: `/protpa` or `/protpa help` provides a detailed list of available commands and their descriptions, tailored to the user's permissions. * Comprehensive Permission Control: 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.