## New Features
**PlaceholderAPI Integration**
CombatLog now supports PlaceholderAPI. Use these placeholders in any compatible plugin (scoreboards, TAB, HUDs, etc.):
- `%combatlog_in_combat%` — `true` / `false`
- `%combatlog_time_left%` — remaining combat seconds
- `%combatlog_opponent_name%` — name of the current opponent
- `%combatlog_opponent_health%` — opponent's current HP (`00.00` format)
PlaceholderAPI is optional — the plugin loads cleanly without it.
**Permission Bypass (`combatlog.bypass`)**
Players or groups with the `combatlog.bypass` permission are fully exempt from CombatLog:
- Will not be tagged into combat
- Are not subject to any in-combat restrictions (elytra, teleport, commands, etc.)
- Disconnecting while in combat produces no broadcast and no punishment
- Default: `op`
**Potion Effects on Combat Tag**
You can now configure potion effects that are automatically applied when a player enters combat and removed when combat ends. Effects are only applied if the player does not already have that effect active.
Configure in `config.yml` under `combat-log.tag-effects`:
```yaml
tag-effects:
- type: GLOWING
duration-seconds: 15
amplifier: 0
show-particles: false
```
Supports any valid Bukkit `PotionEffectType`. The list in the default config includes `GLOWING` as an example — remove or comment it out if you don't want any effects.
---
# Improvements
- `CombatManager` now tracks the current opponent per player, enabling opponent-related placeholders to work correctly
- `PotionEffectType` lookup updated to use `Registry.EFFECT` instead of the deprecated `getByName()` method (Paper 1.20.3+)
---
## Dependencies
- PlaceholderAPI: optional (`softdepend`)
- WorldGuard: optional (unchanged)
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }