Combat Plugin

# English Combatblock – Version 1.0 Overview Combatblock is a lightweight and efficient Paper plugin designed to completely prevent combat logging and ensure fair PvP gameplay on your server. ## Core Features Prevents players from escaping fights by logging out Only triggers combat when real damage is dealt Ignores hits that deal no damage (e.g. spawn protection, cancelled hits) Combat timer system with automatic reset on each valid hit ### Combat System Default combat duration: 20 seconds (configurable) Timer counts down in real time Every successful hit resets the timer Combat ends automatically when the timer reaches 0 Combat instantly ends when a player dies Combat Logging Handling Logging out during combat results in immediate death No delayed punishment on rejoin Items drop normally as in a standard death Player rejoins without items ### Kill Credit System Tracks the last valid attacker Combat log kills are credited to the last opponent Clear and fair kill messages in chat Example: Player A was slain by Player B while combat logging Restrictions During Combat All commands are blocked during combat Prevents abuse such as teleporting or escaping via commands Ensures fights must be completed fairly ### Combat Display Actionbar-style display above the hotbar Shows remaining combat time Fully configurable message format Supports placeholders (e.g. {time}) Supports Minecraft color codes (§) ### Default design: Text: light gray Timer: light blue ### Configuration Adjustable combat duration Customizable combat message Full control over colors using standard Minecraft formatting Easy-to-edit config structure ### Technical Details Written in Kotlin Built for Paper #(Minecraft 1.21.11) Clean and maintainable structure Efficient event handling Designed for performance and stability ## Version Info Initial release (1.0-SNAPSHOT) Focus on core combat logging mechanics Stable base for future extensions # Deutsch # Combatblock – Version 1.0 Übersicht Combatblock ist ein leichtgewichtiges und effizientes Paper-Plugin, das Combat Logging vollständig verhindert und für faires PvP sorgt. ## Hauptfunktionen Verhindert das Ausloggen während eines Kampfes Combat startet nur bei echtem Schaden Ignoriert Treffer ohne Schaden (z. B. Spawn-Schutz) Combat-Timer mit automatischem Reset bei Treffern ### Combat-System Standarddauer: 20 Sekunden (konfigurierbar) Timer läuft in Echtzeit herunter Jeder gültige Treffer setzt den Timer zurück Combat endet automatisch bei 0 Combat endet sofort beim Tod ### Combat Logging Verhalten Ausloggen im Combat führt zum sofortigen Tod Keine verzögerte Bestrafung beim Rejoin Items droppen wie bei einem normalen Tod Spieler hat nach dem Join keine Items mehr ### Kill-Credit-System Letzter Angreifer wird gespeichert Combat-Log-Kills werden dem Gegner angerechnet Klare und faire Chat-Nachrichten Beispiel: Spieler A wurde von Spieler B beim Combat Logging getötet Einschränkungen im Combat Alle Commands sind deaktiviert Verhindert Escape durch Teleport oder Befehle Kämpfe müssen fair beendet werden ### Combat-Anzeige Anzeige über der Hotbar (Actionbar) Zeigt verbleibende Zeit Vollständig konfigurierbar Unterstützt Platzhalter (z. B. {time}) Unterstützt Minecraft-Farbcodes (§) # Standard: Text: hellgrau Zeit: hellblau # Konfiguration Combat-Zeit einstellbar Nachricht frei anpassbar Farben individuell definierbar Einfache Config-Struktur ### Technische Details Geschrieben in Kotlin Für Paper # (Minecraft 1.21.11) Saubere und wartbare Struktur Effiziente Event-Nutzung Performance-optimiert ## Versionsinfo Erste Version (1.0-SNAPSHOT) Fokus auf Kernfunktionalität Stabile Basis für Erweiterungen