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

Admin Commands

Permissions

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)