Sueta

[UNMAINTAINED] AxTpa - TPA Plugin with Multi-Server Support

1.2.9-BETA

TPA plugin with GUI, combat detection, multi-server support, and full customization

·Plugin
DescriptionUpdates3Version history3AddonsDiscussionReviews

AxTpa
Advanced TPA Plugin

Professional Teleport Ask plugin for Minecraft 1.20.1
GUI • Combat Detection • Multi-Server Support • Full Customization

✨ Core Features
  • ✅ Complete TPA command system ( 
    /tpa
    , 
    /tpahere
    , 
    /tpaccept
    , 
    /tpdeny
    , etc.)
  • ✅ Interactive GUI with player information display
  • ✅ Combat detection - Prevents TPA during PvP
  • ✅ Trap detection - Detects flying and void positions
  • ✅ Configurable countdown with Titles/ActionBar support
  • ✅ Movement detection - Cancels teleport if player moves
  • ✅ Player blocking system - Block unwanted TPA requests
  • ✅ Auto-accept TPA - Automatically accept TPA requests
Multi-Server Support
  • ✅ BungeeCord support - TPA between servers
  • ✅ Velocity support - TPA between servers
  • ✅ Cross-server messaging system
Database Support
  • ✅ H2 - Default, file-based database
  • ✅ SQLite - Recommended for production
  • ✅ MySQL - Recommended for multi-server setups
Customization Features
  • ✅ Fully configurable GUI - Customize materials, colors, positions
  • ✅ Clickable chat buttons - Interactive messages with accept/deny buttons
  • ✅ Customizable messages - All messages editable in config
  • ✅ Sound effects - Configurable sounds for all actions
  • ✅ Titles & ActionBar - Visual countdown display
  • ✅ PlaceholderAPI integration - Dynamic placeholders
Security & Safety
  • ️ Combat protection - Prevents TPA during combat
  • ️ Trap detection - Warns about void and flying positions
  • ️ Movement cancellation - Prevents teleport abuse
  • ️ Player blocking - Block unwanted players
  • ️ Cooldown system - Prevent spam
  • ️ World restrictions - Block TPA in specific worlds

Commands

Command
Description
Permission 
/tpa <player>
Request teleport to a player 
axtpa.use
/tpahere <player>
Request player to come to you 
axtpa.use
/tpaccept [player]
Accept a TPA request 
axtpa.use
/tpdeny [player]
Deny a TPA request 
axtpa.use
/tpacancel
Cancel your pending request 
axtpa.use
/tpalist
List pending requests 
axtpa.use
/tpatoggle
Toggle TPA requests on/off 
axtpa.use
/tpablock <player>
Block a player 
axtpa.use
/tpaunblock <player>
Unblock a player 
axtpa.use
/tpalistblocked
List blocked players 
axtpa.use
/tpaauto
Toggle auto-accept 
axtpa.use
/axtpareload
Reload plugin configuration 
axtpa.reload

Interactive GUI Demo
Interactive GUI with player information, accept/deny buttons, and customizable design

Installation

Requirements
  • Minecraft: 1.20.1
  • Server: Paper (recommended), Spigot, or compatible fork
  • Java: 17 or higher
  • Dependencies: Automatically downloaded by Paper on first load
  1. Download the latest JAR from this page
  2. Place it in your server's 
    plugins/
    folder
  3. Restart your server (Paper will automatically download required libraries)
  4. Configure the plugin in 
    plugins/AxTpa/config.yml

Video Demo: Complete TPA Flow
Complete TPA request flow demonstration - Player A sends TPA → Player B accepts → GUI appears → Countdown → Teleport

YouTube

⚙️ Configuration

The plugin comes with a comprehensive 

config.yml

file with all customizable options:

Customization Options
  • Messages: All messages editable with color codes
  • GUI: Fully customizable GUI appearance (materials, colors, positions)
  • Database: H2, SQLite, or MySQL support
  • Timers: Cooldown, timeout, teleport delay (all configurable)
  • Sounds: Customizable sound effects for all actions
  • Titles/ActionBar: Visual countdown display options
