Better Combat Attributes

By
jcyyy_

Adds simple melee attributes to Better Combat

Better Combat Attributes

Forge mod for Minecraft 1.20.1 that adds attribute-driven tweaks for Better Combat.

Features

Supports Forge forge:entity_reach with Better Combat melee attacks.
Adds synced player attributes for Better Combat windup, movement, targeting, sweeping, and dual-wield tuning.
Works with /attribute, item AttributeModifiers, or any other source of vanilla attribute modifiers.

Attributes

All bcattributes:* entries below are registered by this mod on players. forge:entity_reach is still provided by Forge, but this mod makes Better Combat respect it.

Attribute	Default	Range	Effect
`bcattributes:upswing_multiplier`	`0.5`	`0.2` to `1.0`	Controls Better Combat upswing timing before the hit lands.
`bcattributes:movement_speed_while_attacking`	`0.5`	`0.0` to `1.0`	Scales player movement input while attacking.
`bcattributes:target_search_range_multiplier`	`2.0`	`0.0` to `1024.0`	Expands Better Combat's initial target search volume.
`bcattributes:dual_wielding_main_hand_damage_multiplier`	`1.0`	`0.0` to `1024.0`	Damage multiplier for main-hand hits during dual wielding.
`bcattributes:dual_wielding_off_hand_damage_multiplier`	`1.0`	`0.0` to `1024.0`	Damage multiplier for off-hand hits during dual wielding.
`bcattributes:dual_wielding_attack_speed_multiplier`	`1.2`	`0.0` to `1024.0`	Effective dual-wield attack speed multiplier.
`bcattributes:attack_interval_cap`	`2`	`0` to `1024`	Minimum cooldown tick cap used by Better Combat.
`bcattributes:reworked_sweeping_extra_target_count`	`4`	`1` to `1024`	Extra-target count used by Better Combat's reworked sweeping penalty logic.
`bcattributes:reworked_sweeping_maximum_damage_penalty`	`0.5`	`0.0` to `1.0`	Maximum total damage penalty for reworked sweeping extra targets.
`bcattributes:reworked_sweeping_enchant_restores`	`0.5`	`0.0` to `1.0`	Sweeping Edge restoration against the reworked sweeping penalty.
`bcattributes:max_sweep_targets`	`0`	`0` to `1024`	Caps extra sweep targets after Better Combat target selection. `0` leaves the target count unchanged.
`bcattributes:sweep_range_damage_falloff`	`0.0`	`0.0` to `1.0`	Applies linear sweep damage falloff by distance to each target hitbox.
`bcattributes:sweep_angle`	`0.0`	`-360.0` to `360.0`	Additive adjustment to a weapon's Better Combat sweep angle.
`forge:entity_reach`	Forge default	Forge-defined	Extends Better Combat melee range through Forge's reach attribute.

Notes

Item AttributeModifiers are additive on top of the defaults above. For example, an item modifier of 0 on bcattributes:attack_interval_cap leaves the effective value at the default 2, not 0.
bcattributes:sweep_angle is additive to the weapon's default Better Combat angle.
If the effective sweep angle is reduced to 0 or below, extra sweep targets are suppressed.
bcattributes:sweep_range_damage_falloff uses a 0.0 to 1.0 range, where 0.0 disables falloff.
bcattributes:target_search_range_multiplier is not raw reach. It expands the initial candidate search volume and stacks with forge:entity_reach.
For isolated testing, prefer /attribute @s ... base set ... so you are setting the final value directly instead of stacking on defaults.

Example

/attribute @s bcattributes:target_search_range_multiplier base set 4
/attribute @s bcattributes:sweep_angle base set 70
/attribute @s forge:entity_reach base set 6