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
- When a player hits another player, both enter combat status
- A configurable timer starts (default: 10 seconds)
- Visual effects display on both players
- Any hit during combat extends the timer for both participants
- When the timer expires, players exit combat
- 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
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
