TPA Warning

Simple /tpa and /tpahere safety check. When someone sends or receives a TPA request, both players automatically get warned if the other person has recent bans for custom defined reasons. Useful to warn players of a potential griefer or toxic player beforing accepting the request.

Warning Example (Configurable)

Why Use This

Most servers have /history commands, but nobody actually checks before accepting a teleport request. By the time you realize you've accepted a teleport request from a griefer, it's too late. This plugin does the checking automatically so players can make informed decisions before teleporting.

Perfect for survival servers where TPA is commonly used and griefing/theft problem.

Commands

• None

Permissions

• tpawarning.receive - Allows receiving the warning message.

How To Use

When a player gets banned using LiteBans, the ban is added to their history. When a player gets a tp request from the previously banned player (or tries to teleport to them), the player will receive a warning in chat.

Depending on what you put in the config, you can specify specific warnings you want to show. For example, I personally only care about griefing bans. I add the keyword "grief" to the list. Now, if a player's recent history has reason containing "grief", it will be shown to the player.

Requirements / Dependencies

• Essentials (required)
• LiteBans (required)

Config

# ================================
# TPA Warning Configuration File
# ================================

# Time Window Settings
time-window:
  # How far back (in days) to check for a user's history
  # Default: 90 (3 months)
  check-days: 90

# Ban Reason Keywords
# If a ban reason contains any of these keywords, a warning will be shown
# All comparisons are case-insensitive
ban-keywords:
  - "theft"
  - "grief"
  - "steal"
  - "stole"
  - "scam"
  - "rob"
  - "took"
  - "destroy"
  - "kill"

# Warning Message Settings
messages:
  # If true, show the actual ban reasons in the warning
  # If false, just show the count of bans
  # Default: true
  show-ban-reasons: true

  # Message sent when warning about another player's ban history
  # Placeholders: %player% (player name), %count% (number of bans)
  warning-header: "&c&l⚠ Warning!&r\n&cPlayer &e%player% &chas &l%count% &r&crecent ban(s) for:"

  # How each reason is formatted in the list
  # Placeholder: %reason% (the ban reason text)
  reason-format: "&4• &c%reason%"

  # Footer message with history command suggestion
  # Placeholder: %player% (player name)
  warning-footer: "\n&7Check full history: &a/history %player%"