UltimateTPA+++

** UltimateTPA Plugin - Complete Summary

---

Overview

---

Description

UltimateTPA is an all-in-one teleportation plugin designed for modern Paper Minecraft servers. It combines three essential teleportation systems into a single, lightweight JAR file:

1. TPA System - Player-to-player teleport requests
2. RTP System - Random/Wild teleportation
3. DeathTP System - Return to death location

The plugin features a modern codebase using Java 21, full MiniMessage support for colorful and clickable chat components, and highly configurable settings including optional warmup timers that can be completely disabled for instant teleportation.

---

Primary Uses

---

Features

Module 1: TPA System (Teleport Requests)

Commands:

/tpa             - Open tpa GUI (only works for tpa)
/tpa <player>    - Send teleport request
/tpaccept        - Accept latest request
/tpdeny          - Deny latest request  
/tpacancel       - Cancel your sent request
/tpatoggle       - Toggle incoming requests on/off
/tpaauto         - Toggle auto-accept mode
/tpreload        - Reload configuration

---

Module 2: RTP System (Random Teleport / Wild)

Commands:

/wild              - Teleport to random location
/rtp               - Alias for /wild
/randomtp          - Alias for /wild
/wildrtp           - Alias for /wild
/wild info         - Show RTP settings for current world
/wild reload       - Reload configuration
/wild help         - Show help message
/customrtp <player> <world> <minR> <maxR> <x> <z>  - Admin RTP

Safety Checks - Avoids:

• Lava and fire
• Deep water
• Mid-air spawns
• Magma blocks
• Cacti and berry bushes
• Powder snow
• Campfires

---

Module 3: DeathTP System

Commands:

/dback       - Teleport to death location
/deathback   - Alias for /dback
/back        - Alias for /dback
/deathtp     - Alias for /dback

---

Configuration Highlights

Instant vs Delayed Teleportation

 INSTANT TELEPORTATION (No warmup)
tpa:
  warmup:
    enabled: false

rtp:
  warmup:
    enabled: false

 DELAYED TELEPORTATION (With warmup)
tpa:
  warmup:
    enabled: true
    seconds: 3
    cancel-on-move: true

rtp:
  warmup:
    enabled: true
    seconds: 5

Multi-World RTP Configuration

rtp:
  worlds:
    world:
      enabled: true
      min-radius: 100
      max-radius: 5000
      center-x: 0
      center-z: 0
      algorithm: CIRCLE
    
    world_nether:
      enabled: true
      min-radius: 50
      max-radius: 1000
      algorithm: CIRCLE
    
    world_the_end:
      enabled: false

MiniMessage Formatting

messages:
  prefix: "<gray>[<gradient:00ff88:00aaff>UltimateTPA</gradient>]</gray> "
  tpa:
    sent: "<green>TPA request sent to <white>{player}</white>."
    received: "<green>{player}</green> <yellow>wants to teleport to you!"
  click:
    accept: "<green><bold>[ACCEPT]</bold></green>"
    deny: "<red><bold>[DENY]</bold></red>"

---

Permissions

Player Permissions (Default: true)

Admin Permissions (Default: op)

Wildcard Permissions

---

Sound Effects

All sounds are fully configurable with custom volume and pitch.

 Design Patterns Used

| Pattern | Usage |
|---------|-------|
| **Singleton** | ConfigManager for global config access |
| **Manager Pattern** | Separate managers for each module |
| **Builder Pattern** | MiniMessage component building |
| **Observer Pattern** | Event listeners for game events |
| **Strategy Pattern** | RTP algorithms (CIRCLE/SQUARE) |

 Performance Optimizations

| Optimization | Description |
|--------------|-------------|
| **Async Chunk Loading** | RTP uses Paper's async chunk API |
| **Efficient Move Check** | Only checks block changes, ignores head rotation |
| **ConcurrentHashMap** | Thread-safe data structures |
| **Lazy Cleanup** | Expired requests cleaned periodically |
| **Minimal Memory** | In-memory storage with automatic cleanup |


---

 🚀 Quick Start Guide

 Installation

1. Download or build `UltimateTPA-1.0.0.jar`
2. Place in server's `plugins/` folder
3. Start/restart the server
4. Edit `plugins/UltimateTPA/config.yml` as needed
5. Run `/tpreload` or `/wild reload` to apply changes

 Recommended First Configuration

```yaml
 For most servers, start with these settings:

tpa:
  warmup:
    enabled: true       Prevent TP abuse
    seconds: 3
    cancel-on-move: true
  request-expiry: 60
  cooldown: 30

rtp:
  warmup:
    enabled: true
    seconds: 5
  cooldown: 120         2 minutes to prevent lag
  max-attempts: 15

deathtp:
  cancel-death-message: false   Keep vanilla death messages
  private-message: true         Add coordinates privately

For Instant Teleportation

 If you want no delays at all:

tpa:
  warmup:
    enabled: false
  cooldown: 10

rtp:
  warmup:
    enabled: false
  cooldown: 60

---

Comparison with Similar Plugins

---

License & Credits

• Plugin: UltimateTPA
• Version: 1.0.0
• Target: Paper 1.21.x
• Java: 21
• Dependencies: None (standalone)
• Soft Dependencies: Vault, LuckPerms (optional)

---

Support Checklist

Before reporting issues, verify:

• Server is running Paper 1.21.x
• Java 21 is installed
• Plugin JAR is in /plugins/ folder
• No errors in server console on startup
• Players have correct permissions
• Config syntax is valid YAML
• Ran /tpreload after config changes

---

UltimateTPA - The Ultimate Teleportation Solution for Modern Minecraft Servers **