TPAExtension

# **TPA Extension** Java Inventory GUI and Native Bedrock Forms for Essentials Teleport Requests **Language notice:** The SpigotMC resource page, documentation and support channel are English-only. Chinese-language support is not provided on SpigotMC. ### **About TPA Extension** TPA Extension is a lightweight user-interface layer for Essentials teleport requests on Paper 26.2. Java Edition players receive a chest-style online-player selector and clickable chat actions. Bedrock Edition players connected through Floodgate receive native player-selection, response and cancellation forms. Essentials remains responsible for permissions, cooldowns, teleport delays, ignored players and the final teleport. TPA Extension does not replace or bypass the Essentials teleport system. ### **Compatibility** * **Server software:** Paper 26.2 only * **Plugin bytecode:** Java 21; run the Java version required by your Paper 26.2 server * **Required dependency:** EssentialsX, registered as `Essentials` * **Optional dependency:** Floodgate 2.x for native Bedrock forms * **Optional integration:** QuickMenu is not required; only the default configurable back-button command references it * **Server testing:** Java and Bedrock request flows were successfully tested on a live Paper 26.2 server * Spigot server compatibility has not been tested and is not claimed ### **Free Resource** TPA Extension is published as a **free resource at US**free resource at US$0.00**.00**. It is a focused open-source integration released under the MIT License, has no activation system or paid service, and its source code and release binaries are publicly available on GitHub. Free distribution matches the project's scope and keeps installation accessible to Paper server owners. ### **Main Features** * 54-slot Java inventory GUI with 45 player slots * Online-player heads with Java or Bedrock edition indicators * Player-name filtering, pagination and list refresh * Configurable Java GUI footer buttons, materials, names, lore and actions * Native Floodgate player-selection and search forms for Bedrock players * Clickable Java accept, deny and cancel actions * Native Bedrock accept, deny and cancel forms * Automatic closing of the Bedrock sender's cancellation form after acceptance, denial or tracked-request expiry * Enhancement of manually entered Essentials `/tpa` and `/tpahere` requests * Independent in-memory tracking for concurrent requester/target pairs * Automatic cleanup when a player disconnects or a tracked request expires ### **Teleport Authority and Security** All teleport commands run as the player who selected the action. TPA Extension never grants permissions, executes the teleport as console, or bypasses Essentials restrictions. Essentials remains the authority for command permission checks, cooldowns, request blocking, teleport warm-up and final movement. ### **Request State and Privacy** Tracked request state contains only requester UUID, target UUID, request type and creation time. It is held in server memory for the active request, is removed on response, cancellation, disconnect or expiry, and is never written to disk. The plugin has no analytics, network telemetry, account system or database. ### **Economy and Transactions** TPA Extension has no economy, shop, payment, trade or item-transfer feature. It does not integrate with Vault and never handles currency or player inventory transactions. ### **Dependencies** * **EssentialsX:** required. The plugin disables itself if `Essentials` is unavailable. * **Floodgate:** optional. Without it, Java functionality remains available but native Bedrock forms are disabled. * **Geyser:** normally used with Floodgate to connect Bedrock clients; it is not declared as a direct plugin dependency. * **QuickMenu:** optional. Replace the default `quickmenu open` back-button action if your server uses another menu plugin. ### **Links** * [Source Code and README](https://github.com/yangzijian52/tpa-extension) * [GitHub Releases](https://github.com/yangzijian52/tpa-extension/releases) * [Bug Reports and Support](https://github.com/yangzijian52/tpa-extension/issues) * [Complete Documentation](https://github.com/yangzijian52/tpa-extension/blob/main/docs/spigotmc-resource-bbcode.txt) ### **Important Notes** * The GUI player selector sends `/tpa`. Manual `/tpahere` commands receive the additional response UI, but the GUI does not provide a TPAHere selector. * The plugin adds UI around Essentials messages; it does not suppress Essentials chat output. * Only canonical `/tpa`, `/tpahere`, `/tpaccept`, `/tpdeny` and `/tpacancel` command names are observed for manual-command UI tracking. * The plugin tracks requests for approximately 30 seconds for UI cleanup. Essentials may use its own separately configured request duration. * Do not use Bukkit `/reload`. Restart the server after plugin or configuration changes. * Existing server `config.yml` files are not overwritten during upgrades. * The SpigotMC resource page, documentation and support channel are English-only. Chinese-language support is not provided on SpigotMC.