Better Combat Mod Wiki

Better Combat Mod Wiki & Guide

wiki.9minecraft.net/better-combat-mod/

Better Combat Mod is a mod that incorporates combat animations and interactions from Minecraft Dungeons, another game by Mojang that is much more focused on combat. Minecraft has very few combat animations, unlike Minecraft Dungeons, which is heavily focused on that.

Guides

Step-by-step, in-game.

How to Disable or Tone Down Better Combat AnimationsWhen You Might Want This Some players prefer vanilla swing animations, use resource packs that conflict with the…How to Get Accurate Hits Without Pixel HuntingThe Problem Better Combat Solves In vanilla Minecraft, you must place your crosshair precisely on an enemy's hitbox…How to Hit Multiple Enemies With One SwingWhy Multi-Hit Works Better Combat calculates weapon swings using an oriented bounding box (OBB) combined with a…How to Perform Weapon Combos in Better CombatUnderstanding Combo Chains Better Combat replaces Minecraft's single-swing attack with multi-hit combo chains. Each…

Configuration

Every setting in the mod config file, with what it changes.

Option	What it does
`isAttackInsteadOfMineWhenEnemiesCloseEnabled`Attack instead of mining	Attack instead of mining upon left click, when enemies are close enough to strike
`isDebugOBBEnabled`Debug hitbox	Show weapon hitbox when entity hitboxes are displayed
`legAnimationThreshold`Disable leg animations	EXPERIMENTAL: Disable leg animations while running over this speed
`firstPersonAnimations`First-person player animations	Attack player animations to be shown. Only recommended to change if custom camera mods in use.
`hudHighlightColor`Highlight color	Color applied to HUD elements if needed.
`isHighlightCrosshairEnabled`Highlight crosshair	Highlights the crosshair if enemies are close enough to strike. WARNING! Enabling this might reduce frame rate significantly.
`isHoldToAttackEnabled`Hold to attack	Automatically attack while holding the attack button
`isTooltipAttackRangeReformat`Item tooltip: reformat vanilla range	Format Entity Interaction Range to Attack Range
`isTooltipAttackRangeEnabled`Item tooltip: show attack range	Show attack range attribute on weapon tooltips
`mineWithWeaponBlacklist`Mine with weapon blacklist	Weapons with an ID that matches this regex will never be used to harvest blocks
`mineWithWeaponWhitelist`Mine with weapon whitelist	Weapons with an ID that matches this regex can always mine blocks, even when 'Mine with weapons' is disabled
`isMiningWithWeaponsEnabled`Mine with weapons	Allow mining with weapons
`isShowingArmsInFirstPerson`Show arms in first person	Render arms for attack animations played in first person view
`isShowingOtherHandFirstPerson`Show inactive hand in first person	Render hand you are not attacking with in first person view
`isSweepingParticleEnabled`Show sweeping	Enable showing sword sweeping particle effects
`isShowingWeaponTrails`Show weapon swing trails	Render weapon trail particles for attacks in all perspectives
`isSwingThruGrassSmart`Smart swing through grass	Only swing through grass if there are enemies in attack range
`isSmoothAnimationTransitionEnabled`Smooth animation transitions	Attack animations smoothly transition at the cost of accuracy
`isSwingThruGrassEnabled`Swing through grass	Attack instead of mining zero hardness blocks with weapons
`swingThruGrassBlacklist`Swing thru grass blacklist	Weapons with an ID that matches this regex will never swing thru grass
`weaponSwingSoundVolume`Weapon swing sound volume %	Change volume of weapon swing sounds

Frequently asked questions

How do I start using Better Combat after installing it?

Just hold any weapon and attack — the mod replaces vanilla swings automatically, so there's nothing to enable. If your weapon still looks like a plain vanilla swing, another mod or resource pack is overriding the animations.

How do weapon combos work in Better Combat?

Each weapon has a sequence of attacks, and each hit in the sequence can have different reach, damage, angle, and animation. Keep attacking without long pauses to advance through the combo, and stop attacking for a moment to reset back to the first hit.

Why do my attacks sometimes hit multiple enemies and sometimes not?

Better Combat uses an accurate swing hitbox (OBB+SAT) instead of a single point, so a wide arc can catch several mobs at once. Whether you hit multiple enemies depends on your weapon's swing angle and how tightly the mobs are grouped in front of you.

Can I change how a weapon swings or what its combo looks like?

Yes — weapon attributes and animations are data-driven, so you can edit or add presets through datapacks and resource packs. This lets you change reach, damage per combo step, swing angle, and the animation used.

See all 19 Better Combat questions ›

Other wikis you may find useful.