Example Configuration 
database:
  type: SQLITE  # or H2, MYSQL

tpa:
  cooldown: 30  # seconds
  timeout: 60   # seconds
  teleport-delay: 5  # seconds
  check-combat: true

gui:
  enabled-tpa: true
  enabled-tpahere: true
  accept-button-material: "EMERALD_BLOCK"
  deny-button-material: "REDSTONE_BLOCK"

How It Works

TPA Flow
  1. Player A sends 
    /tpa PlayerB
  2. Player B receives notification (chat message with clickable buttons or GUI)
  3. Player B accepts with 
    /tpaccept
    (or via GUI)
  4. Player A receives GUI with destination information (flying, void, world)
  5. Player A confirms teleport via GUI
  6. 5-second countdown begins (configurable)
  7. Teleport executes if player doesn't move
TPAHere Flow
  1. Player A sends 
    /tpahere PlayerB
  2. Player B receives GUI with requester information
  3. Player B accepts or denies via GUI
  4. If accepted, countdown begins
  5. Player B teleports to Player A

Performance

Performance Stats
  • JAR Size: ~60KB (ultra lightweight)
  • Memory: Optimized for 50-500+ concurrent players
  • Leak-Free: Proper cleanup on player disconnect
  • Database: Optimized queries with indexes

PlaceholderAPI

If PlaceholderAPI is installed, the following placeholders are available:

Available Placeholders 
  • %axtpa_pending_requests%
    - Number of pending requests
  • %axtpa_toggle_status%
    - Toggle status (enabled/disabled)
  • %axtpa_auto_accept_status%
    - Auto-accept status
BungeeCord Setup
  1. Install AxTpa on all Spigot/Paper servers
  2. Configure database (MySQL recommended for multi-server)
  3. Enable messaging in 
    config.yml
    :

messaging:
  enabled: true
  channel: "axtpa:main"
Velocity Setup
  1. Install AxTpa on all servers
  2. Configure database (MySQL recommended)
  3. Enable messaging in 
    config.yml
  4. Velocity automatically handles plugin channels

IMAGEN 6: Multi-Server Setup (opcional)
Diagrama o screenshot del setup multi-servidor

Permissions

Permission List 
  • axtpa.*
    - All permissions (OP by default)
  • axtpa.use
    - Basic permission to use TPA commands (all by default)
  • axtpa.admin
    - Administrative permissions (OP by default)
  • axtpa.bypass.*
    - Bypass various restrictions (OP by default)
  • axtpa.reload
    - Reload configuration (OP by default)

Troubleshooting

Libraries Not Loading
  • Solution: Use Paper server (recommended). Paper automatically downloads libraries.
  • Alternative: Manually download libraries to 
    server/lib/
    folder
Database Connection Issues
  • MySQL: Check credentials and ensure MySQL server is running
  • SQLite: Check file permissions
  • H2: Check file permissions
TPA Not Working
  1. Check player permissions
  2. Verify database connection
  3. Check console for errors
  4. Ensure players are not in combat
  5. Verify cooldown has expired

⭐ Reviews & Feedback

If you enjoy this plugin, please leave a review! Your feedback helps improve the plugin.

Plugin Information
License: This plugin was developed for AXTrial Space.

Author: Axxtrial





FUND BUG OR ISSUE? REPORT IT
https://discord.gg/8tkpvhPGSC

Similar projects

Plugin →

Let Me Despawn

Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.

25MSueta

JourneyMap

Real-time map used for mapping in-game or your browser as you explore.

14.7MSueta

Emotecraft

Create your own emotes in Minecraft.

7.5MSueta

Simple Tpa

A simple tpa plugin which sends requests

5.4MSueta

Common Network

Forge and Fabric Unified Networking Solution

3.9MSueta

Set Home

A lightweight plugin for players to set their homes.

3.8MSueta