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