Better Combat Kick

By
Mozork

Adds a kick attack to Minecraft: normal, sprint and sprint-jump kicks, animated legs in first and third person, kickable doors and padlocks, a boots enchantment, and optional ParCool, TaCZ, LSO, SFT and SA Decor support.

Description

Better Combat Kick

Kick your enemies and break down doors. A server-authoritative kick attack with three kick types, alternating legs, and a leg animation that is visible in first person.

Why this mod ?

Better Combat adds weapons and attacks, but never a real kick. Better Combat Kick fills that gap with a single key: Kick. Press it and your character throws a real, animated kick that damages and knocks back whatever is in front of you.

Depending on how you are moving when you press the key, you get one of three different kicks, each with its own damage, knockback, speed and cooldown. The mod is designed as a companion to the Better Combat mod family: it reuses its swing sound, and Better Combat must be installed.

Every kick is validated by the server, so the mod behaves the same in singleplayer and multiplayer, and other players see your animation.

What the mod does

Three kicks, picked automatically

Kick	How to trigger it	Damage	Knockback	Cooldown
Normal kick	Standing still or walking, tap the Kick key (the kick goes out when you release it)	1.2	Light	1 second
Sprint kick	Sprint on the ground, then press the Kick key	1.45	Strong	1.5 seconds
Sprint-jump kick	Sprint, jump, and press the Kick key in the air	1.75	Very strong	2 seconds

These are the default values and can all be changed in the configuration. The kick reaches about 2 blocks in front of you. The Weakness effect is taken into account: the stronger the Weakness, the weaker your kick.

Alternating legs

Consecutive kicks alternate between your right and left leg, as long as you chain them within a short time window (2.5 seconds by default).
If you wait longer, you start again with your right leg.

Animations you can actually see

Other players, and you in third-person view, see a full body animation: the leg swings up while the arms and torso counter-balance.
In first person, you see your own leg come up from the bottom of the screen. It uses your real skin, your pants layer, and the leggings and boots you are wearing (including dyed leather).
Your hand and held item stay visible: they simply move down a little to make room for the leg.
Holding a TaCZ weapon? The kick only moves your legs, so it never disturbs the weapon-holding pose.

Door and padlock kicking

Wooden and simple doors open with a single kick.
Metal doors (iron, steel, copper, netherite, gold, and many more, detected automatically from their name) resist: they need several consecutive kicks in quick succession to give way. The stronger the kick, the fewer you need (by default: 3 normal kicks, 2 sprint kicks, or just 1 sprint-jump kick). Stop kicking for 5 seconds and the door forgets your progress.
Forcing a door costs you a little damage on each hit. Brute force has a price, but you can turn this off in the configuration.
With SA Decor, a forcing kick can also break a padlock.
Doors from other mods are handled automatically. You can fine-tune this with whitelists, a blacklist and keywords in the configuration.

Spiked Point enchantment

A single-level boots enchantment that adds extra damage to every kick, whichever kick type lands (+1.0 by default). You can get it at the enchanting table and from villagers.

Common-sense restrictions

By default, you cannot kick while riding something (horse, boat, minecart, modded vehicles), while climbing a ladder or vine, or during an active ParCool parkour action. Each restriction can be turned off in the configuration.

Key

The Kick key is C by default. You can change it in Options > Controls > Better Combat Kick.

Compatibility (optional)

Everything below is optional. If the other mod is not installed, the matching feature simply stays inactive.

Mod	What it adds
ParCool	Kicking is blocked during a parkour action (vault, wall climb, slide…). Plain Fast Run does not block the kick, so you can kick while running fast.
TaCZ (Timeless and Classics Zero)	When you hold a TaCZ weapon, the kick uses a legs-only animation.
Legendary Survival Overhaul	Kicking can consume thirst, and the damage you take from forcing a door can hit a random foot or leg through LSO's body-part injury system, instead of your normal health.
Stamina For Tweakers	Kicking can cost stamina, based on that mod's values.
SA Decor	A forcing kick can break a padlock on a door.

Each of these compatibilities has its own switch in the configuration.

Requirements

Requires Player Animator (it draws the kick animations)
Requires Better Combat
Install on both the client and the server

What's configurable

Everything can be adjusted from the in-game mod configuration screen, or in config/bettercombatkick-common.toml. Durations are in ticks (20 ticks = 1 second).

General

Setting	Description	Default
`modEnabled`	Master switch: disables every kick type and door kicking at once.	`true`
`legAlternationWindowTicks`	Time (in ticks) in which consecutive kicks alternate between the right and left leg. Must stay greater than the longest kick cooldown. Between 1 and 20000.	`50`
`spikedPointDamageBonus`	Extra damage from the "Spiked Point" enchantment, whichever kick lands. Between 0 and 1024.	`1.0`
`kickConsumesFood`	Kicking causes the same food exhaustion as a normal melee attack.	`true`

Doors

