Skip to main content

Integrations

TeleporterPro integrates with several popular server plugins. All integrations are soft-depends — the plugin starts and works fully without any of them.

Lands​

Lands is a land-claiming plugin. TeleporterPro can check whether the teleporting player is allowed to enter the destination land before the teleport executes.

Enabling​

integrations:
  lands:
    enabled: true
    warn-on-send: true
    block-on-execute: true

Auto-disabled when Lands is not installed. No additional setup is required.

Warn on Send​

When warn-on-send: true, both the sender and receiver are notified immediately after a TPA request is queued if the destination land's entry flag is off:

  • Sender (TPA): "Note: %target%'s land restricts entry. Your teleport may be blocked when accepted."
  • Receiver (TPA): "Note: Your land entry flag is off. %sender% may not be able to teleport to you."

The request is never blocked silently — both players always know a request was sent, regardless of land flags.

Block on Execute​

When block-on-execute: true, TeleporterPro checks Lands again at the moment the warmup finishes. If the entry is still denied:

  • The teleport is cancelled.
  • No economy charge is applied. Players are not billed for a teleport that Lands would have cancelled anyway.
  • Both players receive a clear cancellation message.

PlaceholderAPI​

TeleporterPro registers its placeholders automatically when PlaceholderAPI is installed.

PlaceholderReturns
%teleporterpro_tpa_enabled%Whether the player is accepting TPA requests
%teleporterpro_autoaccept%Auto-accept status for /tpa (On/Off)
%teleporterpro_autoaccept_here%Auto-accept status for /tpahere (On/Off)
%teleporterpro_pending_count%Number of pending incoming TPA requests
%teleporterpro_home_count%Number of homes saved
%teleporterpro_home_max%Home limit for this player

The On/Off labels for status placeholders are customizable in messages.yml:

placeholders:
  enabled: "<green>Enabled"
  disabled: "<red>Disabled"
  free: "<grey>Free"

LuckPerms​

When LuckPerms is installed and home.over-limit-checks.luckperms-events.enabled: true, TeleporterPro registers a LuckPerms permission-recalculation listener.

This means: when a timed rank expires or a group is removed, the home limit check fires immediately — no need for the player to relog or wait for the next periodic scan.

For servers using other permission managers (PermissionsEx, GroupManager, etc.), rely on the periodic check and on-login check instead.

Geyser / Floodgate​

When Floodgate is present, TeleporterPro detects it on startup and replaces Java inventory GUIs with native Bedrock forms for Bedrock players:

Request countForm type
1 pendingModalForm — Accept / Deny buttons
2+ pendingSimpleForm list — pick a request, then Accept / Deny

No configuration is needed. Java players always use the standard GUI.

Vault​

Vault enables the full economy system. See Economy for the complete documentation.

AdvancedTeleportAddon​

When AdvancedTeleportAddon is installed, TeleporterPro can automatically configure it to use TeleporterPro as the teleport provider:

advanced-teleport-addon:
  auto-configure: true
  config-key: "plugin"

Set auto-configure: false to manage the AdvancedTeleportAddon config manually.