CombatRK

Overview

CombatRK is a standalone combat engine designed to give server owners precise control over Minecraft PvP mechanics.

Damage frequency and knockback frequency are handled independently. This makes it possible to create fast, high-CPS combat without applying full knockback on every accepted hit.

CombatRK does not require OldCombatMechanics.

Main Features

• Global attack speed per combat profile
• Configurable hit delay and hurt-resistance timing
• Custom horizontal and vertical knockback
• Independent knockback cooldown
• Combo-based knockback stages
• Airborne knockback control
• Velocity anti-accumulation
• Sprint and enchantment knockback control
• Critical-hit and sweep-attack control
• Fishing rod and projectile knockback
• Configurable item cooldowns
• World, region and player profile assignments
• Safe configuration reload
• Safe shutdown and restoration of modified player state
• Clean startup logs and optional personal debugging
• /combatrk doctor diagnostics
• Optional PlaceholderAPI and WorldGuard integrations

Included Combat Profiles

• VANILLA
• TRIGGER
• SEMISPAM
• SPAM
• COMBO
• INSTAKILL
• CUSTOM

Every profile is configurable. Profile names do not force hard-coded behavior; the values in config.yml determine the final combat mechanics.

Cross-Version Design


Modern functionality is isolated behind version adapters and capability detection. When an API does not exist on an older server, only the affected feature is disabled or changed to a safe fallback.

Adapter groups are provided for:

• Minecraft 1.8.8–1.15.x
• Minecraft 1.16.x
• Minecraft 1.17–1.21.x
• Minecraft 26.x

Important: The Java version required to run the server depends on the Minecraft/server version. Java 8-compatible plugin bytecode does not make modern Minecraft servers run on Java 8.

Folia is not currently supported or advertised.

Commands

Main alias: Permissions

Administrative permissions default to server operators. The bypass permission is disabled by default.

Optional Integrations

• PlaceholderAPI
• WorldGuard
• Floodgate and Geyser detection
• PvPManager conflict diagnostics
• OldCombatMechanics conflict diagnostics
• Vulcan detection

Optional dependencies are not required for startup. If one is missing or incompatible, CombatRK disables only the affected integration whenever possible.

PlaceholderAPI Placeholders

Installation

1. Download CombatRK-1.0.0.jar.
2. Place the JAR inside your server's plugins folder.
3. Restart the server.
4. Edit plugins/CombatRK/config.yml.
5. Run /combatrk reload.
6. Run /combatrk doctor and review detected capabilities or plugin conflicts.

Do not use Bukkit's global /reload command. Use /combatrk reload for configuration changes or restart the server when installing or removing the plugin.

Configuration Safety

CombatRK does not replace customized configuration files during updates.

New missing options are written to config.update.yml for manual review. Invalid reloads are rejected, and the previous validated configuration remains active.

The distributed configuration is extensively documented with comments explaining options, units, available modes and feature dependencies.

Performance

CombatRK is designed for high-CPS environments.

The combat event path does not perform file/database operations, global player scans or PlaceholderAPI expansions. Validated profiles and transient combat state are maintained in memory.