EasyTPA

A full rewrite of EasyTPA with modern Paper API integration, asynchronous operations, and a cleaner architecture.

Note: Versions prior to 1.21.4 are no longer supported.

Commands & Messaging

• All commands now use Paper’s Brigadier API with improved tab completion
• Full MiniMessage support + legacy color codes
• PlaceholderAPI integration and interactive UI elements

Data & Teleporting

• SQLite storage with async operations and automatic cleanup
• Async teleporting with improved location capture and movement detection
• Enhanced safety checks for teleport destinations

Configuration

• Messages moved to messages.yml
• config.yml consolidated and simplified

Fixes & Changes

• Fixed world and player validation during async operations
• Internal API restructured - custom integrations must be updated

Migration Guide

1. Backup your data
2. Update config.yml
3. Migrate messages to messages.yml
4. Verify permissions
5. Test commands

1.21.10 Support

Added

• New Commands

  • /tpcancel - Cancel your pending teleport request or in-progress teleport
  • /tplist - List all your pending teleport requests (sent and received)

• Teleport Delay System

  • Configurable teleport delay before execution (default: 3 seconds)
  • Movement detection - teleport cancels if player moves during delay
  • Countdown messages showing remaining time
  • New permission easytpa.delay.bypass to bypass teleport delay
  • Set delay to 0 in config to disable

• Performance Improvements

  • All database operations now run asynchronously to prevent server lag
  • Thread-safe collections using ConcurrentHashMap
  • Automatic cleanup task for expired cooldowns

• Safety Features

  • Teleport safety checks before execution (prevents suffocation/void teleports)
  • Automatic cancellation if sender or target goes offline during delay

Changed

• Database operations are now asynchronous by default
• Improved message system with automatic fallback to defaults
• Better cooldown management with periodic cleanup

Fixed

• Fixed duplicate cooldown logic that could cause inconsistencies
• Fixed potential NullPointerException in database operations

Fixed a bug in TPAManager class.

TPAManager now correctly teleports to the target’s location at the time the request was sent, preventing unintended teleportation after moves or respawns.

• 1.21.9 Support
• Removed YAML data store support

• 1.21.5 Support
• MiniMessage support