[HR][/HR]
Overview

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.

[HR][/HR]
✨ What's New in v1.2.1

Dual Grace Period System

• Bad-internet grace period — longer, more lenient window for players who lost connection unexpectedly. Detected automatically from the quit reason.
• Intentional grace period — shorter window for players who pressed Disconnect or closed the game.
• Each type has its own grace-seconds, messages, and can be enabled/disabled independently.

Repeat-Logout Abuse Prevention

• Tracks each player's disconnect history in a rolling time window.
• If a player disconnects too many times within the window, they are killed immediately on the next logout — no grace period granted.
• Fully configurable: max-count, window-seconds, messages.

Bypass-Totem Config

• bypass-totem: true (default) — punishment kills bypass the Totem of Undying.
• bypass-totem: false — a held totem can proc and save the player.

Per-Player Theme Persistence

• Theme selections saved to the database and restored across sessions.
• /combat toggle-style works both in and out of combat.

Bug Fixes

• Fixed inventory duplication (armor dropped twice)
• Fixed double bossbar on reconnect
• Fixed player not killed after grace period
• Fixed concurrent update race in player data
• Fixed sound profiles not updating on reload

[HR][/HR]
Core Features

Combat System

• Real-time combat detection
• Dual grace period disconnect protection (bad-internet vs intentional)
• Repeat-logout abuse prevention with kill-on-login
• Lag compensation using server TPS
• Thread-safe combat architecture

Interactive GUI System

• Player Stats GUI — overall record, damage stats, combat stats
• Weapon Stats GUI — per-weapon breakdown (swords, axes, ranged)
• Server Overview GUI — admin panel with network-wide statistics
• Fully configurable via gui.yml
• Back buttons and seamless navigation

Database System

• SQLite (default, no setup required)
• MySQL for larger networks
• Persistent player statistics and theme preferences
• Automatic database migration

Smart Restrictions

• Ender pearl cooldown control
• Trident usage restrictions
• Elytra combat limitations
• Golden apple cooldown system
• Teleport command blocking during combat
• Safezone protection support

Visual Interface

• 6 built-in themes with per-player persistence
• BossBar combat indicators
• ActionBar status display
• 6 sound profiles with hot-reload
• HEX color customization

Protection Systems

• Newbie protection for unarmored players
• Timed immunity system with admin commands
• WorldGuard safe zone integration
• Configurable bypass permissions

[HR][/HR]
Disconnect Protection Flow

Grace period expires, player still offline:
1. Inventory dropped at disconnect location immediately
2. Win/loss recorded, opponent notified and rewarded
3. Player killed on next login (inventory cleared first)

Player rejoins with pending punishment:
1. Live inventory cleared
2. Player killed (totem bypass configurable)
3. Opponent receives reminder message

[HR][/HR]
Commands

Player Commands

Admin Commands

[HR][/HR]
Configuration Example

All settings reload instantly with /combat reload.

[HR][/HR]
PlaceholderAPI Support

[HR][/HR]
Installation

1. Download the plugin JAR
2. Place it inside the plugins folder
3. Restart the server
4. Configure settings if needed
5. Run /combat reload

No additional setup required — SQLite works out of the box.

[HR][/HR]
Requirements

Minecraft 1.18+ · Java 17+ (21 recommended) · Paper or Spigot

Optional: PlaceholderAPI · WorldGuard · ProtocolLib

[HR][/HR]
Support

https://github.com/muzlik-gm/True-Combat-Manager/issues

[HR][/HR]