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!&rn&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%" ```