\n<\/p>\n
# True Combat Manager<\/p>\n
Professional combat tracking with interactive GUIs, persistent statistics, dual grace period protection, and modern Minecraft server optimization.<\/p>\n
\n
\n
\n
\n<\/p>\n
—<\/p>\n
## Overview<\/p>\n
True Combat Manager is a feature-rich combat management system designed for competitive Minecraft PvP servers. It focuses on accurate combat detection, preventing PvP abuse, providing clear player feedback, interactive statistics GUIs, and persistent data tracking.<\/p>\n
—<\/p>\n
## \u2728 What’s New in v1.2.1<\/p>\n
### Dual Grace Period System<\/p>\n
The disconnect protection system has been completely overhauled.<\/p>\n
– **Bad-internet grace period** \u2014 longer, more lenient window for players who lost connection unexpectedly. Detected automatically from the quit reason.
\n– **Intentional grace period** \u2014 shorter window for players who pressed Disconnect or closed the game.
\n– Each type has its own `grace-seconds`, messages, and can be enabled\/disabled independently.<\/p>\n
### Repeat-Logout Abuse Prevention<\/p>\n
– Tracks each player’s disconnect history in a rolling time window.
\n– If a player disconnects too many times within the window, they are killed immediately on the next logout \u2014 no grace period.
\n– Fully configurable: `max-count`, `window-seconds`, messages.<\/p>\n
### Bypass-Totem Config<\/p>\n
– `bypass-totem: true` (default) \u2014 punishment kills bypass the Totem of Undying.
\n– `bypass-totem: false` \u2014 a held totem can proc and save the player.<\/p>\n
### Per-Player Theme Persistence<\/p>\n
– Theme selections saved to the database and restored across sessions.
\n– `\/combat toggle-style` works both in and out of combat.<\/p>\n
### Sound Profile Hot-Reload<\/p>\n
– `\/combat reload` now correctly updates sound profiles without a restart.<\/p>\n
### Bug Fixes<\/p>\n
– Fixed inventory duplication (armor dropped twice due to `getContents()` including armor slots)
\n– Fixed double bossbar on reconnect
\n– Fixed player not killed after grace period (config loaded before ConfigManager was ready)
\n– Fixed concurrent update race in player data
\n– Fixed `plugin.getConfig()` stale after reload<\/p>\n
—<\/p>\n
## Core Features<\/p>\n
### Combat System<\/p>\n
– Real-time combat detection
\n– Dual grace period disconnect protection (bad-internet vs intentional)
\n– Repeat-logout abuse prevention with kill-on-login
\n– Lag compensation using server TPS
\n– Thread-safe combat architecture<\/p>\n
### Interactive GUI System<\/p>\n
– **Player Stats GUI** \u2014 overall record, damage stats, combat stats
\n– **Weapon Stats GUI** \u2014 per-weapon breakdown (swords, axes, ranged)
\n– **Server Overview GUI** \u2014 admin panel with network-wide statistics
\n– Fully configurable via `gui.yml`
\n– Back buttons and seamless navigation<\/p>\n
### Database System<\/p>\n
– SQLite (default, no setup required)
\n– MySQL for larger networks
\n– Persistent player statistics and theme preferences
\n– Automatic database migration<\/p>\n
### Smart Restrictions<\/p>\n
– Ender pearl cooldown control
\n– Trident usage restrictions
\n– Elytra combat limitations
\n– Golden apple cooldown system
\n– Teleport command blocking
\n– Safezone protection support<\/p>\n
### Visual Interface<\/p>\n
– 6 built-in themes with per-player persistence
\n– BossBar combat indicators
\n– ActionBar status display
\n– 6 sound profiles with hot-reload
\n– HEX color customization<\/p>\n
### Protection Systems<\/p>\n
– Newbie protection for unarmored players
\n– Timed immunity system with admin commands
\n– WorldGuard safe zone integration
\n– Configurable bypass permissions<\/p>\n
—<\/p>\n
## Disconnect Protection Flow<\/p>\n
**Grace period expires, player still offline:**
\n1. Inventory dropped at disconnect location immediately
\n2. Win\/loss recorded, opponent notified and rewarded
\n3. `pendingPunishments` entry stored \u2014 player killed on next login<\/p>\n
**Player rejoins with pending punishment:**
\n1. Live inventory cleared
\n2. Player killed (totem bypass configurable)
\n3. Opponent receives reminder message<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
“`
\n\/combat status – View your combat status
\n\/combat stats – Open your combat statistics GUI
\n\/combat summary – View latest fight summary
\n\/combat toggle-style – Change visual theme (works anytime)
\n“`<\/p>\n
### Admin Commands<\/p>\n
“` —<\/p>\n ## Configuration Example<\/p>\n “`yaml visual: database: logging: All settings reload instantly with `\/combat reload`.<\/p>\n —<\/p>\n ## PlaceholderAPI Support<\/p>\n “` —<\/p>\n ## Installation<\/p>\n 1. Download the plugin JAR **No additional setup required** \u2014 SQLite works out of the box.<\/p>\n —<\/p>\n ## Requirements<\/p>\n Minecraft **1.18+** \u00b7 Java **17+** (21 recommended) \u00b7 Paper or Spigot<\/p>\n **Optional:** PlaceholderAPI \u00b7 WorldGuard \u00b7 ProtocolLib<\/p>\n —<\/p>\n ## Support<\/p>\n https:\/\/github.com\/muzlik-gm\/True-Combat-Manager\/issues<\/p>\n —<\/p>\n \n \u00a9 2026 muzlik \u00b7 Made for the Minecraft PvP community<\/p>\n","protected":false},"excerpt":{"rendered":" A powerful and optimized PvP combat system featuring advanced tracking, cooldown control, combat log<\/p>\n","protected":false},"featured_media":160162,"template":"","meta":{"_minecraft_slug":"true-combat-manager","_minecraft_project_id":"7U1lExKL","_minecraft_author":"muzlikgamer","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":157,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"true-combat-manager.zip","_minecraft_size_bytes":12933751,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T12:37:27.908591Z","_minecraft_date_created":"2026-03-12T08:37:36.241474Z","_minecraft_date_modified":"2026-05-16T04:31:23.152402Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/true-combat-manager","_minecraft_icon_attachment_id":160162,"_minecraft_imported_at":"2026-06-09T14:45:45+00:00","_minecraft_import_hash":"ed1091deb71f41199c0a2ad49acd593d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,866,90,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-160161","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-minigame","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/combat reload – Reload configuration
\n\/combat inspect
\n\/combat summary
\n\/combatadmin stats – Open server statistics GUI
\n\/combat clear
\n\/combat protection
\n\/combat debug – Toggle debug mode
\n\/combat logging
\n“`<\/p>\n
\ncombat:
\n duration: 10
\n disconnect-protection:
\n enabled: true
\n bad-internet:
\n grace-seconds: 30
\n intentional:
\n grace-seconds: 10
\n repeat-logout:
\n enabled: true
\n max-count: 2
\n window-seconds: 240
\n punishment:
\n drop-inventory: true
\n bypass-totem: true<\/p>\n
\n themes:
\n default-theme: “clean”
\n sounds:
\n profile: “default”<\/p>\n
\n type: “sqlite”<\/p>\n
\n console-enabled: false
\n“`<\/p>\n
\n%pvpcombat_in_combat%
\n%pvpcombat_time_left%
\n%pvpcombat_opponent%
\n%pvpcombat_wins%
\n%pvpcombat_losses%
\n%pvpcombat_kd_ratio%
\n%pvpcombat_win_rate%
\n%pvpcombat_total_damage_dealt%
\n%pvpcombat_total_damage_received%
\n“`<\/p>\n
\n2. Place it inside the `plugins` folder
\n3. Restart the server
\n4. Configure settings if needed
\n5. Run `\/combat reload`<\/p>\n<\/p>\n