Kroxy TPA icon

Kroxy TPA -----

Tpa, Kroxy Tpa plugin



KroxyTpa — Documentation

[HR][/HR]

Installation

  1. Download KroxyTpa.jar from the resource page
  2. Stop your server
  3. Place KroxyTpa.jar inside your /plugins folder
  4. Start your server
  5. Plugin will generate /plugins/KroxyTpa/config.yml automatically
  6. Edit config to your liking
  7. Run /kroxytpa reload — no restart needed!

Requirements
  • Minecraft 1.13+ (Spigot / Paper / Purpur / Bukkit)
  • Java 8+
  • LuckPerms (optional — for permission management)

[HR][/HR]

⚙️ config.yml — Full Documentation

— Prefixes

Code (Text):

prefix:            "&#FF0072&lᴋ&#FF0077&lʀ..."   # Plugin display name (shown in GUI titles)
chat-prefix:       "&#FF0072&lK&#FF0077&lR..."    # Prefix shown in chat messages
action-bar-prefix: "&#FF0072&lK&#FF0077&lR..."    # Prefix shown in action bar
separator:         "&8→"                           # Separator between prefix and message
 
Supports hex colors &#RRGGBB and legacy color codes &a &c &f etc.

[HR][/HR]

— Buttons

Code (Text):

buttons:
  action-prefix: "ACTION"    # Text shown left of Accept/Cancel/Deny buttons in chat
  accept: "✔ ACCEPT"         # Accept button text (supports hex colors)
  cancel: "✖ CANCEL"         # Cancel button text (supports hex colors)
  deny:   "✖ DENY"           # Deny button text (supports hex colors)
 
All buttons are clickable in chat — players click to run the command automatically.

[HR][/HR]

— Settings

Code (Text):

settings:
  countdown-seconds:      5      # Seconds before teleport happens (1-60)
  request-expire-seconds: 60     # How long a TPA request stays active (seconds)
  cancel-on-move:         true   # true = teleport cancels if player moves during countdown
  max-pending-requests:   5      # Max outgoing TPA requests per player at once
  sounds-enabled:         true   # true = enable all sounds, false = disable all sounds
  tpa-cooldown:           0      # Cooldown between TPA requests in seconds (0 = disabled)
 
Option Default Description
countdown-seconds 5 Seconds to wait before teleporting. Player must stay still.
request-expire-seconds 60 TPA request auto-expires after this many seconds if not accepted/denied.
cancel-on-move true If true, moving during countdown cancels the teleport and shows a big screen title.
max-pending-requests 5 Maximum number of outgoing TPA requests a player can have at once.
sounds-enabled true Enable or disable all sounds globally.
tpa-cooldown 0 Seconds between each TPA request send. Set 0 to disable cooldown.


[HR][/HR]

— Messages & Placeholders

All messages support color codes. Available placeholders:

Placeholder Replaced With
{player} The player who sent the request
{target} The player who received the request
{seconds} Countdown seconds remaining
{count} Number of players (used in /tpaall)
{time} Formatted cooldown time (e.g. 30s, 1m 20s)
{type} Request type — TPA or TPAHERE


Code (Text):

