WorldGuard Integration

CombatLogger respects WorldGuard's pvp region flag when respect-pvp-flag: true. In PvP-disabled regions the combat tag is suppressed — players inside the region never enter combat, even if they are struck.

How It Works

Region PVP Flag	Behavior
`pvp=allow`	Players ARE tagged on PvP hit (normal)
`pvp=deny`	Players are NOT tagged (safe zones)
No WorldGuard	All PvP tags normally

If WorldGuard is not installed, this integration is silently skipped — CombatLogger does not crash or warn.

Setup

1. Create a Safe Zone

# Select the region with WorldEdit
//wand    # left-click corner 1, right-click corner 2

# Create the region
/rg define spawn_safe

# Deny PVP in it
/rg flag spawn_safe pvp deny

2. Enable Flag Respect in config.yml

worldguard:
  respect-pvp-flag: true

3. Reload

/combatlog reload

Common Use Cases

Spawn protection: Tag disabled at spawn so players can run to safety
Market areas: PvP-free zones for trading
Arenas: Inside arenas, use pvp=allow to ensure tagging still works even if the global setting is deny

PlaceholderAPI

Placeholder	Returns	Example
`%combatlogger_in_combat%`	`true` or `false`	`true`
`%combatlogger_time_left%`	Seconds of tag remaining	`8`

Home | Configuration | Commands & Permissions