Combat Assistant Mod

PvP combat helper for Minecraft 1.21.11 (Fabric)

Features

Damage Dealt Tracker

Shows real-time damage dealt to enemies in the action bar. When you hit an entity, you'll see the exact amount of damage dealt displayed in red and yellow.

• Format: Damage: 5.2
• Tracks up to 30 blocks away
• Displays for 3 seconds after each hit

Damage Taken Indicator

Displays damage you receive when hit by enemies. Helps you understand how much damage you're taking in combat.

• Format: Damage Taken: 3.5
• Shows for 3 seconds after each hit
• Useful for assessing threat levels

Spear Combat Helper

Provides real-time feedback on spear lunge conditions. The mod shows you exactly what conditions are needed to perform a successful lunge attack.

Status messages:

• Charge spear... - Charge your attack fully
• Move forward to lunge! - You need forward momentum
• READY TO LUNGE (green) - Optimal conditions met

Lunge requirements:

• Fully charged attack (90% or higher)
• Moving forward
• Airborne or falling (jumping helps)
• Not in water

Weapon Swap Detection

Helps to visualize attribute swaps with a notification message. Shows what weapon you swapped from and to.

• Format: Swapped: Iron Sword to Diamond Sword
• Displays in green when swap is detected
• Confirms equipment changes instantly

Mace Range Helper

Displays the distance to the nearest entity when holding a mace. Helps you know if targets are within effective range.

• Format: Mace Range: 4.2 blocks
• Shows nearest entity distance
• Updates in real-time

Installation

1. Download modid-1.0.0.jar from the releases
2. Place it in your .minecraft/mods/ folder
3. Launch Minecraft with Fabric Loader installed
4. All features will be enabled automatically

Usage for Users

Download the mod. Open the folder where Minecraft is stored, and keep it in the mods folder.

Usage FOR DEVS

Testing the mod in single player:

gradlew runClient

Building the mod from source:

gradlew build

The compiled JAR will be created at: build/libs/modid-1.0.0.jar

PvP Combat Guide

Attribute Swapping

Use your hotbar number keys (1-9) to quickly swap between weapons. The mod will confirm each swap with a notification message showing which weapon you switched to.

• Press hotbar keys for instant swaps
• Watch for the swap confirmation message

Spear Lunge Technique

To land consistent spear lunges:

1. Jump first to guarantee you're airborne
2. Charge your attack by holding the attack button
3. Move forward while the attack is charging
4. Watch for the green "READY TO LUNGE" message
5. Release to execute the lunge

Reading Damage Numbers

Monitor both damage dealt and damage taken to adjust your strategy:

• High damage dealt: Your attacks are landing effectively
• High damage taken: You may need better armor or healing
• Track patterns to understand matchups

Mace Combat

When using a mace:

• Check the range indicator before attacking
• Mace has good reach compared to swords
• Most effective at close to medium range

Technical Details

Language: Java 21
Minecraft Version: 1.21.11
Fabric Loader: 0.18.2 or higher
Fabric API: 0.139.4 or higher

Main Components:

• CombatAssistant.java - Main tick handler and event listener
• SpearHelper.java - Spear lunge condition detection
• DamageDealtTracker.java - Entity damage tracking
• DamageIndicator.java - Damage display system
• SpearOptimizationMixin.java - Server-side optimization mixin

Compatibility

Works on multiplayer servers (no server mod required)
Works in single player worlds
Compatible with other Fabric mods
Errors might occur with lag optimization in multiplayer servers

Building from Source FOR DEVS

Requirements:

• Java 21 or higher
• Gradle

Build:

gradlew build

Run client:

gradlew runClient

The mod uses Fabric Loom for development and Mixin for bytecode modifications.

License

This mod is released under the CC0 license (public domain).