
🚀 TPA Plugin - Professional Teleportation System 🎯 What Makes This Plugin Special? This isn't just another basic TPA plugin - it's a fully-featured teleportation system designed with both player experience and server administration in mind. ✨ Key Advantages 🎨 Complete Customization
- Every message is customizable - no hardcoded text
- Full color support with & codes
- All sounds configurable with volume and pitch control
- Change the plugin's entire personality without touching code
⏱️ Triple Cooldown System Most plugins have one cooldown. We have three independent types:
- TPA Cooldown - Prevents spam requests (30s)
- Teleport Cooldown - Limits actual teleportation (60s) -Request Expiration - Auto-denies old requests (60s)
Why? Prevent spam while allowing reasonable teleport frequency. Players can send requests every 30s but only teleport every 60s - perfect for survival servers! 🎮 Combat-Ready Features
- Configurable delay before teleport (great for PvP)
- Movement detection that cancels teleportation
- Smart detection: looking around is OK, moving isn't
- Countdown timer with sound effects
- Prevents combat teleport exploitation
🖱️ Interactive Chat Buttons
- Click to accept/deny - no typing needed
- Hover tooltips for clarity
- Fully compatible with 1.21+
🎪 Cool Features 💡 Smart Cooldown Tracking The plugin separates request cooldown from teleport cooldown:
- Send request → 30s cooldown on sending
- Teleport happens → 60s cooldown on teleporting
- Can send new request after 30s, but can't teleport for 60s
Prevents both spam AND teleport abuse simultaneously! 🚫 Intelligent Movement Detection
- Looking around? ✅ Teleport continues
- Moving mouse? ✅ Teleport continues
- Taking a step? ❌ Cancelled
- Jumping? ❌ Cancelled
Checks actual position (X,Y,Z), not just camera rotation. ⚡ Zero-Delay Mode Set delay: 0 for instant teleportation:
- Perfect for creative servers
- Great for staff members
- Ideal for hub/lobby servers
🎵 Progressive Sound Feedback Every action has unique sounds:
- Request sent → Experience orb (satisfying!)
- Request received → Note block pling (attention!)
- Countdown → Bell every second (tension!)
- Success → Enderman teleport (perfect!)
- Cancelled → Glass break (oops!)
🔄 Hot-Reload Support /tpareload changes config without restart:
- Update messages on the fly
- Change cooldowns instantly
- No server downtime needed
🔥 Performance & Security
- Fast: HashMap lookups (O(1))
- Memory efficient: Uses UUIDs, automatic cleanup
- Safe: Full error handling, no crashes
- Secure: Permission system, abuse prevention
- Smart: Validates everything before teleporting
🛡️ Built-In Safety
- Can't teleport to yourself
- Constant online status checks
- Request expiration prevents exploits
- Cooldowns prevent abuse
- Movement cancels combat escapes
🎭 Flexibility Dramatic 10-second teleport:
yamldelay: 10
show-countdown: true
cancel-on-move: true
Instant but spam-protected:
yamldelay: 0
tpa-cooldown: 120
Silent mode:
Set all sounds to enabled: false
Perfect for: Survival servers needing safety, PvP servers requiring combat awareness, Creative servers wanting speed, or any server wanting professional polish. Bottom line: A complete teleportation experience system that respects both player convenience and server integrity. 🚀
