Skip to main content

Configuration

All settings are in plugins/TeleporterPro/config.yml.

Apply changes without restarting:

/tpreload

Module Toggles​

modules:
  tpa: true
  home: true
  warp: true

Setting a module to false unregisters all of its commands entirely. The plugin starts cleanly with any combination of modules disabled.

TPA Settings​

tpa:
  request-duration: 60    # seconds until an unanswered request expires
  warmup: 3               # seconds the player must stand still before teleporting (0 = instant)
  cancel-on-move: true    # cancel the warmup if the player moves
  cooldown: 10            # seconds before the same player can send another request after a deny (0 = off)

Home Settings​

home:
  limits:
    default: 3      # applies to everyone (no permission needed)
    # vip: 10       # grant teleporterpro.homes.vip
    # admin: 50     # grant teleporterpro.homes.admin

  over-limit-behavior: delete   # "keep" or "delete" (see below)

  over-limit-checks:
    on-login: true              # check on every player join
    periodic:
      enabled: true
      interval-minutes: 5       # scan all online players every N minutes
    luckperms-events:
      enabled: true             # react instantly when LuckPerms recalculates permissions

  warmup: 3
  cancel-on-move: true

Over-limit Behavior​

ValueWhat happens when a player exceeds their limit
keepExcess homes are preserved and remain usable. The player cannot set new homes until they delete down to their limit. A warning message is shown.
deleteExcess homes are removed automatically (newest first). The player is notified which homes were deleted.

Warp Settings​

warp:
  warmup: 3
  cancel-on-move: false

  permissions:        # restrict specific warps to a permission node
    # spawn: teleporterpro.warps.vip
    # pvp:   teleporterpro.warps.pvp

Per-warp permissions can also be set in-game: /setwarp <name> [permission]. The config.yml entry takes priority over the in-game value.

Economy​

Requires Vault and a compatible economy plugin.

economy:
  enabled: false

  tpa:
    cost: 100.0
    dynamic-pricing:
      enabled: false
      tiers: []

  tpahere:
    cost: 100.0
    dynamic-pricing:
      enabled: false
      tiers: []

  home:
    cost: 50.0
    dynamic-pricing:
      enabled: false
      tiers: []

  warp:
    default-cost: 0.0         # per-warp overrides are always flat; this is the default
    dynamic-pricing:
      enabled: false
      tiers: []

Dynamic Pricing​

When dynamic-pricing.enabled: true, the player's balance is checked against the tiers in ascending order. The first tier whose max-balance the player is below wins. Players above all tier ceilings pay the flat cost.

economy:
  tpa:
    cost: 500.0                    # fallback for players richer than all tiers
    dynamic-pricing:
      enabled: true
      tiers:
        - max-balance: 100000      # balance < 100k  → 50
          cost: 50.0
        - max-balance: 1000000     # balance < 1M    → 200
          cost: 200.0
        - max-balance: 10000000    # balance < 10M   → 1000
          cost: 1000.0
        # players with 10M+        → flat 500.0

See Economy for the full anti-exploit details.

GUI​

gui:
  player-selector: true   # show player-picker GUI when /tpa or /tpahere is used with no arguments

Set to false to require a player name to be typed directly.

Command Overrides​

command-overrides:
  tpa: true
  tpahere: true
  tpaccept: true
  tpdeny: true
  home: true
  sethome: true
  delhome: true
  homes: true
  warp: true
  setwarp: true
  delwarp: true
  warps: true

When true, TeleporterPro forcefully claims that command name from any other plugin at startup (including Essentials). When false, the command is only available under the teleporterpro: namespace prefix.

Integrations​

Lands​

integrations:
  lands:
    enabled: true

    # Warn both players when a TPA request is likely to be blocked by a land claim.
    # The request is still queued — this is informational only.
    warn-on-send: true

    # Cancel the teleport (and skip the economy charge) at warmup completion
    # if Lands still denies entry.
    block-on-execute: true

Auto-disabled when Lands is not installed.

AdvancedTeleportAddon​

advanced-teleport-addon:
  auto-configure: true    # auto-set TeleporterPro as the provider on first run
  config-key: "plugin"

Debug​

debug: false

Set to true to enable verbose console logging. Useful when diagnosing unexpected behaviour.