What is True Combat Manager?
True Combat Manager is a comprehensive, high-performance PvP combat plugin featuring real-time combat tracking, newbie protection, smart restrictions, visual feedback, statistics tracking, and combat replay system. It tracks every aspect of player fights with detailed statistics, enforces intelligent restrictions to prevent unfair advantages, protects against combat logging, and presents everything through a beautiful, customizable interface.
Built for performance with async processing, intelligent lag compensation, and thread-safe architecture. Optimized for zero lag with intelligent logging system. Perfect for practice servers, factions, KitPvP, or any PvP-focused gameplay.
Why Choose This Plugin?
• Zero Lag: Optimized for high-performance servers with intelligent logging
• Newbie Protection: Automatically protects players without armor (XP threshold)
• Combat Logging Protection: Instant death + full inventory drop on logout
• Smart Restrictions: Block tridents, pearls, gapples, elytra, teleports, respawn anchors
• Safezone Protection: WorldGuard integration with visual glass barriers
• Comprehensive Statistics: Wins, losses, K/D, damage, accuracy, combat time
• Combat Replay System: Timeline recording and playback for admins
• Visual Feedback: 6 themes, BossBar, ActionBar, 5 sound profiles
• PlaceholderAPI: 15+ placeholders for scoreboards and tab lists
• Cross-Server Support: BungeeCord/Velocity compatibility
• Highly Configurable: 100+ configuration options
• Lag Compensation: Automatically adjusts timers during server lag
✨ Core Features
⚔️ Combat Management
• Real-time combat detection and tracking
• Configurable combat duration (default: 30s)
• Automatic timer reset on damage
• Lag compensation system (TPS monitoring)
• Combat logging protection (instant death on logout + full inventory drop)
• Automatic combat end on death
• Concurrent session management (unlimited fights)
• Thread-safe architecture
• Minimum damage threshold (0.5 hearts)
️ Newbie Protection System
• Protects players without armor from PvP
• XP level threshold (configurable, default: 3)
• Prevents damage dealing by newbies
• Prevents damage receiving by newbies
• Requires at least 1 armor piece (configurable)
• Bypass permission support
• Custom messages for attackers and defenders
• Detailed logging for debugging
Smart Restrictions (All Configurable)
• Tridents: Block throwing & riptide enchantment
• Ender Pearls: Block usage & safezone teleportation (10s cooldown, 20s in combat)
• Respawn Anchors: Block usage during combat
• Elytra: Block gliding & firework boosts
• End Crystals: Block placement/breaking
• Golden Apples: Configurable cooldowns (3s base, 4.5s combat)
• Enchanted Golden Apples: Separate cooldowns (4s base, 8s combat)
• Commands: Block teleport commands (/tp, /home, /spawn, /warp, /tpa, /back)
• Safezones: Prevent entry with visual glass barriers
• Creative Mode: Auto-switch to survival during combat
• Block Breaking/Placing: Optional restrictions
Visual System
• 6 Built-in Themes:
- Default - Classic red/yellow theme
- Minimal - Clean gray theme
- Intense - Bold red/orange theme
- Elegant - Sophisticated purple theme
- Neon - Bright cyan/pink theme
- Retro - Vintage green/yellow theme
• BossBar Timer: Dynamic countdown with smooth animations
• ActionBar Updates: Real-time opponent and timer information
• Color-coded Urgency: Green → yellow → red
• Live Theme Switching: Change visual style mid-combat with /combat toggle-style
• HEX Color Support: Full RGB color customization
• 5 Sound Profiles: default, subtle, intense, calm, electronic
• Event Sounds: Combat start/end, timer warning, timer reset, interference
Statistics & Tracking
• Wins/Losses tracking
• K/D ratio calculation
• Win rate percentage
• Damage dealt/received (precise to 0.1 hearts)
• Hits landed vs total hits
• Accuracy percentage
• Combat duration tracking
• Knockback exchanges
• Total combat time
• Last combat timestamp
• PlaceholderAPI integration (15+ placeholders)
Combat Replay System
• Timeline recording of all combat events
• Hybrid storage (memory + compressed files)
• Replay playback with admin commands
• Event filtering and search
• Configurable retention (default: 30 days)
• Memory-efficient with auto cleanup
• Player names in replay filenames
️ Safezone Protection
• WorldGuard integration
• Prevent entry during combat
• Visual glass barriers at boundaries
• Barriers persist until player moves away (>10 blocks)
• Barriers only render on AIR blocks (no griefing)
• Client-side rendering (no world modification)
• Configurable barrier material (GLASS, RED_STAINED_GLASS, etc.)
• Prevent attacking from/into safezones
• Sound and visual feedback
⚡ Performance Optimized
• Zero Lag: Optimized for high-performance servers
• Intelligent Logging: Disable for best performance (zero overhead)
• Async Operations: Combat logging, stats calculation off main thread
• Efficient Caching: Player data, restrictions, combat state
• Minimal Memory: Configurable thread pool (default: 4 threads)
• Auto Cleanup: Automatic cache cleanup
• No String Creation: When logging disabled
• Lag Compensation: Auto-adjusts timers when TPS drops below 18.0
Anti-Abuse Features
• Combat logging protection (instant death)
• Anti-interference system (third-party damage detection)
• Thread-safe operations
• Input validation on all commands
• Permission checks on sensitive operations
• Server switch prevention during combat
Cross-Server Support (Experimental)
• BungeeCord/Velocity compatibility
• Combat state synchronization
• Server switch prevention
• Network-wide broadcasts
• Configurable sync intervals
Commands
Player Commands:
/combat status - Check your current combat status and opponent
/combat summary - View your lifetime combat statistics
/combat toggle-style - Cycle through visual themes
Admin Commands:
/combat inspect <player> - Real-time combat data inspection
/combat summary <player> - View any player's statistics
/combat reload - Reload configuration
/combat debug - Toggle debug mode with verbosity levels
/combat logging <enabled|disabled> - Control console logging in real-time
/replay view <session-uuid> - View combat replay timeline
Permissions:
Player Permissions (default: true):
pvpcombat.command.status, pvpcombat.command.summary, pvpcombat.command.toggle-style
Admin Permissions (default: op):
pvpcombat.admin - All admin commands
pvpcombat.admin.inspect - Inspect players
pvpcombat.admin.debug - Debug mode
Bypass Permissions (default: op):
pvpcombat.bypass.combatlog - Bypass combat logging
pvpcombat.bypass.restrictions - Bypass all restrictions
pvpcombat.bypass.newbie - Bypass newbie protection
pvpcombat.bypass.server-switch - Bypass server switch prevention
⚙️ Configuration Highlights
Highly configurable with 100+ options:
Installation
1. Download TrueCombatManager-1.0.1.jar
2. Place in your server's plugins folder
3. Install ProtocolLib (recommended for barriers)
4. Install WorldGuard (recommended for safezones)
5. Restart your server
6. Edit plugins/TrueCombatManager/config.yml to customize
7. Use /combat reload to apply changes
Requirements:
Required:
• Minecraft 1.20.4+ (Paper/Spigot/Purpur)
• Java 21+ (Java 21.0.8 tested)
Recommended:
• ProtocolLib 5.0+ (for client-side barriers)
• WorldGuard 7.0+ (for safezone protection)
• PlaceholderAPI 2.11+ (for placeholders)
Optional Integrations:
• Citizens (NPC combat support)
• CombatLogX (integration support)
• MythicMobs (mob combat support)
• BungeeCord/Velocity (cross-server sync)
Works out of the box with default settings!
PlaceholderAPI Support
Full PlaceholderAPI integration for scoreboard, tab list, and chat plugins:
Combat Status:
%pvpcombat_in_combat% - true/false
%pvpcombat_time_left% - Remaining seconds
%pvpcombat_opponent% - Opponent name
Lifetime Statistics:
%pvpcombat_wins% - Total wins
%pvpcombat_losses% - Total losses
%pvpcombat_total_combats% - Total combats
%pvpcombat_kd_ratio% - K/D ratio (formatted)
%pvpcombat_win_rate% - Win rate percentage
%pvpcombat_total_damage_dealt% - Total damage dealt
%pvpcombat_total_damage_received% - Total damage received
%pvpcombat_damage_ratio% - Damage ratio (dealt/received)
%pvpcombat_total_combat_time% - Total time in combat
Session Statistics:
%pvpcombat_session_damage_dealt% - Damage in current fight
%pvpcombat_session_damage_received% - Damage received
%pvpcombat_session_hits_landed% - Hits landed
%pvpcombat_knockback_exchanges% - Knockback exchanges
Combat Statistics Example
Players can view their statistics with /combat summary:
Troubleshooting
Server Lag?
→ Disable console logging: /combat logging disabled
→ Check config: logging.console-enabled: false
→ This eliminates all string creation overhead
Newbie Protection Not Working?
→ Check player has NO armor equipped (all 4 slots empty)
→ Verify player XP level ≤ threshold (default: 3)
→ Check player doesn't have pvpcombat.bypass.newbie permission
→ Enable logging to see detailed checks: /combat logging enabled
Barriers Not Showing?
→ Install ProtocolLib 5.0+
→ Check config: restrictions.safezone.barrier.enabled: true
→ Verify WorldGuard regions are configured
→ Check console for ProtocolLib detection message
Tridents Still Working in Combat?
→ Check config: restrictions.trident.enabled: true
→ Verify player is actually in combat
→ Check console logs when enabled
Commands Not Blocked?
→ Check config: restrictions.teleport.enabled: true
→ Verify blocked-commands list is not empty
→ Check player doesn't have pvpcombat.bypass.restrictions permission
Placeholders Not Working?
→ Install PlaceholderAPI
→ Run /papi reload
→ Check /papi parse me %pvpcombat_in_combat%
Tested Versions
✅ Minecraft 1.21.10 - Fully Tested
✅ Minecraft 1.21.x - Fully Tested
✅ Minecraft 1.20.x - Compatible
✅ Minecraft 1.19.x - Compatible
⚠️ Minecraft 1.18.x - Basic Features
✅ Paper 1.20.4+ - Recommended
✅ Spigot 1.20.4+ - Supported
✅ Purpur 1.20.4+ - Supported
✅ Java 21.0.8 - Tested
✅ Java 21+ - Recommended
✅ Java 17+ - Minimum
Support
Need help? Contact me directly through SpigotMC conversation!
Reporting Bugs:
1. Check if issue already exists
2. Provide server version and plugin version
3. Include relevant config sections
4. Attach console errors (if any)
5. Describe steps to reproduce
Feature Requests:
All feature requests are welcome and considered!
⭐ Leave a Review
If you enjoy this plugin, please leave a 5-star review!
Your feedback helps improve the plugin and helps others discover it.
License
All Rights Reserved © 2025 muzlik
This is proprietary software. Unauthorized copying, distribution,
modification, or use is strictly prohibited.
Changelog - v1.0.1
INITIAL RELEASE:
• Complete PvP combat management system
• Real-time combat tracking with 30s timer
• Newbie protection system (XP level + armor check)
• Smart restrictions (tridents, ender pearls, respawn anchors, elytra, crystals, gapples)
• Visual system with 6 themes and BossBar/ActionBar
• Comprehensive statistics tracking (wins, losses, K/D, damage, accuracy)
• Combat replay system with timeline recording
• Safezone protection with WorldGuard integration
• Visual glass barriers (ProtocolLib) - client-side only
• PlaceholderAPI support (15+ placeholders)
• Performance optimized with async operations
• Intelligent logging system (zero lag when disabled)
• Combat logging protection (instant death + inventory drop)
• Cross-server support (BungeeCord/Velocity)
• Admin tools (inspect, debug, replay viewer)
• 100+ configuration options
License & Support
License: All Rights Reserved © 2025 muzlik
This is proprietary software. Modification or redistribution is prohibited.
Support:
• Contact via SpigotMC conversation
• Report bugs through resource discussion
• Feature requests welcome
Tested Versions:
✅ 1.21.x series (fully tested)
✅ 1.20.x series (compatible)
✅ 1.19.x series (compatible)
⚠️ 1.18.x series (basic features)