FoliPort – Folia-compatible TPA Plugin

To get the source code go to the github page to compile as it says in this description.

FoliPort is a Minecraft plugin built for Folia that allows players to send teleport requests.
This plugin is MIT Licensed.

---

Features

• /tpa <player> – Send a teleport request to another player.
• /tpaaccept – Accept a pending teleport request.
• /tpahere <player> – Request a player to teleport to you.
• /tpdeny <player> – Deny a teleport request.
• /tpacancel [player] – Cancel your outgoing request(s).
• /tpareload – Reload the plugin configuration.

Configuration Options

• teleport-delay – Seconds the player must stand still before teleporting. Default: 5.
• cancel-if-move – Cancel teleport if player moves. Default: true.
• cancel-if-target-moves – Cancel teleport if the target moves too far. Default: false.
• target-move-threshold – Max distance target can move during teleport. Default: 3.0.
• request-timeout – Seconds before a teleport request expires. Default: 30.
• Cooldowns for commands (tpa, tpahere, tpdeny).

Rules

• You cannot /tpa yourself.
• Moving during a teleport may cancel the request.

Building / Compiling

To compile FoliPort from source using Maven:

1. Make sure you have Java 21 and Maven installed.
2. Open a terminal in the root directory of the project (where pom.xml is located).
3. Run the following command:

mvn clean package

---

Configuration (config.yml)

#  FoliPort – Folia-compatible TPA plugin


# How long (seconds) the player must stand still before being teleported.
teleport-delay: 5

# Cancel the teleport if the teleporting player moves during the delay.
cancel-if-move: true

# Cancel the teleport if the destination player moves further than
# `target-move-threshold` blocks during the delay.
cancel-if-target-moves: false
target-move-threshold: 3.0

# How long (seconds) a TPA request stays valid before auto-expiring.
request-timeout: 30

# Cooldowns (seconds) per command.
# Players with foliport.bypass-cooldown skip these entirely.
cooldown:
  default: 5
  tpa: 5
  tpahere: 5
  tpdeny: 3


messages:
  # Permissions
  no-permission: "<red>You don't have permission to do that.</red>"

  # Cooldowns
  cooldown: "<yellow>You must wait <gold><time></gold> more second(s) before using this command.</yellow>"

  # General errors
  player-not-found: "<red>That player could not be found or is offline.</red>"
  cannot-self: "<red>You cannot send a teleport request to yourself.</red>"
  no-requests: "<red>You have no pending teleport requests.</red>"
  no-outgoing-requests: "<red>You have no outgoing teleport requests to cancel.</red>"
  multiple-requests: "<yellow>You have multiple requests. Use <gold>/tpaaccept <player></gold> or <gold>/tpdeny <player></gold> to specify one.</yellow>"
  no-request-from: "<red><player> has not sent you a teleport request.</red>"
  requester-offline: "<red>That player has gone offline; their request has been removed.</red>"

  # Command usage
  tpa-usage: "<yellow>Usage: <gold>/tpa <player></gold></yellow>"
  tpahere-usage: "<yellow>Usage: <gold>/tpahere <player></gold></yellow>"

  # Sending / receiving requests
  request-sent: "<green>Teleport request sent to <gold><player></gold>.</green>"
  incoming-tpa: "<green><gold><player></gold> wants to teleport to you. Use <gold>/tpaaccept</gold> or <gold>/tpdeny</gold>.</green>"
  incoming-tpahere: "<green><gold><player></gold> wants you to teleport to them. Use <gold>/tpaaccept</gold> or <gold>/tpdeny</gold>.</green>"

  # Expiry
  request-expired-requester: "<yellow>Your teleport request to <gold><target></gold> has expired.</yellow>"
  request-expired-target: "<yellow>The teleport request from <gold><requester></gold> has expired.</yellow>"

  # Accepting
  teleporting: "<green>Teleporting in <gold><seconds></gold> second(s). Don't move!</green>"
  teleport-accepted: "<green><gold><player></gold> has accepted your teleport request.</green>"
  teleport-success: "<green>Teleport successful!</green>"

  # Denying
  request-denied: "<red>Teleport request denied.</red>"
  request-denied-other: "<red><player> denied your teleport request.</red>"

  # Cancelling
  request-cancelled: "<yellow>Your teleport request has been cancelled.</yellow>"
  request-cancelled-target: "<yellow><player>'s teleport request to you was cancelled.</yellow>"

  # Teleport failures / cancellations
  teleport-failed: "<red>Teleport failed. Please try again.</red>"
  teleport-failed-offline: "<red>Teleport cancelled because a player went offline.</red>"
  teleport-cancelled-move: "<red>Teleport cancelled because you moved.</red>"
  teleport-cancelled-target-moved: "<red>Teleport cancelled because the destination player moved too far.</red>"
  teleport-cancelled-target-moved-notify: "<yellow><player>'s teleport to you was cancelled because you moved.</yellow>"

  # Reload
  reloaded: "<green>FoliPort configuration reloaded.</green>"