Setting	Description	Default
`doorKickingEnabled`	Master switch for door kicking.	`true`
`doorForceProgressResetTicks`	Time (in ticks) after which a door forgets the consecutive kicks it received. Between 1 and 20000.	`100`
`metalDoorKeywords`	Keywords in a door's name that automatically classify it as a metal door (iron, steel, copper, netherite, gold, bronze, tin, zinc, titanium, and more). Editable list.	`iron, steel, copper...`
`enableDoorOverrideLists`	Consults the whitelists and the blacklist before the automatic keyword detection.	`true`
`doorWhitelist1Overrides`	Doors always treated as simple (one-hit) doors. Registry ids or `modid:*`.	`empty`
`doorWhitelist2Overrides`	Doors always treated as metal doors. Registry ids or `modid:*`.	`doomsday_decoration:door_14`
`doorBlacklist`	Doors that can never be kicked open. Registry ids or `modid:*`.	`empty`
`respectExternalDoorProtections`	When on, other mods' lock or protection systems can also block a kicked-open door. Can stop doors from opening in large modpacks.	`false`

Compatibility

Setting	Description	Default
`enableLsoThirstCompat`	Kicking consumes thirst (Legendary Survival Overhaul).	`true`
`enableLsoBodyDamageCompat`	Damage taken from forcing a door lands on a foot or leg through LSO, without removing real hearts.	`true`
`enableSftStaminaCompat`	Kicking costs stamina (Stamina For Tweakers).	`true`
`enableSaDecorPadlockCompat`	A forcing kick can break an SA Decor padlock.	`true`

Normal kick

Setting	Description	Default
`normalKickEnabled`	Switch for the normal kick.	`true`
`normalKickDamage`	Damage dealt. Between 0 and 1024.	`1.2`
`normalKickKnockback`	Strength of the knockback. Between 0 and 10.	`0.35`
`normalKickCooldownTicks`	Delay (in ticks) before another kick can be thrown. Between 1 and 20000.	`20`
`normalKickCanForceDoors`	Can force a metal door or break an SA Decor padlock.	`true`
`normalKickDoorForceHits`	Consecutive kicks needed to force a metal door. Between 1 and 64.	`3`
`normalKickDoorForceDamageEnabled`	Forcing a door hurts you.	`true`
`normalKickDoorForceDamage`	Damage taken on each kick thrown at a door while forcing it. Between 0 and 6.	`1.0`
`sftFallbackNormalKickCost`	Stamina cost used if Stamina For Tweakers' own value can't be read. Between 0 and 1024.	`0.0`

Sprint kick

Setting	Description	Default
`sprintKickEnabled`	Switch for the sprint kick. When off, it does not fall back to a normal kick.	`true`
`sprintKickDamage`	Damage dealt. Between 0 and 1024.	`1.45`
`sprintKickKnockback`	Strength of the knockback. Between 0 and 10.	`0.7`
`sprintKickCooldownTicks`	Delay (in ticks) before another kick can be thrown. Between 1 and 20000.	`30`
`sprintKickCanForceDoors`	Can force a metal door or break an SA Decor padlock.	`true`
`sprintKickDoorForceHits`	Consecutive kicks needed to force a metal door. Between 1 and 64.	`2`
`sprintKickDoorForceDamageEnabled`	Forcing a door hurts you.	`true`
`sprintKickDoorForceDamage`	Damage taken on each kick thrown at a door while forcing it. Between 0 and 6.	`1.5`
`sftFallbackSprintKickCost`	Stamina cost used if Stamina For Tweakers' own value can't be read. Between 0 and 1024.	`2.0`

Sprint-jump kick

Setting	Description	Default
`sprintJumpKickEnabled`	Switch for the sprint-jump kick.	`true`
`sprintJumpKickDamage`	Damage dealt. Between 0 and 1024.	`1.75`
`sprintJumpKickKnockback`	Strength of the knockback. Between 0 and 10.	`1.1`
`sprintJumpKickCooldownTicks`	Delay (in ticks) before another kick can be thrown. Between 1 and 20000.	`40`
`sprintJumpKickCanForceDoors`	Can force a metal door or break an SA Decor padlock.	`true`
`sprintJumpKickDoorForceHits`	Consecutive kicks needed to force a metal door. Between 1 and 64.	`1`
`sprintJumpKickDoorForceDamageEnabled`	Forcing a door hurts you.	`true`
`sprintJumpKickDoorForceDamage`	Damage taken on each kick thrown at a door while forcing it. Between 0 and 6.	`2.0`
`sprintJumpDamageMultiplier`	Informational only: the actual damage comes from `sprintJumpKickDamage`. Between 1 and 10.	`1.25`
`sftFallbackSprintJumpKickCost`	Stamina cost used if Stamina For Tweakers' own value can't be read. Between 0 and 1024.	`4.0`

Kick eligibility

Setting	Description	Default
`blockKickWhenMounted`	Blocks kicking on a horse, boat, minecart or any modded vehicle.	`true`
`blockKickWhenClimbing`	Blocks kicking on a ladder, vine or any climbable block.	`true`
`blockKickWhenParkour`	Blocks kicking during a ParCool parkour action (Fast Run does not block).	`true`

Multiplayer

The server decides whether a kick is allowed, how much damage it deals and whether a door opens, so the kick can't be abused from the client.
Other players see your animation.

FAQ

Can I turn the mod off without removing it? Yes. The modEnabled setting disables every kick and door kicking at once. You can also disable each kick type separately.

Does the kick work on every door from other mods? Doors are recognized through Minecraft's standard door block. Metal doors are recognized by keywords in their name, and you can add your own exceptions in the configuration with the whitelists and the blacklist.

Can I kick while running with ParCool? Yes. Fast Run does not block the kick. Real parkour actions (vaulting, wall climbing…) do, unless you turn that restriction off.