CombatLog999

Features

Core Combat System

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

Visual Display Options

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

Punishment System

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

Command Blocking

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

Logging & Monitoring

• Detailed Combat Log: 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