⚡ What is KnockBack?

Replace Minecraft's default knockback with a precision-tuned physics engine that gives you total control over how hits feel. Perfect for competitive PvP, practice servers, kitPvP, and any gamemode where knockback matters.

Drop the JAR, load a profile, and your PvP is instantly transformed.

✦ Features

• ⚔ Full Knockback Control — Horizontal, vertical, distance multiplier, random variance
• Air Multipliers — Adjust KB when the victim is airborne (combo tuning)
• Sprint Multipliers — Adjust KB when the attacker is sprinting
• Vertical Cap — Prevent players from being launched into the sky
• ⏱ Hit Delay — Minimum ticks between KB on the same victim
• Sprint Cancel — Optionally stop attacker sprint after each hit
• Random Variance — Add unpredictability to every fight
• ⚙ 5-Tick Physics Engine — Custom friction and gravity simulation
• Combo Protection — Prevents rapid-fire KB abuse
• Profile System — 5 built-in presets + save/load your own
• World Scanner — Diagnose PvP issues (gamerules, attributes)
• Debug Mode — See every calculation in real time
• Tab Completion — Full autocomplete on all commands
• Lightweight — No dependencies, no NMS, pure Spigot API

Commands
Permission: knockback.admin (default: OP)

Parameters

Base Values

Parameter	Description	Default	Range
horizontal	Sideways knockback force	0.6	0.3 - 1.2
vertical	Upward knockback force	0.36	0.2 - 0.6
distance	Global multiplier (H + V)	1.0	0.5 - 2.0
random	Variance % (0 = consistent)	0	0 - 100

Air Multipliers (applied when victim is in the air)

Parameter	Description	Default
air_horizontal_multiplier	Horizontal KB in air (<1 = weaker, >1 = stronger)	0.83
air_vertical_multiplier	Vertical KB in air (<1 = falls faster, >1 = floaty)	0.94

Sprint Multipliers (applied when attacker is sprinting)

Parameter	Description	Default
sprint_horizontal_multiplier	Extra horizontal KB from sprint hits	1.5
sprint_vertical_multiplier	Extra vertical KB from sprint hits	1.0

Limits & Behavior

Parameter	Description	Default
vertical_limit	Max upward velocity cap	1.2
hit_delay	Min ticks between KB (20 = 1s)	10
stop_sprint	Cancel attacker sprint on hit	false

Built-in Profiles

Load any profile instantly with /kb profile load <name>

Profile	Style	H	V	Best For
competitive	Balanced, clean combos	0.7	0.36	Ranked / competitive PvP
hypixel	Strong first hit, weak air KB	0.8	0.32	Hypixel-like servers
mineman	Floaty, aerial combos	0.9	0.40	Combo-heavy gamemodes
dynamic	Random variance, unpredictable	0.75	0.34	Casual / fun servers
antiwtap	Reduces sprint abuse	0.7	0.38	Anti-exploit servers

Quick Start

1. Drop KnockBack.jar into your plugins/ folder
2. Restart or reload your server
3. Try a preset: /kb profile load hypixel
4. Fine-tune: /kb set horizontal 0.7
5. Save your config: /kb profile save myprofile
6. Done! Your PvP knockback is now fully customized.

config.yml

The config file is fully documented with comments explaining every parameter, recommended ranges, and examples. It is auto-generated on first run. All settings can also be changed in-game with /kb set.

❓ FAQ

Q: Does it work on Paper?
A: Yes! KnockBack uses pure Spigot API, so it works on both Spigot and Paper 1.20+.

Q: Does it use NMS or version-specific code?
A: No. Zero NMS, zero reflection, zero CraftBukkit. It will work on any future Minecraft version without updates.

Q: Can I use it alongside other PvP plugins?
A: Yes. KnockBack listens at HIGHEST priority and works alongside most PvP plugins. If another plugin cancels the hit, KnockBack will respect that.

Q: How do I reset to default settings?
A: Delete your config.yml and restart, or use /kb profile load competitive.

Q: What does the world scanner do?
A: /kb worldscan checks your world for PvP issues: difficulty, gamerules, and suspicious player attributes (KB resistance, speed modifiers).