Better Combat Kick

Better Combat Kick

Kick your enemies, break down doors and shatter glass. 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 and hits the closest target. 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.

Glass breaking

• Glass, stained glass, tinted glass and glass panes can be shattered with your feet: it takes 2 kicks by default, and you can change that number in the configuration.
• Glass from other mods is recognized too, as long as its name clearly says glass or pane.
• The broken block drops nothing, just like glass broken by hand, and a kick never hurts your leg.
• Kicks must follow each other quickly: stop for 5 seconds and the glass forgets your progress. A kick that doesn't break the glass yet still makes it ring.
• Glass doors follow the door rules above, not these ones.
• Glass won't break where you couldn't break a block by hand: in adventure mode, inside the protected spawn area, or where another mod's protection or claim system forbids it.
• Optionally, you can allow glass to be broken in adventure mode too (off by default). Spawn protection and other mods' protections still apply.
• You can turn the whole feature off in the configuration.

Spiked Point enchantment

A boots enchantment with three levels that adds extra damage to every kick, whichever kick type lands. The bonus grows with the level: +1.0 at level I, +2.0 at level II and +3.0 at level III by default. You can get it at the enchanting table and from villagers.

Boots enchantments

Boots can also carry these enchantments, at any level, and they apply to your kicks the way they would on a weapon:

• Knockback: your kicks push targets back further.
• Fire Aspect: your kicks set targets on fire, for longer with each level.
• Looting: mobs killed by your kicks drop more loot.

They can be combined with Spiked Point and the usual boots enchantments, for example Spiked Point II, Knockback I and Looting III on the same pair of boots.

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, door kicking and glass breaking 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 per level of 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. Also used for glass. 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

Glass

Setting	Description	Default
glassBreakingEnabled	Master switch for breaking glass and glass panes with kicks.	true
glassBreakKicks	Number of kicks needed to break a glass block or a glass pane. Between 1 and 100.	2
glassBreakInAdventureMode	Lets players in adventure mode break glass with kicks. Spawn protection and other mods' protections still apply.	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, whether a door opens and whether glass breaks, 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, door kicking and glass breaking 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.

Can I stop kicks from breaking glass? Yes. Set glassBreakingEnabled to false, or raise glassBreakKicks if you only want glass to be harder to break.

---

Mod created by Mozork. All rights reserved.