OneWayTPA

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

1. Drop the JAR into your plugins/ folder.
2. Start the server. Defaults are sensible — most servers can stop here.
3. Edit plugins/OneWayTPA/config.yml to tune cooldowns, warmup, or any of the 10+ behaviour flags.
4. /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.