SmartTpa

SmartTPA

SmartTPA is a lightweight, high-performance teleportation plugin built for Bukkit, Spigot, PaperMC, Purpur, and Folia servers supporting Java and Bedrock Crossplay via GeyserMC and Floodgate. It delivers a native experience for both platforms: Java Edition players get interactive clickable chat buttons, while Bedrock Edition players and staff get native Cumulus GUI Form windows with 100% Mojangles pixel-safe symbols.

Key Features

• Native Bedrock Player & Admin GUI (Floodgate): Bedrock players simply type /tpa to open an interactive GUI menu (TPA to Player, TPA Here, Accept, Deny, Cancel, Toggle TPA, and Help). Staff members also get a dedicated Admin Teleport GUI button inside /tpa (or via /tpa admin).
• Clickable Chat Buttons (Java MiniMessage): Players receiving a teleport request can directly click the green [ + ACCEPT ] or red [ x DENY ] buttons in chat.
• Folia & Async Teleportation: Built with non-blocking ConcurrentHashMap structures, regional Folia schedulers, and asynchronous teleportation (teleportAsync) for optimal CPU performance.
• Vault Economy Integration: Charge in-game money when players use /tpa or /tpahere. Costs can be configured separately or set to 0 for free teleports.
• Separate Cooldowns & ActionBar Progress Bars: Configure independent cooldown timers for /tpa and /tpahere, complete with animated ActionBar progress bars for cooldowns and warmup countdowns.
• PlaceholderAPI (PAPI) Support: Includes built-in placeholders for scoreboards, tablists, and holograms.
• Customizable Sound Effects: Every teleportation action plays a configurable sound effect from config.yml.
• Multi-Language System: Out-of-the-box support for English (lang-en.yml - Default), Indonesian (lang-id.yml), and Malaysian (lang-my.yml).
• Wide Version Compatibility: Supports Minecraft 1.20.x up to 1.26.3+.

Player Commands

Command	Alias	Description
/tpa	-	Opens the interactive Teleport GUI Menu for Bedrock players.
/tpa <player>	-	Sends a request to teleport to another player.
/tpahere <player>	-	Requests another player to teleport to your location.
/tpaaccept	/tpaccept	Accepts an incoming teleport request.
/tpadeny	/tpdeny	Denies an incoming teleport request.
/tpacancel	-	Cancels your active outgoing teleport request.
/tpatoggle	-	Toggles whether you allow incoming TPA requests.
/tpa help	/tpahelp	Displays the command help guide for Java and Bedrock.
/tpa version	-	Displays plugin version and platform info.

Admin Commands

Command	Description
/tp <player> [target]	Instantly teleports you to a player (or teleports player A to B).
/tphere <player>	Instantly pulls an online player to your location.
/tphereall	Instantly pulls all online players to your location.
/tpo <player>	Teleports you to the last known (offline) location of a player.
/tpreload	Reloads config.yml and language files (also /tpa reload).
/tpdebug	Toggles console logging of TPA request lifecycle events.

Permissions

Permission	Default	Description
smarttpa.command.tpa	true	Allows using /tpa.
smarttpa.command.tpahere	true	Allows using /tpahere.
smarttpa.command.tpaccept	true	Allows using /tpaaccept.
smarttpa.command.tpdeny	true	Allows using /tpadeny.
smarttpa.command.tpacancel	true	Allows using /tpacancel.
smarttpa.command.tpatoggle	true	Allows using /tpatoggle.
smarttpa.command.help	true	Allows viewing /tpa help and /tpahelp.
smarttpa.command.version	true	Allows viewing /tpa version.
smarttpa.reload	OP	Allows reloading the plugin via /tpreload or /tpa reload.
smarttpa.debug	OP	Allows toggling debug logs via /tpdebug.
smarttpa.command.tpo	OP	Allows teleporting to offline player locations via /tpo.
smarttpa.command.tp	OP	Allows instant admin teleportation via /tp.
smarttpa.command.tphere	OP	Allows pulling a player via /tphere.
smarttpa.command.tphereall	OP	Allows pulling all players via /tphereall.
smarttpa.bypass.cooldown	OP	Bypasses TPA sending cooldowns and warmup countdowns.
smarttpa.bypass.toggle	OP	Allows sending TPA to players who disabled incoming requests.
smarttpa.bypass.cost	false	Bypasses Vault economy teleportation fees.

Placeholders

If PlaceholderAPI is installed, you can use the following placeholders:

• %smarttpa_toggle% - Shows Enabled or Disabled status for incoming TPA.
• %smarttpa_cooldown_tpa% - Remaining /tpa cooldown in seconds.
• %smarttpa_cooldown_tpahere% - Remaining /tpahere cooldown in seconds.
• %smarttpa_has_request% - Returns yes or no if the player has a pending request.
• %smarttpa_debug% - Shows ON or OFF status of console debug mode.
• %smarttpa_version% - Displays the active plugin version (1.0.2-3).

Files

When loaded, the plugin generates the following structure inside plugins/SmartTPA/:

• config.yml - Main configuration (Prefix, Language, Separate Cooldowns, Progress Bar, Economy, Sounds).
• userdata.yml - Stores last known player locations for /tpo.
• language/lang-en.yml - English language file (Default).
• language/lang-id.yml - Indonesian language file.
• language/lang-my.yml - Malaysian language file.

Dependencies

SmartTPA works standalone out of the box, and supports these optional soft-dependencies:

1. Floodgate - Required for native Bedrock GUI Forms.
2. Vault + an Economy Plugin (e.g., EssentialsX, CMI) - Required for teleportation fees.
3. PlaceholderAPI - Required for %smarttpa_...% placeholders.

Credits

• Lead Developer: RayaFebrian
• Development Team: Mr G, RayaFebrian, KusStore
• Current Version: 1.0.2-3 (Active Development Stage)