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