🚀 NClickTPA - The Ultimate Teleport Solution

NClickTPA is a lightweight, professional, and feature-packed teleportation request system designed for modern Minecraft servers. Whether your players are on Java Edition or joining via Geyser/Floodgate (Bedrock), this plugin ensures a seamless experience for everyone.
Stop using outdated TPA plugins. Upgrade to NClickTPA for interactive chat buttons, beautiful visual countdowns, and full RGB color support.

✨ Key Features

📱 Cross-Platform Intelligence

• Java Players: Receive interactive [ACCEPT] and [DENY] buttons in chat for instant actions.
• Bedrock/Floodgate Players: Automatically detects Bedrock clients and sends simplified, easy-to-type instructions (/tpaccept) to avoid chat formatting issues.

⏳ Immersive TeleportationVisual

• Countdowns: Display the teleport timer using BossBars, Titles, and the Actionbar simultaneously.
• Cancel on Move: Prevents players from escaping combat by cancelling the teleport if they move.
• Sound Effects: Fully customizable sounds for requests sent, received, teleporting, and errors.

🎨 Stunning Customization

• Hex/RGB Color Support: Use gradients and modern color codes (e.g., <#ff0000>, gradient:red:blue) in all messages.
• 100% Configurable: Edit every message, sound, and setting to fit your server's theme.

🛠️ Commands & Permissions

Command	Permission	Description
/tpa	None	Send a teleport request to a player.
/tpaccept	None	Accept a pending request.
/tpdeny	None	Deny a pending request.
/nclicktpa reload	nclicktpa.admin.reload	Reload all configuration files.

Bypass Permission: nclick.tpa.bypass - Allows players (like VIPs or Staff) to skip the teleport warmup delay instantly.

📸 Gallery

⚙️ Configuration

The plugin generates three easy-to-use files. Click below to see the default configurations.

📂 config.yml (Click to view)

settings:
  # The time (in seconds) a player has to accept/deny.
  request-expire: 120

  # Cooldown between requests to prevent spam.
  cooldown: 10

  # Teleport warmup delay.
  teleport-delay: 5

  # Cancel teleport if player moves?
  cancel-on-move: true

  # Visual elements for the countdown
  countdown:
    use-chat: false
    use-title: true
    use-actionbar: true
    use-bossbar: true

🔊 sounds.yml (Click to view)

sounds:
  request-sent: "ENTITY_EXPERIENCE_ORB_PICKUP;1.0;1.0"
  request-received: "BLOCK_NOTE_BLOCK_PLING;1.0;2.0"
  teleport-start: "UI_BUTTON_CLICK;1.0;1.0"
  teleport-complete: "ENTITY_ENDERMAN_TELEPORT;1.0;1.0"
  teleport-cancelled: "BLOCK_ANVIL_LAND;0.5;0.5"

💬 messages.yml (Click to view)

# -----------------------------------------------------------------------------
# NClickTPA - Messages Configuration
# -----------------------------------------------------------------------------

prefix: "<gray>[<gradient:#42f56c:#00ff80><bold>NClickTPA</bold></gradient><gray>] <reset>"

errors:
  only-players: "<#ff5555>ᴏɴʟʏ ᴘʟᴀʏᴇʀs ᴄᴀɴ ᴜsᴇ ᴛʜɪs ᴄᴏᴍᴍᴀɴᴅ."
  player-offline: "<#ff5555>ᴛʜᴀᴛ ᴘʟᴀʏᴇʀ ɪs ɴᴏᴛ ᴏɴʟɪɴᴇ."
  self-tpa: "<#ff5555>ʏᴏᴜ ᴄᴀɴɴᴏᴛ sᴇɴᴅ ᴀ ᴛᴘᴀ ʀᴇǫᴜᴇsᴛ ᴛᴏ ʏᴏᴜʀsᴇʟғ."
  no-request: "<#ff5555>ʏᴏᴜ ʜᴀᴠᴇ ɴᴏ ᴘᴇɴᴅɪɴɢ ʀᴇǫᴜᴇsᴛs."
  request-expired: "<#ff5555>ᴛʜᴇ ʀᴇǫᴜᴇsᴛ ʜᴀs ᴇxᴘɪʀᴇᴅ."
  usage: "<#ff5555>ᴜsᴀɢᴇ: <gray>/tpa <player>"
  cooldown: "<#ff5555>ʏᴏᴜ ᴍᴜsᴛ ᴡᴀɪᴛ <#ffaa00>%time% <#ff5555>sᴇᴄᴏɴᴅs."
  no-permission: "<#ff5555>ʏᴏᴜ ᴅᴏ ɴᴏᴛ ʜᴀᴠᴇ ᴘᴇʀᴍɪssɪᴏɴ."
  moved: "<#ff5555>ʏᴏᴜ ᴍᴏᴠᴇᴅ! <bold>ᴛᴇʟᴇᴘᴏʀᴛ ᴄᴀɴᴄᴇʟʟᴇᴅ.</bold>"

success:
  request-sent: "<#aaffaa>ʀᴇǫᴜᴇsᴛ sᴇɴᴛ ᴛᴏ <#ffffff>%target%<#aaffaa>!"
  request-denied: "<#ff5555>ʏᴏᴜ ᴅᴇɴɪᴇᴅ ᴛʜᴇ ʀᴇǫᴜᴇsᴛ."
  request-denied-target: "<#ff5555>%player% ᴅᴇɴɪᴇᴅ ʏᴏᴜʀ ʀᴇǫᴜᴇsᴛ."
  request-accepted: "<#aaffaa>ʏᴏᴜ ᴀᴄᴄᴇᴘᴛᴇᴅ <#ffffff>%player%<#aaffaa>'s ʀᴇǫᴜᴇsᴛ."
  reload: "<#aaffaa>ᴄᴏɴғɪɢᴜʀᴀᴛɪᴏɴ ʀᴇʟᴏᴀᴅᴇᴅ sᴜᴄᴄᴇssғᴜʟʟʏ!"

  # Visual Countdown Effects
  teleport-start:
    chat: "<gray>ᴛᴇʟᴇᴘᴏʀᴛɪɴɢ ɪɴ <#aaffaa>%time% <gray>sᴇᴄᴏɴᴅs... <#ff5555>ᴅᴏ ɴᴏᴛ ᴍᴏᴠᴇ!"
    # Title Format: TITLE;SUBTITLE
    title: "<gradient:#42f56c:#00ff80><bold>ᴘʀᴇᴘᴀʀɪɴɢ ᴛᴘᴀ</bold></gradient>;<gray>ᴡᴀɪᴛ <#ffff55>%time% <gray>sᴇᴄᴏɴᴅs..."
    actionbar: "<#aaffaa>⏳ ᴘʀᴏᴄᴇssɪɴɢ ᴛᴇʟᴇᴘᴏʀᴛ..."
    # BossBar Colors: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
    bossbar:
      text: "<#ffffff>ᴛᴇʟᴇᴘᴏʀᴛɪɴɢ ɪɴ <#aaffaa>%time%s"
      color: "GREEN"

  # When teleport is done
  teleport-complete:
    chat: "<#aaffaa><bold>ᴛᴇʟᴇᴘᴏʀᴛᴇᴅ sᴜᴄᴄᴇssғᴜʟʟʏ!</bold>"
    title: "<gradient:#42f56c:#00ff80><bold>ᴀʀʀɪᴠᴇᴅ!</bold></gradient>;<gray>ᴡᴇʟᴄᴏᴍᴇ"
    actionbar: "<#aaffaa>✔ ᴛᴇʟᴇᴘᴏʀᴛ ᴄᴏᴍᴘʟᴇᴛᴇᴅ"

# Special Messages for Bedrock/Java
tpa-request:
  header: "<dark_gray><strikethrough>--------------------------------</strikethrough>"
  target-msg: "<gray>ᴘʟᴀʏᴇʀ <#ffff55>%player% <gray>ᴡᴀɴᴛs ᴛᴏ ᴛᴇʟᴇᴘᴏʀᴛ ᴛᴏ ʏᴏᴜ."

  # Simple message for Bedrock (Mobile/Console)
  bedrock:
    accept: "<green>ᴛʏᴘᴇ: /tpaccept"
    deny: "<red>ᴛʏᴘᴇ: /tpdeny"

  # Interactive Buttons for Java (PC)
  java:
    accept-btn: "<dark_gray>[<green><bold>✔ ᴀᴄᴄᴇᴘᴛ</bold><dark_gray>]   "
    accept-hover: "<gray>ᴄʟɪᴄᴋ ᴛᴏ ᴀᴄᴄᴇᴘᴛ"
    deny-btn: "<dark_gray>[<red><bold>✖ ᴅᴇɴʏ</bold><dark_gray>]"
    deny-hover: "<gray>ᴄʟɪᴄᴋ ᴛᴏ ᴅᴇɴʏ"

📥 Installation

• Download NClickTPA.jar.
• Drop it into your server's plugins folder.
• Restart your server.
• (Optional) If using Geyser, ensure Floodgate is installed for Bedrock auto-detection.