Skip to content

About

Lightweight, zero-lag Anti-Combat Logging and PVP Tagging engine for Paper 1.21+

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

⚔️ TovekCombat

Platform Java License Version

Asynchronous Anti-Combat Logging and PVP Tagging engine for Paper 1.21+.

📦 Download Latest Release • 🌐 Developer Portfolio


Technical Architecture & Performance

TovekCombat is built specifically for modern Paper servers with strict execution guarantees:

  • Non-blocking Tag Lookups: All active combat tags are stored in an in-memory ConcurrentHashMap, ensuring $O(1)$ state lookups on hit events without blocking the main tick.
  • Asynchronous Expiration & Actionbar Tickers: Combat cooldowns and remaining second updates are handled via lightweight tick tasks avoiding main thread I/O stalls.
  • Defensive Combat-Log Handling: Handles edge-cases during player disconnects (survival inventory dropping, potion effects, and clean un-tagging to prevent memory leaks).
  • Sanitized Command Interception: Uses normalized root command validation to prevent namespace bypasses (e.g. minecraft:tp, /essentials:spawn).

Features

  • PVP Tagging Engine: Triggers on direct player attacks, projectile impacts, and lingering/splash potions.
  • Actionbar Countdown: Real-time remaining seconds ticker on actionbar (⚔ COMBAT | 14.5s).
  • Combat-Log Punishment: Eliminates players who disconnect while in combat, dropping items naturally and notifying the server.
  • Elytra Glide Prevention: Disables elytra opening while tagged to prevent combat evasion.
  • Configurable Command Blacklist: Blocks escape commands like /spawn, /home, /tp, /fly, etc.

Commands & Permissions

Command Permission Description
/combat Everyone View your current combat tag status and timer
/combat reload combat.admin Reload configuration settings
Bypass Tag combat.bypass Bypass command restrictions while in combat

Building from Source

git clone https://github.com/toprakeker/TovekCombat.git
cd TovekCombat
./gradlew build

Compiled jar will be located in build/libs/.


License

MIT License. Free for public server networks and modification.

About

Lightweight, zero-lag Anti-Combat Logging and PVP Tagging engine for Paper 1.21+

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages