SimpleTPA

A Paper/Folia and Bukkit/Spigot plugin for /tpa-style teleport requests, with cooldowns, an opt-out toggle, clickable accept/deny chat buttons, and optional teleport warmups.

Modrinth: simpletpaplugin

Features

• /tpa <player> to request a teleport, with support for multiple simultaneous incoming/outgoing requests
• /tpaccept / /tpdeny / /tpacancel, with a player argument to disambiguate when you have several pending requests
• /tpatoggle to opt out of receiving requests
• /tpa help and /tpa version (update checking against Modrinth)
• /tpreload to reload config.yml without a restart
• Per-player cooldowns and an optional stand-still teleport warmup
• Messages support legacy § codes and MiniMessage tags in any mix
• Optional PlaceholderAPI/LuckPerms prefix formatting in front of player names, with graceful fallback if not installed
• Full Folia support in the Paper build (regional schedulers, async teleports)
• Built-in Modrinth update checker with console and in-game (op) notifications

See config.yml for all settings, sounds, and messages, and plugin.yml for the full permission list.

Project structure

This is a Maven multi-module build. simpletpa-common holds all shared logic behind small platform interfaces (Messenger, SoundPlayer, TeleportService, DelayedTaskScheduler, AsyncTaskScheduler); each platform module provides its own implementation of those interfaces.

simpletpa-common/    # Shared business logic — commands, config, request handling (not distributed on its own)
simpletpa-paper/     # Paper/Folia implementation (regional schedulers, async teleports)
simpletpa-bukkit/    # Bukkit/Spigot implementation (shades & relocates Adventure)

Only simpletpa-paper and simpletpa-bukkit produce a distributable jar; simpletpa-common is a build-time dependency of both.

Building from source

Requirements:

• JDK 21+
• Maven 3.9+

mvn clean package

This produces two standalone jars:

• simpletpa-paper/target/SimpleTPA-Paper-<version>.jar — for Paper and Folia servers
• simpletpa-bukkit/target/SimpleTPA-Bukkit-<version>.jar — for Bukkit/Spigot servers

Install whichever matches your server software into plugins/; don't run both at once. Both jars shade com.google.code.gson:gson; the Bukkit jar additionally shades and relocates the Adventure libraries. paper-api / spigot-api stay provided and are supplied by the server at runtime.

Contributing

Issues and pull requests are welcome. Please keep changes to the module pom.xml files (API versioning) and the update checker minimal and well-explained, since both are easy to break in ways that only show up at runtime.

By submitting a contribution, you agree it may be incorporated into SimpleTPA under the terms in LICENSE (see the "Contributions" clause) - contributing does not grant redistribution rights to you or anyone else.

License

All rights reserved - see LICENSE. You're free to download, modify, and run the Software (original or modified) on your own server(s), including commercially. If you modify it, you must keep the LICENSE and NOTICE files alongside your copy with their notices intact. What's not permitted is redistributing the Software or any derivative of it - e.g. re-uploading it (modified or not) to Modrinth, Hangar, SpigotMC, CurseForge, or anywhere else - without prior written consent from the copyright holder. The only official distribution channel is Modrinth.