CombatLog999

Features

Core Combat System

- Player Exemption: Players are automatically tagged in combat when they engage in PvP with damage dealt or received - Player Exemption: Set how long the combat timer lasts before players can safely log out - Player Exemption: Optional delay before the combat timer begins, preventing accidental tagging during PvP - Player Exemption: Specify which worlds the combat timer is active in - Player Exemption: Admins can grant temporary exemptions to specific players

Visual Display Options

- Customizable Messages: Show a colored boss bar at the top of the screen with remaining time - Customizable Messages: Show the timer in the action bar - Customizable Messages: Boss bar colors change based on remaining time (high, medium, low) - Customizable Messages: Configure all messages displayed to players

Punishment System

- Configurable Punishments: Execute any command when a player combat logs (kill, economy penalties, etc.) - Configurable Punishments: Option to make players drop their inventory instead - Configurable Punishments: Define multiple commands with player placeholders

Command Blocking

- Configurable Block List: Prevent players from using specific commands while in combat - Configurable Block List: Easily add or remove commands to the blocked list

Logging & Monitoring

- Admin Tracking: All combat log violations are recorded to a file with timestamps and player information - Admin Tracking: Keep track of combat log incidents for review

Commands

Player Commands

- `/combatlog <player>` - Toggle combat exemption status for a specified player (Admin only) - `/combatlogreload` - Reload the plugin configuration without restarting the server (Admin only)

Permissions

- `combatlog999.admin` - Grants access to admin commands (default: OP)

Configuration

The `config.yml` file contains extensive options for customizing the plugin's behavior:

Timer Settings

- `combat-timer-duration`: How long in seconds before players can safely log out - `combat-start-delay`: Optional delay before the combat timer begins (prevents accidental tagging)

Visual Customization

- `timer-display-mode`: Choose between BOSS_BAR, ACTION_BAR, or NONE - `bossbar-color`: Color when timer is high - `bossbar-color-medium`: Color when timer is medium - `bossbar-color-low`: Color when timer is low - `low-time-threshold`: Threshold (in seconds) for low color - `medium-time-threshold`: Threshold (in seconds) for medium color

Punishment Settings

- `use-custom-punishments`: Enable custom command punishments - `punishments`: List of commands to execute when a player logs out during combat - `drop-inventory-on-combat-log`: Legacy inventory drop punishment (when custom punishments disabled)

World Settings

- `permitted-worlds`: List of worlds where combat logging is enforced (empty for all worlds)

Command Blocking

- `blocked-commands`: Commands that cannot be used while in combat