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.