MasterCombatPro - The Ultimate Combat v2.7

➲ COMBAT TAGGER (PVP)

• Tag players who are fighting each other
• Display combat progress in ACTION bar or BOSS-bar
• Execute commands when combat starts/ends
• Whitelist/blacklist commands that can be executed during combat
• WorldGuard region integration for PvP zones
• Make combat-tagged players glow (with optional color matching)
• Supports all damage types: melee, arrows, tridents, potions, crystals
• Untag on death or enemy death (configurable)
• Lightning strike on kill
• Customizable combat duration
• Toggle combat system on/off
• Per-world combat toggle support
• Hex color support for all messages

➲ ENTITY LINKING SYSTEM

• Link indirect damage to players to prevent exploits
• Link pets damage to owner
• Link projectiles (arrows, tridents) to shooter
• Link fishing rod damage to fisher
• Link TNT explosions to placer
• Link End Crystal explosions to placer
• Link Respawn Anchor explosions to user
• Link Bed explosions to user
• Prevent combat bypasses through indirect damage

➲ PROJECTILE MANAGEMENT

• Blacklist/whitelist specific projectiles from triggering combat
• Configurable ignored projectiles (eggs, snowballs, etc.)
• Separate modes for different projectile types

➲ COMBAT RESTRICTIONS

• Prevent sleeping during combat
• Prevent armor changes during combat
• Prevent invisibility potion usage during combat
• Grace period system to prevent spam attempts
• Intelligent cooldown management

➲ ITEM RESTRICTION SYSTEM

• Block specific items during combat (chorus fruit, golden apples, etc.)
• Material-based blocking system
• Customizable blocked item list
• ActionBar/Chat message support
• Per-world item restriction overrides

➲ ENDER PEARL CONTROL

• Limit ender pearl throw distance during combat
• Complete blocking option
• Refresh combat timer on pearl land (optional)
• Cooldown system with time format support (10s, 5m, 1h, 1d)
• In-combat-only cooldown option
• Per-world pearl restrictions

➲ TRIDENT CONTROL

• Block trident usage during combat
• Refresh combat timer on trident land (optional)
• Per-world trident bans
• Cooldown system
• In-combat-only restrictions

➲ ELYTRA CONTROL

• Disable elytra usage during combat
• Automatically stop gliding when combat starts
• Customizable messages and notification types

➲ NEWBIE PROTECTION

• Protect new players from PvP for configurable time
• Optional mob damage protection
• Boss bar and action bar display options
• Protection timer with customizable format
• Early disable command (configurable command name)
• Block specific items while protected (crystals, anchors)
• Automatic protection expiration
• Protection status command
• Confirm-to-disable system to prevent accidents
• Interval reminders for remaining protection time
• Prevent protected players from attacking others
• Prevent attacks on protected players

➲ SAFEZONE / WORLDGUARD INTEGRATION

• Prevent combat-tagged players from entering safe regions
• Visual barrier system using customizable blocks
• Configurable barrier height and detection radius
• Push-back force to prevent entry
• Permission-based bypass system
• Op bypass toggle
• Region-based PvP control

➲ CUSTOM KNOCKBACK SYSTEM

• Replace vanilla knockback with custom values
• Packet-based or event-based knockback options
• Adaptive knockback calculation based on:

- Critical hits (1.5x multiplier)
- Sprint status (1.2x multiplier)
- Damage dealt (up to 2.0x)
- Victim absorption/resistance

• Configurable base force multiplier
• Per-player knockback cooldown (prevents spam)
• Clamped output (0.1-3.0 range)

➲ LOOT PROTECTION SYSTEM

• Protect loot from theft after PvP kills
• 4 protection modes:

1. Killer: Only killer and assistants can pickup
2. Victim: Only victim can pickup their own loot
3. Killer & Victim: Both killer and victim can pickup
4. Untagged: Only non-combat players can pickup

• Smart mode selection based on killer health status
• Adaptive duration based on kill circumstances
• Assistant tracking system
• Per-world mode overrides
• Configurable protection duration

➲ ANTI-KILL FARM SYSTEM

• Prevent kill farming and stat abuse
• Maximum kills per victim limit
• Suspicion scoring system with multiple factors:

- IP address matching (alt account detection)
- Proximity detection (<2 blocks)
- Suspicious damage patterns

• Automatic blocking when threshold reached
• Configurable cooldown before reset
• Command execution on farm detection (kick/ban)
• Configurable suspicion threshold (default 75%)

➲ KILL STREAK SYSTEM

• Track consecutive kills
• Momentum-based multiplier system:

- +0.1 momentum per kill within 10 seconds
- -0.05 momentum per kill within 10-30 seconds
- Reset after 30 seconds of inactivity

• Configurable streak reset time
• Reward commands at kill milestones
• Supports title, give, broadcast commands
• Placeholder support in reward commands

➲ CRYSTAL PVP SUPPORT

• Full End Crystal explosion tracking
• Link crystal damage to placer
• Prevent newbie-protected players from using crystals
• High-performance crystal manager with:

- O(1) lookups via concurrent hash tables
- Automatic expired entry cleanup
- NMS integration for accuracy

➲ PACKET-BASED COMBAT DETECTION

• Advanced packet interception system
• Direct attack verification before tagging
• Damage confirmation system to prevent false tags
• Health-before/after tracking
• Pending attack queue with lock-free ring buffer
• Automatic retry injection with timeout
• ViaVersion/ViaBackwards packet position tracking
• Channel pipeline integration
• Graceful connection handling

➲ COMMAND SYSTEM

• /combat - Main plugin command
• /combat help - Display command list
• /combat reload - Hot-reload configuration
• /combat toggle - Enable/disable combat system
• /combat visibility - Toggle combat tag visibility
• /protection - Check protection status
• /[configurable] - Remove newbie protection (requires confirm)

Command blocking during combat:

• Blacklist mode: Block listed commands
• Whitelist mode: Only allow listed commands
• Customizable blocked/allowed commands
• Sound effects on block

➲ CUSTOM DEATH MESSAGES

• Create custom death messages for PvP kills
• Prefix customization
• Placeholder support
• Display weapon names
• Prevents chat spam with death messages

➲ API FOR DEVELOPERS

• MasterCombatAPI for third-party integration
• MasterCombatLoadEvent for addon loading
• Access to all combat systems programmatically
• Player combat state queries
• Force set/remove combat tags
• Check if player can damage another
• Get combat opponent information

➲ INTEGRATIONS

• PlaceholderAPI support (mastercombat expansion)
• WorldGuard integration for region protection
• SuperVanish compatibility

➲ MESSAGES & CUSTOMIZATION

• Fully customizable messages
• Hex color code support (&#RRGGBB format)
• PlaceholderAPI support in all messages
• Multiple message types: Chat, ActionBar, Title, Both
• Sound effect support
• Configurable prefixes
• Time format support (10s, 5m, 1h, 1d)

➲ ADVANCED FEATURES

• Debug mode for troubleshooting
• Update notification system
• Update check intervals
• Confirmation timeout for updates
• Self-combat option (damage yourself)
• Entity manager for efficient entity tracking
• Glow manager with colored glow support (Paper 1.21+)
• Multi-threaded combat worker pool
• Task metrics and monitoring
• Per-player combat visibility toggle
• Combat format customization with placeholders

➲ CONFIGURATION

• Single config.yml file
• Hot-reload support without restart
• Extensive per-world overrides
• Boolean, String, List, Integer settings
• Time format support throughout
• Material-based item lists
• Comment-heavy configuration
• Validation and safe defaults