KroxyTpa — Documentation
[HR][/HR]
Installation
- Download KroxyTpa.jar from the resource page
- Stop your server
- Place KroxyTpa.jar inside your /plugins folder
- Start your server
- Plugin will generate /plugins/KroxyTpa/config.yml automatically
- Edit config to your liking
- 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)
| 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:
| {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: "FF00&l✦ &aTeleported! FF00&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:
| 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]