messages:
  # General
  plugin-disabled:       "&fTPA is currently &cdisabled &fby an admin."

  # TPA Request
  tpa-sent:              "&fTPA request sent to &f{target}&f."
  tpa-received:          "&f{player} &fwants to teleport &fto you."
  tpahere-sent:          "&fRequested &f{target} &fto come to you."
  tpahere-received:      "&f{player} &fis requesting you to teleport to them."

  # Accept / Deny / Cancel
  tpa-accepted-sender:   "&f{target} &faccepted your request. &c&lDon't move!"
  tpa-accepted-target:   "&fAccepted &f{player}&f's request. Teleporting in &c{seconds}s&f."
  tpa-teleported:        "&aTeleported &fsuccessfully &a✦"
  tpa-denied-sender:     "&f{target} &fdenied your TPA request."
  tpa-denied-target:     "&fYou denied &f{player}&f's request."
  tpa-cancelled-sender:  "&fYou cancelled your TPA request to &f{target}&f."
  tpa-cancelled-target:  "&f{player} &fcancelled their TPA request."
  tpa-cancelled-all:     "&fAll your pending TPA requests were cancelled."
  countdown-moved:       "&cTeleport cancelled &f— you moved!"

  # TPA All
  tpaall-sent:           "&fTPA requests sent to &f{count} &fplayer(s)."
  tpaall-received:       "&f{player} &fsent a server-wide TPA request."

  # TPA List
  tpalist-header:        "&fPending TPA Requests &8(&7yours&8)"
  tpalist-entry:         "  &8» &f{player} &8→ &f{target} &8[&7{type}&8]"
  tpalist-empty:         "&fYou have no pending TPA requests."

  # Cooldown
  tpa-cooldown:          "&cPlease wait &f{time} &cbefore sending another TPA request."

  # Ban
  tpaban-banned:         "&c&lYou have been &4&lTPA BANNED&c&l!"
  tpaban-cannot-use:     "&cYou cannot use any TPA commands while banned."

  # Titles (Big screen during countdown)
  title-main:             "KroxyTpa"              # Big title shown to teleporter
  title-subtitle:         "&7Don't Move — Teleporting in &c{seconds}s"
  title-complete:         "&#22FF00&l✦ &aTeleported! &#22FF00&l✦"
  title-complete-subtitle: "&fArrived at &f{target}"

  # Action Bar
  actionbar-countdown:   "&fTeleporting in &c{seconds}s"
  actionbar-complete:    "&aTeleported &f✦"
 
[HR][/HR]

Permission Setup (LuckPerms)

Give all TPA permissions to a group:
Code (Text):

/lp group default permission set kroxytpa.tpa true
/lp group default permission set kroxytpa.tpahere true
/lp group default permission set kroxytpa.tpaaccept true
/lp group default permission set kroxytpa.tpadeny true
/lp group default permission set kroxytpa.tpacancel true
/lp group default permission set kroxytpa.tpaall true
/lp group default permission set kroxytpa.tpalist true
 
Or give everything at once:
Code (Text):

/lp group default permission set kroxytpa.* true
 
Give admin permissions to a staff group:
Code (Text):

/lp group admin permission set kroxytpa.admin true
/lp group admin permission set kroxytpa.admin.ban true
/lp group admin permission set kroxytpa.bypass true
 
[HR][/HR]

TPA Ban System

Code (Text):

# Ban a player for 1 hour with reason
/tpaban Steve 1h Spamming TPA requests

# Ban for 30 minutes
/tpaban Steve 30m

# Ban permanently
/tpaban Steve 0

# Unban a player
/tpaban unban Steve

# View all active bans
/tpaban list
 
Time Formats:
Format Meaning
30s 30 seconds
10m 10 minutes
2h 2 hours
7d 7 days
0 Permanent ban


[HR][/HR]

❓ FAQ

Q: Plugin load nahi ho raha?
A: Make sure server version 1.13+ hai aur Java 8+ installed hai.​

Q: Buttons click karne pe kuch nahi ho raha?
A: Make sure player ke paas proper permissions hain (kroxytpa.tpaaccept etc.)​

Q: Config reload kaise karein bina restart ke?
A: /kroxytpa reload run karo — instant reload hoga.​

Q: Move cancel disable karna hai?
A: config.yml mein cancel-on-move: false karo.​

Q: TPA cooldown lagana hai?
A: config.yml mein tpa-cooldown: 30 (seconds mein) set karo.​

Q: Sounds disable karne hain?
A: config.yml mein sounds-enabled: false karo.​

[HR][/HR]


Made with ❤️ by Kroxy
www.kroxy.org
Resource Information
Author:
----------
Total Downloads: 10
First Release: Jun 4, 2026
Last Update: Jun 4, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings