Better Combat Lock-On

A Forge 1.20.1 client-side lock-on system built for Better Combat.

This mod adds action-game style target lock with smooth camera tracking, dynamic shoulder offset, omnidirectional movement while locked, and an on-screen target indicator.

Features

• Lock onto nearby entities and switch targets left/right.
• Smooth camera yaw/pitch tracking toward locked targets.
• Dynamic shoulder camera offset with configurable FOV behavior.
• Souls-like movement: directional strafing converted to smooth facing movement.
• Procedural HUD indicator with optional health ring.
• Client config for targeting, movement, camera, and UI behavior.

Default Controls

• Toggle lock-on: V
• Switch target left: Z
• Switch target right: C

You can rebind these in Minecraft keybind settings under Better Combat Lock-On.

Requirements

• Minecraft 1.20.1
• Forge 47.x
• Better Combat (required at runtime)

Build

From the project root:

gradlew.bat build

Built mod jar will be in:

build/libs/bettercombatlockon-1.0.0.jar

Run In Dev

gradlew.bat runClient

Config

Client config file:

config/bettercombatlockon-client.toml

Config categories include:

• targeting
• camera
• movement
• ui

Project Layout

• src/main/java/com/bettercombatlockon - mod source code
• src/main/resources/META-INF/mods.toml - Forge metadata and dependencies
• src/main/resources/bettercombatlockon.mixins.json - Mixin config
• src/main/resources/META-INF/accesstransformer.cfg - camera method access

License

GPL-3.0-only. See LICENSE.