ModsJava
OneWayTPA
A simple and lightweight teleport request plugin for your server. Free Minecraft Java mod for 1.20, 1.20.6, 1.21.
⬇ Download on SpigotOneWayTPA
One-way teleport requests for Paper and Folia — cooldowns, warmup, auto-accept, ignore lists, post-teleport invulnerability, and a public API. Sensible defaults out of the box, deeply configurable when you need it.
Features
Compatibility
Quick Start
Commands
Permissions
Fine-grained per-command and per-subcommand permissions are also exposed — see the README for the full table.
Recent versions
Support
One-way teleport requests for Paper and Folia — cooldowns, warmup, auto-accept, ignore lists, post-teleport invulnerability, and a public API. Sensible defaults out of the box, deeply configurable when you need it.
Features
- /tpa and /tpahere with clickable Accept / Deny / Cancel prompts.
- Per-permission cooldown groups — VIP, member, default tiers with ordered resolution.
- Configurable warmup with optional movement-cancel and post-teleport invulnerability.
- Two-flag /tpacancel — sender retracts pending requests and/or anyone aborts the in-flight warmup, independently.
- Auto-accept (/tpauto globally or per-player) — optionally extending to /tpahere.
- Ignore lists (/tpaignore globally or per-player).
- Post-teleport invulnerability — protect players from ambush damage for X seconds after teleport.
- Admin meta-command /onewaytpa with reload, version, cancel, info subcommands — works from the console.
- Runtime command aliases loaded from config.yml — no JAR rebuild needed.
- Public API with 7 custom events for downstream plugin integration.
- Folia-compatible out of the box (GlobalRegionScheduler + teleportAsync).
- English by default, but every user-facing message lives in lang.yml for easy translation.
Compatibility
| Server | Paper or Folia |
| Minecraft | 1.21.x |
| Java | 21+ |
| API | paper-api:1.21.11-R0.1-SNAPSHOT |
Quick Start
- Drop the JAR into your plugins/ folder.
- Start the server. Defaults are sensible — most servers can stop here.
- Edit plugins/OneWayTPA/config.yml to tune cooldowns, warmup, or any of the 10+ behaviour flags.
- /onewaytpa reload (player) or onewaytpa reload (console) to apply changes without restarting.
Commands
| Command | What it does |
| /tpa <player> | Request to teleport to a player |
| /tpahere <player> | Request to bring a player to you |
| /tpaccept [player] | Accept a pending request (most recent if no arg) |
| /tpadeny [player] | Deny a pending request |
| /tpacancel | Retract own pending request, or cancel a warmup |
| /tpauto [player] | Toggle global or per-player auto-accept |
| /tpaignore [player] | Toggle global or per-player ignore |
| /tpareload | Reload config and language |
| /onewaytpa <subcommand> | Admin meta-command (console-friendly) |
Permissions
- onewaytpa.use — bundle of all player commands (default true)
- onewaytpa.* — full access including admin (default op)
- onewaytpa.admin — /onewaytpa subcommands (default op)
- onewaytpa.cooldown.<group> — assign players to cooldown tiers
Fine-grained per-command and per-subcommand permissions are also exposed — see the README for the full table.
Recent versions
- 2.4 — post-teleport invulnerability config.
- 2.3 — /tpaccept / /tpadeny no-args shortcut + clickable [CANCEL] button on the warmup notification.
- 2.2 — cancel teleport on player movement; cleaner OSS defaults.
- 2.1 — cooldown reset toggles, /tpauto merge with /tpaauto, optional auto-accept for /tpahere.
- 2.0 — fully translated to English, MIT-licensed, full public API, console-friendly admin command.
Support
- Discord (support server): https://discord.gg/2Wb6BgGY9F
- GitHub (issues, PRs, source): https://github.com/lucas-santoro/OneWayTPA
- License: MIT — free for commercial use, modification, and redistribution.
OneWayTPA is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1. Downloaded 11 times (via Spigot). Download it and open it directly in the game.