SMPCombatLog

SMPCombatLog - Advanced PvP Combat Tracking System

SMPCombatLog is a comprehensive combat logging prevention system designed for Paper servers. It automatically tracks player-to-player combat, provides immersive visual feedback, and enforces customizable punishments for players who disconnect or die while engaged in battle.

Features

• Automatic Combat Detection: Instantly detects when players enter combat and tracks all participants
• Visual Feedback System:
  • Customizable boss bar showing remaining combat duration
  • Glowing effect on opponents with configurable colors
• Combat Logging Protection: Automatically punishes players who disconnect or die during active combat
• Flexible Punishments: Choose between killing or damaging combat loggers
• Permission-based Bypass: Grant specific players immunity from combat logging
• MiniMessage Support: Fully customizable messages with color codes and formatting
• Easy Commands: Simple admin commands to manage the system
• Public API: Integrate combat tracking into your own plugins

How It Works

1. When a player hits another player, both enter combat status
2. A configurable timer starts (default: 10 seconds)
3. Visual effects display on both players
4. Any hit during combat extends the timer for both participants
5. When the timer expires, players exit combat
6. If a player disconnects or dies while in combat, they receive automatic punishment

Commands

• /smpc state - View combat logging status
• /smpc state on - Enable combat logging system
• /smpc state off - Disable combat logging system
• /smpc reload - Reload configuration

Configuration

Customize every aspect of the system:

• Combat duration (in seconds)
• Boss bar appearance (enabled/disabled, title, color)
• Glow effects (enabled/disabled, color)
• Punishment type (kill or damage)
• Broadcast notifications
• All messages with full MiniMessage support

Permissions

Permission	Description
smpcombatlog.state	View combat logging status
smpcombatlog.state.enable	Enable combat logging
smpcombatlog.state.disable	Disable combat logging
smpcombatlog.reload	Reload configuration
smpcombatlog.bypass	Bypass combat logging entirely

API Integration

Developers can integrate SMPCombatLog into their plugins using the public API:

• Check if players are in combat
• Get opponent information
• Manage combat logging status
• Create custom bypass rules

Perfect For

• SMP (Survival Multiplayer) servers
• PvP-enabled servers
• Competitive server environments
• Anti-griefing protection
• Fair combat mechanics

Requirements

• Paper 1.21.x
• Java 21+

License

Non-Commercial License: Free for personal and community use. Cannot be resold or used for commercial purposes. For commercial licensing inquiries, contact the author.

Support

For bug reports, feature requests, and documentation, visit the GitHub Repository.

Author: M9MX